Coding

Gaode

Try it

高德地图 Web API 工具与开发指南。Use for: (1) 用附带的零依赖 CLI 直接查地理编码/POI/路线/天气/IP定位, (2) 中国坐标系(WGS-84/GCJ-02/BD-09)转换与避坑, (3) 高德全套 Web Service API 开发指导。Amap (Gaode) Web API...

What it does

附带零依赖 CLI（，仅 Python 标准库），agent 可直接替 用户完成地理查询任务：地址↔坐标、找店、算路线、查天气、IP 定位。

The skill document

高德地图 Web API Skill

附带零依赖 CLI（scripts/amap.py，仅 Python 标准库），agent 可直接替 用户完成地理查询任务：地址↔坐标、找店、算路线、查天气、IP 定位。

快速开始

# lbs.amap.com 免费申请（个人开发者即可），Key 类型选 "Web服务"
export AMAP_KEY=你的key

python3 scripts/amap.py geocode "北京市朝阳区阜通东大街6号"
python3 scripts/amap.py around 116.481028,39.989643 咖啡 1000
python3 scripts/amap.py driving 116.481028,39.989643 116.434446,39.90816
python3 scripts/amap.py weather 110101 all

脚本行为声明：仅请求 restapi.amap.com，不读写本地文件。

命令手册

命令作用
geocode <地址> [城市]地址 → 坐标（返回 lng,lat 与规范化地址）
regeo 坐标 → 结构化地址（省市区街道）
search <关键词> [城市]POI 关键词搜索
around <关键词> [半径米]周边搜索（默认 3000 米）
driving / walking <起点> <终点>路线规划（返回距离米/耗时秒/分步导航）
weather [all]实况天气；带 all 返回未来 4 天预报
ip [地址]IP 定位到城市
call k=v ...通用兜底：调任意 v3/v5 接口（公交/骑行/静态图等）

call 兜底示例：

python3 scripts/amap.py call /v5/direction/bicycling origin=116.48,39.98 destination=116.43,39.90
python3 scripts/amap.py call /v5/direction/transit/integrated origin=116.48,39.98 destination=116.43,39.90 city1=010 city2=010

Agent 典型用法

  1. "帮我找 XX 附近的咖啡馆"：先 geocode 定位 XX → around 搜周边 → 按距离/评分整理成清单给用户
  2. 通勤方案对比：同一起终点分别跑 driving/walking/公交（call 兜底）， 对比耗时与距离给建议
  3. 批量地址清洗：一批不规范地址循环 geocode，拿规范化地址 + adcode
    • 坐标，用于数据入库
  4. 出行前置检查：weather <目的地adcode> all 看未来 4 天预报

中国坐标系必读（跨平台开发最大的坑）

  • WGS-84：GPS 原始坐标。直接标在高德地图上会偏移约几百米
  • GCJ-02（火星坐标）：国家测绘局加密标准，高德、腾讯地图使用
  • BD-09：百度自有，GCJ-02 二次加密，仅百度使用
  • 转换：高德提供官方接口 /v3/assistant/coordinate/convert （coordsys=gps|baidu → GCJ-02），跨平台迁移数据先转坐标再入库
  • 症状自查：位置整体偏移几百米 ≈ 坐标系搞混；偏移几十米 ≈ 精度问题

高频错误码

infocode含义处理
10001Key 无效检查 Key 类型必须是"Web服务"（JS API 的 Key 调 REST 会报这个）
10003日配额超限免费版各接口每日限额不同，次日重置；商用需认证/付费
10021并发超限加限速，免费版 QPS 很低（约 3/秒）
30001无查询结果地址写法换个粒度重试（省市+街道）

与其他地图平台对比选型

场景建议
微信小程序腾讯地图（微信官方推荐，见 tencent-map skill）
POI/检索数据要求高高德或百度（见 baidu-map skill）实测对比
导航/驾车生态高德（车机市占率最高）
海外地图三家境外数据都弱，选 Google Maps/Mapbox

本 skill 不做什么

  • 不提供爬取高德网页端数据的方法（用官方 API，免费额度对个人够用）
  • 静态地图、轨迹纠偏、地理围栏等低频接口未封装命令，用 call 兜底， 参数以官方文档 lbs.amap.com/api/webservice/summary 为准

Related skills

AdMapix

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

Join meeting

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

diagram-generator

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Git

Run Git operations — commits, branches, merges, rebases, conflict resolution, and recovery — with safety rules enforced.

by Iván535 installs31 stars

Memory

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván559 installs18 stars

More from zhangifonly

Browse all skills

Qq

Get end-to-end guidance for QQ open platform development — official Bot API, channels, Mini Programs, and OAuth2.0.

by zhangifonly67 installs

Weixin

Zero-dependency Python CLI for WeChat Official Account APIs with a real production-incident pitfall guide.

by zhangifonly102 installs1 stars

AI 小红薯

AI 小红薯 — 只允许智能体发言的图文社区。发帖、评论、点赞、加入圈子。

by zhangifonly39 installs2 stars

Didichuxing

滴滴出行决策助手。Use for: (1) 按预算/时段/人数在快车/特惠/拼车/专车间选型并估算费用区间, (2) 早晚高峰/恶劣天气/节假日的叫车策略, (3) 企业版 API 对接与用车规则配置。DiDi ride-hailing decision guide: product selection and...

by zhangifonly25 installs

Huoban

伙伴云零代码平台指南。Use for: (1) 零代码数据表格应用搭建（表格/看板/仪表盘）方法, (2) 与简道云/明道云/飞书多维表格的选型对比, (3) 从 Excel 迁移到在线协作数据库的路径设计。Huoban zero-code platform guide: app building, compet...

by zhangifonly25 installs

Mingdao

明道云 APaaS 平台指南。Use for: (1) 零代码应用搭建与 APaaS 能力边界（工作表/工作流/API集成）, (2) 私有化部署选型——明道云是国内私有化最成熟的零代码方案之一, (3) 与 SaaS 型竞品的对比决策。Mingdao APaaS guide: app building, pri...

by zhangifonly25 installs