核心用法
AMap GUI是高德地图官方发布的命令行工具，基于Electron容器运行JSAPI 2.0地图实例。用户通过CLI参数执行地图操作，所有结果以结构化JSON返回，便于AI Agent解析和决策。
关键特性：
- 生命周期管理：
status/start/stop命令显式控制容器，启动时阻塞至mapReady: true - 地图状态控制：
mapState支持视角设置（中心点、缩放、旋转、俯仰、样式） - 智能路径规划：
route命令支持驾车/步行/骑行/公交，起点终点可接收地名自动geocode，驾车模式支持16个途经点 - POI搜索：
searchPOI支持关键词搜索和周边搜索，结果含距离、电话、分类等完整字段 - 交互感知：
getLastEvent捕获用户在GUI上的点击/选点事件，实现"指哪打哪"式工作流
显著优点
1. 官方背书：@amap-lbs/amap-gui为高德官方npm包，来源可信，避免第三方库的数据风险
2. AI原生设计：全JSON输出，无截图依赖，Agent可直接解析决策
3. 地名智能解析：--from/--to参数直接接收中文地名，容器内部自动处理geocoding
4. Electron容器隔离：地图运行在独立进程，不影响主机环境
5. 安全密钥支持：兼容新版JSAPI Key的安全密钥机制
潜在局限
- 坐标格式严格：
mapState和searchPOI的--center仅支持lng,lat坐标，不接受地名 - 单实例限制：同时只能运行一个容器实例
- 网络依赖：所有地理服务依赖高德云端API，离线不可用
- Electron资源占用：约200-400MB内存，轻量场景略显沉重
- 公交模式限制：必须显式指定
--city参数
适合人群
- AI Agent开发者：需要结构化地图数据的自动化工作流
- 运维/数据工程师：命令行环境下的批量地理分析
- RPA场景：结合用户GUI点击事件触发的智能导航
- 高德生态用户：已有高德Key，需要Server-to-Server调用
常规风险
- Key泄露风险：
AMAP_KEY和AMAP_SECURITY_KEY需妥善保管，避免提交到代码仓库 - npm包名校验：安装时需确认
@amap-lbs/amap-gui拼写正确，防范typosquatting攻击 - 容器残留：异常退出可能导致Electron进程残留，需手动
stop或检查status - 配额消耗：频繁调用会消耗高德API配额，生产环境需监控用量