Gaode Map CLI - 高德官方命令行工具 Skill
通过CLI实时操控高德地图JSAPI实例
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Gaode Map CLI - 高德官方命令行工具 Skill。 它的用途是：通过CLI实时操控高德地图JSAPI实例 完整的 Skill 内容见：https://321skill.com/skills/gaode-map-cli-高德官方命令行工具-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我查询从北京南站到颐和园的地铁路线，并返回费用和时间'，Gaode Map CLI会调用路径规划接口，返回包含换乘详情、总耗时、票价等信息的JSON数据，AI可据此生成图文回答。若需要显示在地图上，可追加参数--render=true，CLI会启动容器内地图实例并截图。
介绍
高德地图作为国内领先的地图服务商，其JSAPI 2.0提供了丰富的地图功能。但传统上，开发者需要通过编写JavaScript代码或在浏览器中手动操作才能使用这些功能。对于AI Agent而言，这种交互方式既不直接也不高效。Gaode Map CLI解决了这个问题：它允许用户通过命令行参数直接操控运行在容器中的高德地图JSAPI实例，实现地图状态控制、路径规划、POI搜索等核心操作，所有结果均以结构化JSON格式返回，便于AI Agent解析和下一步处理。
使用方式非常简单：在安装了Docker或Podman的环境中，运行一条CLI命令即可启动一个高德地图容器实例，并通过参数传递操作指令。例如，要查询从天安门到故宫的驾车路线，只需输入类似gaode-map route --origin "天安门" --destination "故宫" --type driving的命令，系统会返回包含距离、耗时、路线坐标点等信息的JSON数据。路径规划、POI搜索、地图缩放、图层切换等操作均遵循相同的命令行范式。
该工具特别适合以下人群：需要将地图可视化能力集成到AI Agent中的智能体开发者；希望快速验证地图功能或进行数据可视化展示的前端开发者和数据分析师；以及需要批量处理地理信息查询的运营人员。它不需要用户具备前端开发经验，只需熟悉命令行操作即可。
建议在使用前确保本地环境已安装Docker并配置好网络，容器镜像首次启动可能需要下载。由于所有操作均在容器内完成，数据安全性较高。但需注意，高德地图JSAPI的调用受到API Key配额限制，请合理规划调用频率；同时，该工具不适用于需要实时交互式拖拽地图的复杂场景，更适合结构化、自动化的地图操作任务。
核心特点
与同类地图CLI工具（如百度地图CLI、腾讯地图CLI）相比，Gaode Map CLI是官方出品，直接操控高德地图JSAPI 2.0实例，所有输出为结构化JSON，专为AI Agent驱动的地图可视化交互场景设计，无需额外解析。
注意事项
不适用于需要实时交互式拖拽地图、连续动画或复杂3D地图渲染的场景，且依赖容器环境（Docker/Podman）。
常见问题
安装Gaode Map CLI需要什么环境？
需要安装Docker或Podman，并确保网络可访问容器镜像仓库。推荐使用Node.js 16+配合npm安装CLI工具。
如何获取高德地图API Key？
登录高德开放平台（lbs.amap.com），创建应用并申请JSAPI Key，在CLI命令中通过--key参数传入。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/gaode-map-cli-高德官方命令行工具-skill/raw/index.md 读取 Gaode Map CLI - 高德官方命令行工具 Skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/gaode-map-cli-高德官方命令行工具-skill/raw/index.md（查看排版版本）