核心用法
高德地图 Web API Skill 提供基于 Python 标准库的零依赖 CLI 工具 (scripts/amap.py)，agent 可直接调用完成地理信息服务任务。核心能力覆盖四大场景：
1. 地理编码：地址↔坐标双向转换 (geocode/regeo)，支持结构化地址解析
2. POI 检索：关键词搜索 (search) 与周边范围搜索 (around)，默认 3000 米半径
3. 路线规划：驾车 (driving) 与步行 (walking) 路径计算，返回距离、耗时及分步导航
4. 辅助服务：天气查询 (weather)、IP 定位 (ip)、通用 API 兜底调用 (call)
典型工作流
- 本地生活：
geocode定位地址 →around搜索周边商户 → 按距离/评分整理推荐 - 通勤决策：同起终点并行查询多交通方式，对比耗时给出最优方案
- 数据治理：批量地址标准化清洗，提取规范化地址、adcode 及坐标入库
显著优点
- 零依赖部署：仅 Python 标准库，无需额外安装 requests 等库，环境兼容性极强
- 开箱即用：提供完整 CLI 命令手册，覆盖 90%+ 高频 API 场景
- 坐标系避坑指南：内置中国坐标系（WGS-84/GCJ-02/BD-09）科普与官方转换接口指引，解决跨平台数据迁移痛点
- 平台选型建议：对比高德、腾讯、百度、Google Maps 的适用场景，降低技术决策成本
潜在缺点与局限性
- 配额限制严格：免费版日配额有限（各接口独立计数），QPS 约 3/秒，高频调用易触发 10003/10021 错误
- Key 类型易错：必须使用"Web服务"类型 Key，JS API Key 调用 REST 接口会报 10001
- 未封装低频接口：静态地图、轨迹纠偏、地理围栏等需用
call手动组装参数 - 境外数据薄弱：海外场景建议切换 Google Maps/Mapbox
- 无内置限流重试：CLI 层未实现自动退避，高并发场景需调用方自行控制
适合人群
- 需要快速验证 LBS 功能原型的开发者
- 处理中国地址数据清洗、坐标转换的数据工程师
- 构建本地生活、出行规划类 agent 的应用开发者
- 微信小程序外溢场景（微信生态内优先选腾讯地图）
常规风险
| 风险类型 | 说明 |
|---------|------|
| 密钥泄露 | AMAP_KEY 环境变量传递，需注意 CI/日志脱敏 |
| 配额耗尽 | 生产环境未监控用量可能导致服务中断 |
| 坐标系混淆 | 跨平台数据未转换导致位置偏移数百米 |
| 合规边界 | 技能明确不提供网页爬取方案，遵循官方 API 使用规范 |