（3255期）Gaode – 零依赖 CLI 直连高德 API

零依赖 CLI 直连高德 API 零依赖 Python CLI 直连高德 Web API，支持地理编码、POI 检索、路线规划、天气查询及中国坐标系转换，适合快速开发与中国 LBS 场景。 使用说明 核心用法 高德地图 Web API Skill 提供基于 Python 标准库的零依赖 CLI 工具 (scripts/amap.py)，agent 可直接调用完成地理信息服务任务。核心能力覆盖四大场景： 地理编码：地址↔坐标双向转换 (geocode/regeo)，支持结构化地址解析 POI 检索：关键词搜索 (search) 与周边范围搜索 (around)，默认 3000 米半径 路线规划：驾车 (driving) 与步行 (walking) 路径计算，返回距离、耗时及分步导航 辅助服务：天气查询 (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 使用规范 | 原始说明 高德地图 Web API 工具与开发指南。Use for: (1) 用附带的零依赖 CLI 直接查地理编码/POI/路线/天气/IP定位, (2) 中国坐标系(WGS-84/GCJ-02/BD-09)转换与避坑, (3) 高德全套 Web Service API 开发指导。Amap (Gaode) Web API...