前言¶
做数据分析、运营报表或对话式助手时，常会碰到地址转坐标、附近 POI、路线耗时、天气这类需求。自己拼 HTTP 请求要记一堆高德开放平台接口与参数；让模型「凭记忆」答地名和路线又容易不准。下面介绍 SkillHub 上的社区 Skill「高德地图(qq9349540)」：把地理编码、POI 搜索、路线规划等能力写进 Agent 的 SKILL 说明，在需要时按高德地图 API 查询中国境内的地理数据。
这是什么¶
「高德地图(qq9349540)」是 SkillHub 坐标为 @user_9cef7bd1/amap-qq9349540 的 Agent Skill，当前版本 v2.4.0，来源标注为 community，发布者为 user_9cef7bd1，分类为 data-analysis。官方页面说明：当用户需要地理编码、POI 搜索、路线规划（驾车/步行/骑行/公交）、坐标转换、天气预报、批量操作或数据导出时，应使用此技能；底层依赖高德地图 API，面向中国地理数据查询场景。
核心功能¶
以下能力均来自 SkillHub 官方简介，安装并配置好密钥后由 Agent 按 SKILL 指引调用：
- 地理编码：地址与坐标之间的转换。
- POI 搜索：按关键词或位置检索兴趣点。
- 路线规划：支持驾车、步行、骑行、公交等出行方式。
- 坐标转换：在不同坐标系之间转换（常见于地图与定位数据对齐）。
- 天气预报：基于高德相关能力查询天气。
- 批量操作与数据导出：适合一次性处理多条地理查询或整理结果。
SkillHub 标签 requires_api_key=true，表示使用前需要自行准备高德开放平台 API Key，并在 Skill 要求的配置方式中填写（具体变量名以安装后的 SKILL.md 为准）。
安装与启用¶
方式一：让 AI 按官方指引安装¶
SkillHub 页面给出的安装提示如下，可将原文发给当前使用的 AI 客户端执行：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_9cef7bd1/amap-qq9349540`。
方式二：SkillHub CLI¶
先确认本机是否已有 skillhub（参见 SkillHub 安装文档）。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能识别不到。
command -v skillhub && skillhub --version
skillhub install @user_9cef7bd1/amap-qq9349540 --dir <skills 目录>
常用客户端 skills 目录示例（与官方安装文档一致）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装完成后按各客户端要求刷新或重启，使新 Skill 生效。高德 Key 需在 Skill 文档说明的位置配置；未配置时带 requires_api_key 的调用通常会失败。
典型用法¶
本 Skill 以自然语言任务触发为主，Agent 在匹配到地理类需求时读取 SKILL 并调用高德 API。可与官方简介对齐的提问方向包括：
- 把「北京市朝阳区阜通东大街 6 号」做地理编码，或把给定经纬度反查地址。
- 在某城市或某坐标附近搜索 POI（例如加油站、地铁站、商圈名称）。
- 规划从 A 到 B 的驾车、步行、骑行或公交路线，并比较耗时与距离。
- 对一批地址或坐标做批量查询，并将结果整理为可导出的表格或文件（以 Skill 内支持的导出方式为准）。
具体请求参数、子命令或脚本路径以安装包内 SKILL.md 为准；本文不展开未在公开页面列出的接口细节。
适用场景与注意¶
适合谁：需要在中国境内做地理信息查询的开发者、数据分析师，或希望在 Cursor / Claude Code 等环境中用对话完成「查地点、算路线、拉天气」的团队。
使用注意：
- 依赖高德开放平台账号与 API Key，调用量、配额与计费以高德官方规则为准。
- 数据覆盖与精度以高德 API 返回为准，不适合作为唯一的高精度测绘或导航依据。
- 社区来源（community）Skill，升级与维护节奏跟随发布者；安装前可在 SkillHub 查看版本 v2.4.0 及页面上的评分、下载与安装统计（页面展示：评分 100000，下载 4668，安装 98）。
结尾¶
「高德地图(qq9349540)」把高德地图 API 的常见能力收敛成一条 Agent Skill，减少手写请求与记接口的成本，适合 data-analysis 场景下的地理数据查询与导出。安装与详情见 SkillHub：
- 页面：https://www.skillhub.cn/skills/user_9cef7bd1/amap-qq9349540
- API 入口（Skill 元数据）：https://api.skillhub.cn/user_9cef7bd1/amap-qq9349540
