前言¶

后端或脚本里要接位置能力时，常见路径是翻腾讯位置服务文档、对照参数表拼 URL，再处理 JSON 返回与坐标系差异。地图 SDK 和 WebService 的职责也不同：前者管展示，后者只管数据。若你只需要地理编码、POI 搜索、路线规划等 HTTP JSON 接口，又希望对话式开发时少漏参数、少混接口，可以把官方能力封装成 Agent Skill，让模型按既定指引组织调用。

下面介绍 SkillHub 上的 腾讯地图 WebService API 开发技能（坐标 @tencent-adm/tencentmap-webservice-skill，当前版本 1.0.5），由 腾讯地图位置服务团队 发布，来源标注为 enterprise，分类为 dev-programming。

这是什么¶

一句话：面向 腾讯位置服务 WebService API 的开发技能，通过 HTTP 集成地理编码、地点搜索、路线规划、天气、IP 定位等能力，不包含地图渲染与前端可视化，只覆盖 WebService 的 JSON 数据接口。

在 SkillHub 上，该技能带有 requires_api_key=true 标签，表示实际调用腾讯接口时需要有效的位置服务密钥；密钥申请与控制台配置仍以腾讯位置服务官方流程为准，技能侧负责在对话中引导正确的 API 选择与参数用法。

核心功能¶

以下能力与 SkillHub 页面简介一致，均对应 WebService 侧能力，而非地图组件：

1. 地址与坐标互转：地理编码、逆地址解析、智能地址解析。
2. 地点与 POI：地点搜索、周边 POI 查询。
3. 输入体验：关键词输入提示、自动补全。
4. 路线规划：驾车、步行、骑行、电动车、公交等模式。
5. 距离计算：距离矩阵、批量距离。
6. 定位与气象：IP 定位、天气查询。
7. 基础数据：坐标系转换、行政区划查询。

技能会在用户提到地理编码、地址转坐标、逆地址解析、POI 搜索、路线规划、距离矩阵、批量距离、天气查询、IP 定位、坐标转换、行政区划、输入提示、自动补全、WebService API 等表述时触发，把对话引向对应的接口说明与调用步骤。

安装与启用¶

方式一：SkillHub CLI¶

先确认本机是否已安装 skillhub（安装方式见 SkillHub 安装文档）。安装技能时 必须 使用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。

skillhub install @tencent-adm/tencentmap-webservice-skill --dir <你的 Agent skills 目录>

常用目录示例（以安装文档为准）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装后按你所用客户端的要求刷新或重启 Agent，使技能被索引。

方式二：让 AI 按官方指引安装¶

SkillHub 页面提供的提示词为：根据 https://skillhub.cn/install/skillhub.md 安装 @tencent-adm/tencentmap-webservice-skill。适合尚未配置 CLI、但已在对话中启用 Skill 安装能力的环境。

典型用法¶

技能本体为通用 SKILL.md 格式，不替代腾讯控制台，而是在开发对话中补齐「选哪个接口、参数怎么填、返回字段如何理解」的上下文。可复现的启用方式如下。

安装后，用自然语言描述 WebService 需求，与官方列出的触发词一致即可，例如：

• 「把『北京市海淀区中关村大街 1 号』做地理编码，用腾讯 WebService。」
• 「两点驾车路线规划，输出 JSON 字段说明。」
• 「批量算多个起点到同一终点的距离矩阵，接口和参数怎么传？」

Agent 加载 @tencent-adm/tencentmap-webservice-skill 后，应依据技能内文档组织 HTTP 请求说明（路径、必填参数、坐标系注意事项等），而不是生成地图页面或小程序 map 组件代码。若同一项目还要做小程序地图展示，需另选面向前端的地图类技能；WebService 技能只覆盖后端 HTTP 数据层。

适用场景与注意¶

适合谁

• 用 Cursor、Claude Code、Codex 等带 Skills 的 Agent 写后端、脚本或集成服务的开发者。
• 已确定使用腾讯位置服务 WebService，不需要在本技能内解决瓦片、标注、可视化的问题。

边界与注意

• 仅 HTTP JSON：不涉及地图渲染；前端展示需用地图 SDK 或其他技能。
• 需要 API Key：标签 requires_api_key=true；未配置密钥时，技能无法替代真实联调，只能做参数与文档层面的辅助。
• 与小程序地图分工：小程序内 map 组件、选点定位等场景，SkillHub 生态中有单独的地图小程序类技能；本技能对应「后端 HTTP：路线、POI、地理编码、距离矩阵、IP 定位」一类需求。

在 SkillHub 统计上（以页面抓取为准），该技能评分 100000，下载 3250，安装 47；具体数字会随平台更新变化，以 SkillHub 详情页为准。

结尾¶

若你的工作流是「Agent 写代码 + 腾讯位置服务 WebService」，该技能把官方能力清单和触发场景收敛进 SKILL，减少在多种路线/搜索/编码接口之间来回查文档的成本。安装与详情见：

• API 入口：https://api.skillhub.cn/tencent-adm/tencentmap-webservice-skill
• SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/tencentmap-webservice-skill