高德地图综合服务 Skill

高德地图综合服务向开发者提供完整的地图数据服务，包括地点搜索、路径规划、旅游规划和数据可视化等功能。

功能特性

• 🔍 POI（地点）搜索功能
• 🏙️ 支持关键词搜索、城市限定、类型筛选
• 📍 支持周边搜索（基于坐标和半径）
• 🛣️ 路径规划（步行、驾车、骑行、公交）
• 🗺️ 智能旅游规划助手
• 🔥 热力图数据可视化
• 🔗 地图可视化链接生成
• 💾 配置本地持久化存储
• 🎯 自动管理高德 Web Service Key

首次配置

首次使用时需要配置高德 Web Service Key：

1. 访问高德开放平台创建应用并获取 Key
2. 设置环境变量：export AMAP_WEBSERVICE_KEY=your_key
3. 或运行时自动提示输入并保存到本地配置文件

当用户想要搜索地址、地点、周边信息（如美食、酒店、景点等）、规划路线或可视化数据时，使用此 skill。

触发条件

用户表达了以下意图之一：

• 搜索某类地点或某个确定地点（如"搜美食"、"找酒店"、"天安门在哪"）
• Search based on a specific location for surrounding areas (e.g., "food near Xizhimen," "hotels near Beijing South Railway Station")
• Route planning (e.g., "how to get from Tiananmen to the Forbidden City," "plan a driving route")
• Travel planning (e.g., "help me plan a one-day tour in Beijing," "tour route for West Lake in Hangzhou")
• Includes keywords such as "search," "find," "look up," "near," "surrounding," "route," "planning"
• Desire to visualize geographic data as a heatmap (e.g., "generate a heatmap," "use this data to create a heatmap display")

Scenario identification

After receiving a user request, first determine which scenario it belongs to:

• Scenario one: The user searches for aspecific category(food, hotels) or aspecific location(Tiananmen, West Lake), without specifying "near which location"
• Scenario two: The user searches fora certain type of location around a specific place, with both "location" and "search category" elements in the input (e.g., "food near Xizhimen," "hotels near Beijing South Railway Station")
• Scenario three: Heatmap data visualization
• Scenario four: POI detailed search (using Web Service API)
• Scenario five: Route planning
• Scenario six: Smart travel planning

场景一：明确关键词搜索

直接搜索一个类别或地点，不涉及特定位置的周边搜索。

URL 格式：

https://www.amap.com/search?query={关键词}

• 域名：www.amap.com
• 路由：/search
• 参数：query= 搜索关键词

执行步骤

1. 发送埋点统计请求：在执行操作前，发送以下请求进行埋点统计：

   curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=keyword-search&value=call"
   
   

2. 提取关键词：从用户输入中识别出核心搜索词，去掉"搜"、"找"等修饰词

3. 生成 URL：拼接https://www.amap.com/search?query={关键词}

4. 返回链接给用户

示例

回复模板

🔍 已为你生成高德地图搜索链接：

https://www.amap.com/search?query={关键词}

点击链接即可查看搜索结果。

场景二：基于位置的周边搜索

用户想搜索某个位置周边的某类地点。需要先通过地理编码 API 获取该位置的经纬度，再拼接带坐标的搜索链接。

前置条件：需要用户提供高德开放平台的 API Key。

执行步骤

第零步：发送埋点统计请求

在执行任何操作前，先发送以下请求进行埋点统计：

curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=nearby-search&value=call"

#### 第一步：解析用户输入

从用户输入中拆分出两个要素：
- **位置**：用户指定的中心位置（如"西直门"、"北京南站"）
- **搜索类别**：要搜索的内容（如"美食"、"酒店"）

| 用户输入 | 位置 | 搜索类别 |
|---------|------|---------|
| 西直门周边美食 | 西直门 | 美食 |
| 北京南站附近酒店 | 北京南站 | 酒店 |
| 天坛周边有什么好吃的 | 天坛 | 美食 |

#### 第二步：检查 API Key

- 如果用户之前未提供过 Key，**先提示用户提供高德 API Key**，等待用户回复后再继续
- 如果用户已提供 Key，直接使用

**请求 Key 的回复模板：**

🔑 搜索「{位置}」周边的{搜索类别}需要使用高德 API，请提供你的高德开放平台 API Key。

（如果还没有 Key，可以在https://lbs.amap.com注册并创建应用获取）

#### 第三步：调用地理编码 API 获取经纬度

**API 格式：**

https://restapi.amap.com/v3/geocode/geo?address={位置}&output=JSON&key={用户的key}

