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-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用高德地图CLI，将地图中心设置为北京天安门（116.397428, 39.90923），缩放级别15，并搜索附近500米内的餐厅，返回JSON格式结果。' 它会执行CLI命令，返回包含地图状态、搜索结果列表（名称、地址、坐标、评分等）的结构化JSON。
介绍
高德地图CLI是一款专为AI Agent设计的命令行工具，解决了在容器化环境中无法直接交互式操作地图的问题。传统地图API需要前端页面或手动调用，而该工具允许通过简单的CLI参数实时控制高德地图JSAPI 2.0实例，实现地图状态控制、路径规划、POI搜索等核心功能。所有操作均以结构化JSON输出，便于AI Agent解析和后续处理，极大降低了地图可视化交互的开发门槛。
使用方法极其简单——只需在终端中传入CLI参数即可操控地图实例。例如，设置地图中心点、缩放级别、添加标记、绘制路线或搜索周边设施。工具返回的JSON结果包含完整的地图状态、查询结果或错误信息，可无缝集成到自动化工作流或AI Agent的决策循环中。无需编写前端代码，无需启动浏览器，一切在命令行中完成。
该工具非常适合以下人群：智能体开发者需要为AI应用添加地图可视化能力；前端开发者希望快速验证地图交互逻辑；全栈开发者需要在后端或DevOps流程中集成地图功能；数据分析师需要基于地理位置的数据展示。尤其是构建AI Agent驱动的地图导航、位置查询、行程规划等场景，高效且直观。
使用前请确保已安装Node.js环境，并准备好高德地图JSAPI的Key。建议先阅读官方文档了解支持的CLI参数列表。由于工具运行在容器中，需确保容器端口映射正确。注意CLI输出为JSON，若需前端渲染，建议配合模板引擎或直接使用地图实例的截图功能。
核心特点
与同类地图CLI工具相比，本工具直接操控运行在容器中的高德地图JSAPI实例，而非调用REST API获取数据，因此能实时获取地图截图、执行前端交互动作（如缩放、旋转），并以结构化JSON输出完整状态，更适合AI Agent的闭环操作。
注意事项
工具依赖容器环境运行高德地图JSAPI实例，无法在无图形界面的纯终端中直接渲染地图，且需要网络访问高德CDN资源。
常见问题
这个CLI工具需要高德地图API Key吗？
需要。你需要申请高德地图JSAPI的Key，并在启动容器时传入环境变量或配置文件。
支持哪些地图操作？
支持地图中心点/缩放控制、添加/移除标记、绘制折线/多边形、路径规划、POI搜索、图层切换等，具体可参考CLI的--help列表。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/gaode-map-cli-高德官方命令行工具-skill-x-2/raw/index.md 读取 Gaode Map CLI - 高德官方命令行工具 Skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/gaode-map-cli-高德官方命令行工具-skill-x-2/raw/index.md（查看排版版本）