Agent Skills
返回列表
高德地图生活服务

高德地图生活服务

生活服务 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_aad656e7/test-amap-skill。

技能介绍

它解决什么问题

在客服对话、脚本或自动化流程中，很多位置请求来自自然语言，例如“帮我查一下[城市]的天气”“搜索[地点]附近的[东西]”“从[A]到[B]怎么走？”“查询[地址]的经纬度”“这个坐标[经度,纬度]是哪里？”。这些请求看似简单，但落到地图 API 上，往往需要先把城市转成 adcode，把地址转成 经度,纬度，把关键词限定到合适的城市范围，再判断应该调用天气、POI 搜索、路径规划还是地理编码接口。手动拼参数会消耗时间，也会因为行政区划、别名、缩写或地址描述不规范而出错。

这个技能如何工作

test-amap-skill 把高德地图 Web 服务 API 封装成一组可复用的位置能力，核心流程是：识别用户意图，补齐 API 所需参数，调用对应接口，再返回结构化结果。

  • 天气查询：用于查询指定城市的实时天气或天气预报。如果用户只给出城市名，需要先通过 行政区划查询 获取该城市的 adcode，再请求天气接口。
  • 地点搜索 (POI)：用于根据关键字在指定城市搜索地点信息。适合“搜索[地点]附近的[东西]”“查找[关键词]的位置”这类请求。
  • 驾车路径规划：用于规划两个地点之间的驾车路线。接口需要起点和终点的经纬度；如果用户提供的是地址，需要先通过 地理编码 转成 经度,纬度。
  • 地理编码：把结构化地址转换为经纬度，适用于“查询[地址]的经纬度”。
  • 逆地理编码：把经纬度转换为结构化地址，适用于“这个坐标[经度,纬度]是哪里？”。
  • 行政区划查询：用于查询省、市、区、街道的行政区划信息，包括 adcode 和边界。当天气查询缺少 adcode 时，这一步是常见前置步骤。

使用前必须准备高德开放平台申请的 Web 服务 API Key，并将其设置为环境变量 AMAP_KEY。Clawdbot 会自动读取这个环境变量来调用 API。

适用边界与注意点

  • 本技能面向高德地图 Web 服务 API 支持的查询场景，不处理导航安全、驾驶决策或实时路况以外的扩展能力。
  • 天气查询依赖正确的 adcode；城市别名、简称或区县名可能无法直接匹配，应先用 行政区划查询 校正。
  • 路径规划依赖精确的 经度,纬度；用户提供门牌号、楼栋名或模糊地标时，应先做地理编码，再处理结果不唯一的情况。
  • POI 搜索结果可能受关键词、城市范围和接口参数影响，必要时应补充城市名或调整关键词。
  • 环境变量 AMAP_KEY 未配置时，调用会失败；不要在技能说明或日志中明文粘贴密钥。
  • 返回结果应以高德地图 API 官方响应为准，技能不额外承诺边界外的地址纠错、跨平台路线或非地图类生活服务。

使用场景

  • 客服助手收到“查上海天气”时，需要用行政区划查询补齐 adcode 后调用天气接口。
  • 路线规划前要把用户给的起点和终点地址，先通过地理编码转成经纬度再请求驾车路线。
  • 脚本收到地址和坐标两类输入，分别用地理编码和逆地理编码做地址解析与反解。
  • 用户在城市筛选页输入关键字，需要限定城市范围后调用 POI 搜索返回地点列表。

适合人员

  • 客服系统开发者，要把天气、POI 和路线类地址请求接入对话机器人。
  • 数据分析工程师，需要把地址批量转成经纬度或反查结构化地址。
  • 出行产品工程师，负责在路线规划前补齐坐标、adcode 等 API 参数。
  • 内容运营，需要在城市页中按关键词返回地点信息并处理结果不唯一的情况。