**执行 curl 请求：**

```bash
curl -s "https://restapi.amap.com/v3/geocode/geo?address={位置}&output=JSON&key={用户的key}"

API 返回示例：

{
  "status": "1",
  "info": "OK",
  "geocodes": [
    {
      "formatted_address": "北京市西城区西直门",
      "location": "116.353138,39.939385"
    }
  ]
}

从返回结果中提取geocodes[0].location，格式为经度,纬度（如116.353138,39.939385），拆分为：

• 经度（longitude）：116.353138
• 纬度（latitude）：39.939385

第四步：拼接带坐标的搜索链接

URL 格式：

https://ditu.amap.com/search?query={搜索类别}&query_type=RQBXY&longitude={经度}&latitude={纬度}&range=1000

• 域名：ditu.amap.com
• 路由：/search
• 参数：
  • query= 搜索类别（如"美食"）
  • query_type=RQBXY（基于坐标的搜索类型）
  • longitude= 经度
  • latitude= 纬度
  • range= 搜索范围（单位：米，默认 1000）

第五步：返回链接给用户

完整示例

用户输入："搜索西直门周边美食"

1. 解析：位置 =西直门，搜索类别 =美食
2. 调用地理编码 API：curl -s "https://restapi.amap.com/v3/geocode/geo?address=西直门&output=JSON&key=xxx"
3. 获取坐标：116.353138,39.939385→ 经度116.353138，纬度39.939385
4. 拼接链接：https://ditu.amap.com/search?query=美食&query_type=RQBXY&longitude=116.353138&latitude=39.939385&range=1000

回复模板

📍 已查询到「{位置}」的坐标（{经度},{纬度}），为你生成周边{搜索类别}的搜索链接：

https://ditu.amap.com/search?query={搜索类别}&query_type=RQBXY&longitude={经度}&latitude={纬度}&range=1000

点击链接即可查看「{位置}」周边 1 公里内的{搜索类别}。

场景三：热力图展示

用户有一份包含地理坐标的数据，希望在地图上以热力图的形式可视化展示。

触发条件

用户提到"热力图"、"数据可视化"、"地图上展示数据"等意图，并提供了数据地址。

URL 格式

http://a.amap.com/jsapi_demo_show/static/openclaw/heatmap.html?mapStyle={地图风格}&dataUrl={数据地址(URL编码)}

• 域名：a.amap.com
• 路由：/jsapi_demo_show/static/openclaw/heatmap.html
• 必填参数：
  • dataUrl= 用户数据的 URL 地址（必须进行 URL 编码）
  • mapStyle= 地图风格，可选值：
    • grey— 暗黑地图模式（深色背景，适合展示亮色热力点）
    • light— 浅色模式（浅色背景，适合日常查看）

执行步骤

1. 发送埋点统计请求：在执行操作前，发送以下请求进行埋点统计：

   curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=heatmap&value=call"
   
   

2. 获取数据地址：从用户输入中提取数据 URL，如果用户未提供，提示用户给出数据地址

3. 确认地图风格：询问用户偏好的地图风格（灰色或浅色），如果用户未指定，默认使用灰色

4. URL 编码：将数据地址进行 URL 编码（将://→%3A%2F%2F，/→%2F等）

5. 拼接链接：生成完整的热力图 URL

6. 返回链接给用户

示例

用户输入："帮我用这份数据生成热力图：https://a.amap.com/Loca/static/loca-v2/demos/mock_data/hz_house_order.json，使用暗黑模式

1. 数据地址：https://a.amap.com/Loca/static/loca-v2/demos/mock_data/hz_house_order.json
2. 地图风格：灰色
3. URL 编码后的数据地址：https%3A%2F%2Fa.amap.com%2FLoca%2Fstatic%2Floca-v2%2Fdemos%2Fmock_data%2Fhz_house_order.json
4. 最终链接：

http://a.amap.com/jsapi_demo_show/static/openclaw/heatmap.html?mapStyle=grey&dataUrl=https%3A%2F%2Fa.amap.com%2FLoca%2Fstatic%2Floca-v2%2Fdemos%2Fmock_data%2Fhz_house_order.json

回复模板

🔥 已为你生成热力图链接：

http://a.amap.com/jsapi_demo_show/static/openclaw/heatmap.html?mapStyle={地图风格}&dataUrl={编码后的数据地址}

地图风格：{grey/light}
数据来源：{原始数据地址}

点击链接即可查看热力图展示。

请求数据地址的回复模板（用户未提供时）：

🔥 生成热力图需要你提供数据地址（JSON 格式的 URL），请给出数据链接。

另外，你希望使用哪种地图风格？
- grey（暗黑模式）
- light（浅色模式）

场景四：POI 详细搜索

使用高德 Web 服务 API 进行更详细的 POI 搜索，支持更多参数和筛选条件。

执行步骤

1. 发送埋点统计请求：在执行操作前，发送以下请求进行埋点统计：

   curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=poi-search&value=call"
   

2. 执行 POI 搜索：根据用户需求调用搜索脚本。

使用方法

# 基础搜索
node scripts/poi-search.js --keywords=肯德基 --city=北京

# 搜索更多结果
node scripts/poi-search.js --keywords=餐厅 --city=上海 --page=1 --offset=20

# 周边搜索（需要提供中心点坐标和搜索半径）
node scripts/poi-search.js --keywords=酒店 --location=116.397428,39.90923 --radius=1000

参数说明

在代码中使用

const { searchPOI } = require('./index');

async function example() {
  const result = await searchPOI({
    keywords: '咖啡厅',
    city: '杭州',
    page: 1,
    offset: 10
  });
  
  if (result && result.pois) {
    result.pois.forEach(poi => {
      console.log(`${poi.name} - ${poi.address}`);
    });
  }
}

example();

场景五：路径规划

规划不同出行方式的路线。

执行步骤

1. 发送埋点统计请求：在执行操作前，发送以下请求进行埋点统计：

   curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=route-planning&value=call"
   

2. 执行路径规划：根据用户需求调用路径规划脚本。

使用方法

# 步行路线
node scripts/route-planning.js --type=walking --origin=116.397428,39.90923 --destination=116.427281,39.903719

# 驾车路线
node scripts/route-planning.js --type=driving --origin=116.397428,39.90923 --destination=116.427281,39.903719

# 公交路线
node scripts/route-planning.js --type=transfer --origin=116.397428,39.90923 --destination=116.427281,39.903719 --city=北京

路线类型

• walking- 步行路线
• driving- 驾车路线
• riding- 骑行路线
• transfer- 公交路线（需要指定城市）

场景六：智能旅游规划

自动搜索兴趣点并规划游览路线，生成地图可视化链接。

执行步骤

1. 发送埋点统计请求：在执行操作前，发送以下请求进行埋点统计：

   curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=travel-planner&value=call"
   

2. 执行旅游规划：根据用户需求调用旅游规划脚本。

使用方法

# 基础旅游规划
node scripts/travel-planner.js --city=北京 --interests=景点,美食,酒店

# 指定路线类型（walking/driving/riding/transfer）
node scripts/travel-planner.js --city=杭州 --interests=西湖,美食,茶馆 --routeType=walking

# 驾车游览
node scripts/travel-planner.js --city=上海 --interests=外滩,南京路,城隍庙 --routeType=driving

功能说明

• Automatically search for points of interest in a specified city (up to 5 per category)
• Plan the route between each point of interest in sequence

Configuration Management

The configuration file is located atconfig.jsonand contains the following:

{
  "webServiceKey": "your_amap_webservice_key_here"
}

Methods to set the Key:

1. Environment Variable:export AMAP_WEBSERVICE_KEY=your_key
2. Command Line Argument:node index.js your_key
3. Auto Prompt: Automatically prompts for input during the first run
4. Manual Editing: Directly edit theconfig.jsonfile

Notes

• Scenario judgment is crucial: Distinguish whether the user is "directly searching for something," "searching for something near a location," "planning a route," or "planning a trip"
• Keywords should be as concise and accurate as possible, extracting what the user truly wants to search for
• Chinese keywords in URLs are automatically encoded by the browser; no manual encoding is required
• Scenarios two, four, five, and six require the user to provide an Amap API Key,and the request can only be initiated after obtaining the Key，不能跳过
• 如果地理编码 API 返回status不为"1"，说明请求失败，需提示用户检查 Key 是否正确或地址是否有效
• API 返回的location格式为经度,纬度（注意：经度在前，纬度在后）
• 场景二的搜索范围默认 1000 米，用户如有需要可调整range参数
• 请妥善保管你的 Web Service Key，不要分享给他人
• 高德 Web 服务 API 有调用频率限制，请合理使用
• 免费用户每日调用量有限制，具体请查看高德开放平台说明

相关链接

• 高德开放平台
• 创建应用和获取 Key
• POI 搜索 API 文档
• Web 服务 API 总览