Gaode_生活服务 skill-PHP中文网

Gaode

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

高德地图 Web API 工具与开发指南。功能：① 使用零依赖 CLI 直接查询地理编码、POI、路线、天气、IP定位；② 实现 WGS‑84、GCJ‑02、BD‑09 坐标系之间的转换并规避常见坑点；③ 提供高德全套 Web Service API 开发指导。

高德地图 Web API Skill

功能概述

高德地图 Web API Skill是一项面向实际任务的技能，主要用于附带零依赖 CLI（ scripts/amap.py ，仅 Python 标准库），agent 可直接替；用户完成地理查询任务：地址↔坐标、找店、算路线、查天气、IP 定位；

核心要点

脚本行为声明：仅请求 restapi.amap.com ，不读写本地文件；
geocode <地址> [城市]；
地址 → 坐标（返回 lng,lat 与规范化地。

使用与执行

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

高德地图 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 典型用法

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

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

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

高频错误码

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

与其他地图平台对比选型

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