编程

Baidu Map

试用

百度地图 Web 服务 API 工具与 BD-09 坐标系指南。Use for: (1) 用附带的零依赖 CLI 查地理编码/POI/路线并做坐标系转换, (2) BD-09 与 WGS-84/GCJ-02 互转避坑, (3) 百度地图开放平台开发指导。Baidu Maps Web API CLI (zero-d...

它能做什么

百度地图 Web 服务 API 工具与 BD-09 坐标系指南。Use for: (1) 用附带的零依赖 CLI 查地理编码/POI/路线并做坐标系转换, (2) BD-09 与 WGS-84/GCJ-02 互转避坑, (3) 百度地图开放平台开发指导。Baidu Maps Web API CLI (zero-dependency) for geocoding, POI, routing and coordinate conversion, plus a BD-09 coordinate-system guide.

技能文档

百度地图 Web API Skill

附带零依赖 CLI(scripts/bmap.py,仅 Python 标准库)。百度地图的 独有能力:官方坐标转换接口(WGS-84/GCJ-02 → BD-09)和丰富的 POI 检索数据。

快速开始

# lbsyun.baidu.com 免费申请 AK,应用类型选 "服务端"
export BMAP_AK=你的ak

python3 scripts/bmap.py geocode "北京市海淀区上地十街10号"
python3 scripts/bmap.py around 39.915,116.404 咖啡 1000
python3 scripts/bmap.py convert 116.404,39.915 1 5   # GPS坐标转百度坐标

脚本行为声明:仅请求 api.map.baidu.com,不读写本地文件。

命令手册

命令作用
geocode <地址> [城市]地址 → 坐标(返回 BD-09
regeo 坐标 → 结构化地址
search <关键词> <城市>POI 城市内检索
around <关键词> [半径米]POI 周边检索
driving / walking <起点> <终点>轻量路线规划(directionlite)
convert 坐标转换:1=WGS84 3=GCJ-02 5=BD-09
call k=v ...通用兜底:调任意接口

⚠️ 两个坐标陷阱(跨平台翻车重灾区)

  1. 顺序:百度接口的 location 参数是 纬度,经度(lat,lng), 但 convert 接口的 coords 是 经度,纬度(lng,lat)——同平台内都不统一
  2. 坐标系:百度全系输入输出默认 BD-09。把高德/腾讯的 GCJ-02 坐标 直接传入会偏移几百米;把 GPS 原始坐标传入偏移更大。 进百度先 convert,出百度无官方反向接口(社区近似算法有精度损失, 所以数据库存坐标建议存 GCJ-02 或 WGS-84,展示层再转 BD-09

Agent 典型用法

  1. 坐标系清洗:一批 GPS 轨迹要在百度地图展示 → 循环 convert 1 5
  2. 位置偏移排障:用户反馈"标注偏了几百米" → 十有八九是坐标系混用, 按上面陷阱清单排查
  3. 找地点/周边分析search/around 拿 POI 数据,按距离评分整理
  4. 批量地址入库geocode 规范化地址,注意存储坐标系的选择(见上)

高频错误码(实测)

status含义处理
200AK 不存在检查 AK 拼写(实测拼错返回的就是它,不是 210)
210AK 校验失败服务端 AK 配置了 IP 白名单但请求 IP 不在其中
302天配额超限免费版按接口独立计额,次日重置;量大需企业认证
401/402并发超限加限速重试

与其他平台对比

场景建议
微信小程序腾讯地图(见 tencent-map skill)
导航/车机生态高德(见 gaode skill)
需要街景全景百度(独有全景 API,用 call 调 /panorama/v2)
POI 数据对比高德/百度各有覆盖强区,重要项目两家实测对比

本 skill 不做什么

  • 不含 JavaScript API(前端渲染)细节,只覆盖服务端 Web API
  • BD-09 → 其他坐标系的"逆转换"官方不支持,本 skill 不提供 近似算法实现(有精度损失,需要时明确告知用户风险)

相关技能

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

29 次安装

腾讯位置服务 WebService API 工具与微信小程序 LBS 指南。Use for: (1) 用附带的零依赖 CLI 查地理编码/POI/路线/IP定位, (2) 微信小程序地图开发(腾讯地图是微信官方推荐), (3) GCJ-02 坐标系避坑。Tencent Maps WebService API CL...

35 次安装

零依赖 Python 命令行直接调公众号 API,附真实生产事故踩坑清单

100 次安装1 星标

Turn a Bilibili video URL or BV number into a human-like XMind mind map. Use when the user wants to collect subtitles, comments, AI summary, and transcript f...

28 次安装1 星标

Guides visits, relocation, work, and daily life in Beijing: attractions, neighborhoods, rent, visas, transport, food, and the local app ecosystem. Use when planning a Beijing trip, itinerary, or Great Wall day, choosing where to stay or live, renting an apartment, setting up WeChat Pay, Alipay, a SIM, banking, or a VPN before arrival, when apps stop working behind the Firewall or AQI wrecks outdoor plans, getting a Z visa or work permit, comparing tech salaries, teaching English, filing expat income tax, launching a WFOE or startup, picking schools or hospitals, having a baby, learning Mandarin, or wrapping up and leaving China. Not for the rest of China — pair with the china skill for other cities.

27 次安装

企业微信群机器人工具与服务端 API 指南。Use for: (1) 用附带的零依赖 CLI 向企微群发通知——文本/markdown/图片/文件, (2) CI/监控/日报自动化推送, (3) 企业微信服务端 API(通讯录/应用消息/客户联系)开发指导。WeCom (WeChat Work) group-ro...

27 次安装