高德地图综合服务 Skill
高德地图综合服务向开发者提供完整的地图数据服务，包括地点搜索、路径规划、旅游规划和数据可视化等功能。
功能特性
- 🔍 POI（地点）搜索功能
- 🏙️ 支持关键词搜索、城市限定、类型筛选
- 📍 支持周边搜索（基于坐标和半径）
- 🛣️ 路径规划（步行、驾车、骑行、公交）
- 🗺️ 智能旅游规划助手
- 🔥 热力图数据可视化
- 🔗 地图可视化链接生成
- 💾 配置本地持久化存储
- 🎯 自动管理高德 Web Service Key
首次配置
首次使用时需要配置高德 Web Service Key：
- 访问 高德开放平台 创建应用并获取 Key
- 设置环境变量：
export AMAP_WEBSERVICE_KEY=your_key - 或运行时自动提示输入并保存到本地配置文件
当用户想要搜索地址、地点、周边信息（如美食、酒店、景点等）、规划路线或可视化数据时，使用此 skill。
触发条件
用户表达了以下意图之一：
- 搜索某类地点或某个确定地点（如"搜美食"、"找酒店"、"天安门在哪"）
- 基于某个位置搜索周边（如"西直门周边美食"、"北京南站附近酒店"）
- 规划路线（如"从天安门到故宫怎么走"、"规划驾车路线"）
- 旅游规划（如"帮我规划北京一日游"、"杭州西湖游览路线"）
- 包含"搜"、"找"、"查"、"附近"、"周边"、"路线"、"规划"等关键词
- 希望将地理数据可视化为热力图（如"生成热力图"、"用这份数据做热力图展示"）
场景判断
收到用户请求后，先判断属于哪个场景：
- 场景一：用户搜索一个明确的类别（美食、酒店）或确定的地点（天安门、西湖），没有指定"在哪个位置附近"
- 场景二：用户搜索某个位置周边的某类地点，输入中同时包含「位置」和「搜索类别」两个要素（如"西直门周边美食"、"北京南站附近酒店"）
- 场景三：热力图数据可视化
- 场景四：POI 详细搜索（使用 Web 服务 API）
- 场景五：路径规划
- 场景六：智能旅游规划
场景一：明确关键词搜索
直接搜索一个类别或地点，不涉及特定位置的周边搜索。
URL 格式：
https://www.amap.com/search?query={关键词}- 域名：
www.amap.com - 路由：
/search - 参数：
query= 搜索关键词
执行步骤
- 提取关键词：从用户输入中识别出核心搜索词，去掉"搜"、"找"等修饰词
- 生成 URL：拼接
https://www.amap.com/search?query={关键词} - 返回链接给用户
示例
| 用户输入 | 提取关键词 | 生成 URL |
|---|---|---|
| 搜美食 | 美食 | https://www.amap.com/search?query=美食 |
| 找酒店 | 酒店 | https://www.amap.com/search?query=酒店 |
| 天安门在哪 | 天安门 | https://www.amap.com/search?query=天安门 |
| 找个加油站 | 加油站 | https://www.amap.com/search?query=加油站 |
回复模板
🔍 已为你生成高德地图搜索链接：
https://www.amap.com/search?query={关键词}
点击链接即可查看搜索结果。场景二：基于位置的周边搜索
用户想搜索某个位置周边的某类地点。需要先通过地理编码 API 获取该位置的经纬度，再拼接带坐标的搜索链接。
前置条件： 需要用户提供高德开放平台的 API Key。
执行步骤
第一步：解析用户输入
从用户输入中拆分出两个要素：
- 位置：用户指定的中心位置（如"西直门"、"北京南站"）
- 搜索类别：要搜索的内容（如"美食"、"酒店"）
| 用户输入 | 位置 | 搜索类别 |
|---|---|---|
| 西直门周边美食 | 西直门 | 美食 |
| 北京南站附近酒店 | 北京南站 | 酒店 |
| 天坛周边有什么好吃的 | 天坛 | 美食 |
第二步：检查 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 请求：
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）
第五步：返回链接给用户
完整示例
用户输入： "搜索西直门周边美食"
- 解析：位置 =
西直门，搜索类别 =美食 - 调用地理编码 API：
curl -s "https://restapi.amap.com/v3/geocode/geo?address=西直门&output=JSON&key=xxx" - 获取坐标：
116.353138,39.939385→ 经度116.353138，纬度39.939385 - 拼接链接：
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 — 浅色模式（浅色背景，适合日常查看）
执行步骤
- 获取数据地址：从用户输入中提取数据 URL，如果用户未提供，提示用户给出数据地址
- 确认地图风格：询问用户偏好的地图风格（
grey或light），如果用户未指定，默认使用grey - URL 编码：将数据地址进行 URL 编码（将
://→%3A%2F%2F，/→%2F等） - 拼接链接：生成完整的热力图 URL
- 返回链接给用户
示例
用户输入： "帮我用这份数据生成热力图：https://a.amap.com/Loca/static/loca-v2/demos/mock_data/hz_house_order.json，用暗黑模式"
- 数据地址：
https://a.amap.com/Loca/static/loca-v2/demos/mock_data/hz_house_order.json - 地图风格：
grey - URL 编码后的数据地址：
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=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 搜索，支持更多参数和筛选条件。
使用方法
# 基础搜索
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参数说明
| 参数 | 说明 | 必填 | 示例 |
|---|---|---|---|
--keywords | 搜索关键词 | 是 | --keywords=肯德基 |
--city | 城市名称或编码 | 否 | --city=北京 |
--types | POI 类型编码 | 否 | --types=050000 |
--location | 中心点坐标（经度,纬度） | 否 | --location=116.397428,39.90923 |
--radius | 搜索半径（米） | 否 | --radius=1000 |
--page | 页码 | 否 | --page=1 |
--offset | 每页数量（最大25） | 否 | --offset=10 |
在代码中使用
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();场景五：路径规划
规划不同出行方式的路线。
使用方法
# 步行路线
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- 公交路线（需要指定城市）
场景六：智能旅游规划
自动搜索兴趣点并规划游览路线，生成地图可视化链接。
使用方法
# 基础旅游规划
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功能说明
- 自动搜索指定城市的兴趣点（每类最多5个）
- 按顺序规划各兴趣点之间的路线
配置管理
配置文件位于 config.json，包含以下内容：
{
"webServiceKey": "your_amap_webservice_key_here"
}设置 Key 的方式：
- 环境变量：
export AMAP_WEBSERVICE_KEY=your_key - 命令行参数：
node index.js your_key - 自动提示：首次运行时自动提示输入
- 手动编辑：直接编辑
config.json文件
注意事项
- 场景判断是关键：区分用户是"直接搜某个东西"、"在某个位置附近搜某个东西"、"规划路线"还是"旅游规划"
- 关键词应尽量精简准确，提取用户真正想搜的内容
- URL 中的中文关键词浏览器会自动处理编码，无需手动 encode
- 场景二、四、五、六需要用户提供高德 API Key，必须先获取 Key 后再发起请求，不能跳过
- 如果地理编码 API 返回
status不为"1"，说明请求失败，需提示用户检查 Key 是否正确或地址是否有效 - API 返回的
location格式为经度,纬度（注意：经度在前，纬度在后） - 场景二的搜索范围默认 1000 米，用户如有需要可调整
range参数 - 请妥善保管你的 Web Service Key，不要分享给他人
- 高德 Web 服务 API 有调用频率限制，请合理使用
- 免费用户每日调用量有限制，具体请查看高德开放平台说明