用途:这是一个迁移指引类 Skill,帮助开发者把 Google Maps Platform 的调用替换为高德地图(AMap)对应接口与 SDK,涵盖 Web 服务 API(14 个端点)、JavaScript API 以及 Android/iOS 移动 SDK。
主要能力:先确认开发者所属区域(中国大陆含港澳台,或以外地区)与开发类型(服务端 Web API、前端 JS API、移动 SDK),再输出 Google 与高德双列的 API 映射表,以及带字段级映射的迁移代码。文档列出关键差异:坐标顺序由 Google 的 lat,lng 变为 lng,lat;非大陆搜索/地理编码需要传 adcode(如美国 840000000、日本 392000000);Google 返回 {lat,lng} 对象而高德返回 "lng,lat" 字符串,需 split(',');Distance Matrix 由 GET 加 | 分隔改为 POST 加 ; 分隔;POI ID 非大陆以 P 开头;langCode 支持 zh/en/ja/ko 等 18 种以上语言。JS API 部分给出类映射(Map、Marker、InfoWindow、Polyline、Polygon、Circle、LngLat、Geocoder 等)、事件映射(zoom_changed→zoomchange、center_changed/bounds_changed→moveend、idle→complete 等)与插件显式加载方式。Android SDK 映射结构与 Google 高度相似,多为改包名即可;iOS 使用 MA/AMap 前缀,且把数据模型与视图分离。
使用方式:安装命令为 npx skills add AMap-Web/amap-map-agent-skills。文档提供公共测试 Key,Web 服务 API 为 40ffec9172a0dd65b7e224bb252b7e0b,JS API 为 b87b3d194a024295b1b17be020659457,移动 SDK 需在控制台自行创建 Key,Web/JS Key 不可用于移动端。非大陆 Web API 域名为 sg-restapi.opnavi.com,JS CDN 为 sg-webapi.opnavi.com;大陆为 restapi.amap.com 与 webapi.amap.com。
适用场景与限制:适合已有 Google Maps 集成、希望迁移至高德并保持原有命令式面向对象架构的项目。公共 Key 为零注册、零成本的限时推广额度,按日先到先得,配额用尽需次日重试或联系销售;生产环境应自行申请专属 Key。非大陆定位接口目前为 HTTP 且接受 MAC/IMEI 等设备标识,生产环境应优先 HTTPS,避免明文传输敏感数据。文档称同等能力价格约为 Google 一半,但具体计价与条款需以官方信息为准。更多参数与响应字段映射见 references 文档(web-api-params.md、js-api-detail.md)。