高德地图综合服务 Skill

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

功能特性

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

首次配置

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

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

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

触发条件

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

• 搜索某类地点或某个确定地点（如"搜美食"、"找酒店"、"天安门在哪"）
• 基于某个位置搜索周边（如"西直门周边美食"、"北京南站附近酒店"）
• 规划路线（如"从天安门到故宫怎么走"、"规划驾车路线"）
• 旅游规划（如"帮我规划北京一日游"、"杭州西湖游览路线"）
• 包含"搜"、"找"、"查"、"附近"、"周边"、"路线"、"规划"等关键词
• 希望将地理数据可视化为热力图（如"生成热力图"、"用这份数据做热力图展示"）

场景判断

收到用户请求后，先判断属于哪个场景：

• 场景一：用户搜索一个明确的类别（美食、酒店）或确定的地点（天安门、西湖），没有指定"在哪个位置附近"
• 场景二：用户搜索某个位置周边的某类地点，输入中同时包含「位置」和「搜索类别」两个要素（如"西直门周边美食"、"北京南站附近酒店"）
• 场景三：热力图数据可视化
• 场景四：POI 详细搜索（使用 Web 服务 API）
• 场景五：路径规划
• 场景六：智能旅游规划

场景一：明确关键词搜索

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

URL 格式：

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

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

执行步骤

1. 提取关键词：从用户输入中识别出核心搜索词，去掉"搜"、"找"等修饰词
2. 生成 URL：拼接 https://www.amap.com/search?query={关键词}
3. 返回链接给用户

示例

回复模板

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

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