高德地图 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 返回未来 4 天预报 |
ip [地址] |
IP 定位到城市 |
call |
通用兜底：调任意 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 |
本 skill 不做什么
- 不提供爬取高德网页端数据的方法（用官方 API，免费额度对个人够用）
- 静态地图、轨迹纠偏、地理围栏等低频接口未封装命令，用
call兜底， 参数以官方文档 lbs.amap.com/api/webservice/summary 为准
相关专题
本专题聚焦LLVM自定义Pass开发，整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。
2026.09.30
0
10
本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式，涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。
2026.09.30
0
14
本专题整理LLVM IR的核心概念，包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法，帮助新手理解LLVM编译流程中的关键层。
2026.09.30
0
12
需要把 PDF 页面用于上传、预览、分享或图片归档时，PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程，帮助用户稳定完成 PDF 图片化处理。
2026.09.30
0
26
PixTV专题整理AI视频与视觉内容创作相关功能使用教程，涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能，帮助用户快速掌握PixTV从创意到成片的完整制作方法。
2026.09.29
0
15
本专题围绕Buffalo框架数据库开发，讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。
2026.09.23
0
15
本专题讲解Buffalo框架路由与请求处理机制，涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。
2026.09.23
0
15
本专题整理Buffalo框架入门内容，涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查，帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。
2026.09.23
0
15
本专题介绍通过conanfile.py创建软件包的方法，讲解包名、版本、依赖和构建设置等基础信息，以及source、build、package、package_info等常用方法的作用及编写思路。
2026.09.22
0
12
热门下载
相关下载
精品课程
共6课时 | 54.6万人学习
共89课时 | 133.4万人学习
共49课时 | 82.2万人学习
