Tencent Map

腾讯位置服务CLI与微信小程序地图开发指南

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Tencent Map。
它的用途是:腾讯位置服务CLI与微信小程序地图开发指南
完整的 Skill 内容见:https://321skill.com/skills/tencent-map/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我查询北京市海淀区的经纬度,并规划从北京西站到天安门的公交路线。' 它会调用腾讯地图 CLI 执行 `geocode` 和 `route` 命令,返回坐标和详细的公交线路方案,同时附上 GCJ-02 坐标系的转换说明。

介绍

该仓库提供腾讯位置服务 WebService API 的零依赖命令行工具,以及微信小程序 LBS 开发的完整指南。主要解决三类问题:一是通过终端快速查询地理编码、POI(兴趣点)、路线规划、IP 定位等位置数据,无需编写额外代码;二是帮助开发者在微信小程序中集成腾讯地图(微信官方推荐方案),并规避 GCJ-02 国测局坐标系常见的坑;三是为需要位置能力的 AI Agent 或后端服务提供便捷的 API 调用封装。

使用方式非常直接:安装后直接在终端执行命令,例如 tencent-map geocode "北京市海淀区" 即可获取经纬度;或 tencent-map route "北京西站" "天安门" --mode=transit 规划公交路线。同时,仓库内附带微信小程序地图组件的示例代码和坐标系转换注意事项,可快速参考复用。

适合后端开发、全栈开发、智能体开发者以及微信小程序开发人员。特别是那些需要快速集成位置查询、路线规划、IP 定位等功能,但不想手动拼接 HTTP 请求和管理 API 签名的场景。对需要处理坐标偏移(GCJ-02 与 WGS-84 互转)的开发者尤其友好。

使用前请先申请腾讯位置服务 API 密钥(Key),并确保网络能访问腾讯地图 API 域名。坐标系转换仅适用于国内范围,海外地图请使用 WGS-84。CLI 工具依赖 Node.js 运行环境,但零外部依赖,安装即用。

核心特点

与同类地图工具相比,本仓库专门针对腾讯地图,并集成了微信小程序官方推荐的 LBS 开发指南,附赠 GCJ-02 坐标系避坑说明,同时提供零依赖的 CLI 工具,无需搭建 HTTP 客户端即可调用。

注意事项

仅支持腾讯位置服务 API,不适用于高德、百度等地图服务,且坐标系转换逻辑仅限国内使用。

常见问题

如何获取腾讯地图 API 密钥?

前往腾讯位置服务官网(lbs.qq.com)注册账号,创建应用后获取 Key,然后在 CLI 中通过 `--key` 参数或环境变量 `TENCENT_MAP_KEY` 设置。

支持哪些坐标系的转换?

主要处理 GCJ-02(国测局坐标)与 WGS-84(GPS 原始坐标)之间的互转,以及常见的地图纠偏需求。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/tencent-map/raw/index.md 读取 Tencent Map 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。