高德地图 (Amap) Skill:把地点搜索、天气和路线规划交给 Agent

前言

给 Agent 安排出行相关任务时,常见的做法是自己写一段脚本去调高德 Web 服务 API:先找文档、再拼 URL、然后处理签名和返回结构。这部分工作重复且琐碎,而且每次换任务都要重写一遍。下面介绍的这个 Skill 把这几件事收敛成一个可复用的最小单元:Agent 在需要地点搜索、天气查询或路线规划时直接调用,不用每次重新对接。

这是什么

高德地图 (Amap) 是一个面向 Agent 的 Skill,定位是「使用高德地图 Web 服务 API 进行地点搜索、天气查询和路线规划」。它由企业(enterprise)来源发布,维护者为 RealQ,当前版本 1.0.0,归属 life-service 分类。

它解决的问题很直接:让 Agent 在对话或任务流程中发起高德地图相关的查询,而不需要使用者自己维护 API 调用代码。Skill 标签中带有 requires_api_key=true,说明它依赖外部密钥才能工作。

核心功能

Skill 的能力范围与高德地图 Web 服务 API 的能力范围一致,目前包含三项:

1、地点搜索:按关键字或条件检索地点,拿到位置信息。
2、天气查询:查询指定位置的天气情况。
3、路线规划:在起终点之间规划路线。

三项能力都建立在高德地图 Web 服务 API 之上,因此返回结果的字段、精度和可用范围由该 API 决定,Skill 本身不额外提供数据。

安装与启用

Skill 通过 SkillHub 分发,坐标为 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-amap。

需要说明的是:在已抓取的官方资料中,没有给出具体的安装命令、安装目录和配置字段名称,因此这里不臆造命令。下面只列出启用前必须确认的两件事。

前置条件一,密钥。Skill 标签标明 requires_api_key=true,需要自备高德地图 Web 服务 API 的 Key,并在 Skill 的配置中填入。配置项的具体名称以官方 SKILL.md 为准。

前置条件二,运行环境。这类 Skill 基于通用 SKILL.md 格式,能否加载取决于你使用的 Agent 宿主(如 Cursor、Codex CLI、Claude Code 等)是否支持该格式。已抓取资料中没有针对具体宿主的差异化说明,所以这里不做分别描述。

拿到安装命令的可靠方式是打开下面的官方地址,在 SkillHub 页面中按页面提示操作。

官方地址:https://www.skillhub.cn/skills/org-eyw2ohcx/sundial-org-awesome-openclaw-skills-amap
API 地址:https://api.skillhub.cn/org-eyw2ohcx/sundial-org-awesome-openclaw-skills-amap

典型用法

安装并配好密钥之后,就可以把任务交给 Agent 了。下面三类请求分别对应 Skill 的三项能力(这里是示例请求,实际返回内容以调用时的接口结果为准):

帮我搜一下「杭州西湖附近的停车场」。

帮我查一下杭州今天的天气。

帮我规划从北京西站到首都机场的驾车路线。

使用方式与调用其它高德 Web 服务 API 相同:Agent 侧发起查询,Skill 负责把请求落到对应的接口上。地点搜索、天气查询和路线规划分别对应高德地图 Web 服务的不同接口,Skill 内部做了归类。

适用场景与注意

适合的场景:已经在用 Agent 处理出行、差旅、同城配送、地点筛选这类任务,希望省去手写高德 API 调用代码;或者想在同一套对话流程里同时用到搜索、天气和路线三类信息。

需要注意的几点:

1、密钥是必须的。没有配 Key,Skill 无法工作,请提前准备好高德地图 Web 服务 API 的 Key。
2、能力边界就是高德地图 Web 服务 API 的边界。它不提供与高德地图无关的地理能力,也不保证数据实时性超出该 API 的范围。
3、路线规划的具体参数(如出行方式、避让条件)取决于所调用接口的支持情况,超出接口支持的参数不会被 Skill 自行处理。
4、截至抓取时,Skill 页面显示安装数为 0、评分 100000、下载 1074。安装数为 0 不代表 Skill 不可用,但说明它目前的采用情况还没有公开数据支撑,建议先在小范围任务里验证返回结果是否符合预期。

小结

高德地图 (Amap) Skill 的价值在于把高德地图 Web 服务 API 的地点搜索、天气查询和路线规划三项能力打包成一个可直接被 Agent 调用的单元,省去使用者自己写对接代码的成本。它由 RealQ 维护,企业来源发布,当前版本 1.0.0,需要自备 API Key。官方地址:https://www.skillhub.cn/skills/org-eyw2ohcx/sundial-org-awesome-openclaw-skills-amap

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