百度地图 Web 服务 API工具与 BD-09 坐标系指南。使用场景：①使用零依赖的 CLI 进行地理编码、POI 查询、路线规划并完成坐标系转换；②实现 BD-09 与 WGS‑84/GCJ‑02之间的相互转换，避免常见坑；③提供百度地图开放平台开发指导。Baidu Maps Web API CLI（零依赖）
百度地图 Web API Skill
功能概述
百度地图 Web API Skill是一项面向实际任务的技能，主要用于附带零依赖 CLI（ scripts/bmap.py ，仅 Python 标准库）；百度地图的；
核心要点
- 独有能力： 官方坐标转换接口 （WGS-84/GCJ-02 → BD-09）和丰富的；
- POI 检索数据；
- 脚本行为声明：仅请求 api.map.baidu.com ，不读写本地文件；
使用与执行
geocode <地址> [城市]；地址 → 坐标（ 返回。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
结果检查与注意事项
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
百度地图 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 |
通用兜底：调任意接口 |
⚠️ 两个坐标陷阱（跨平台翻车重灾区）：
- 顺序：百度接口的 location 参数是
纬度,经度（lat,lng）， 但 convert 接口的 coords 是经度,纬度（lng,lat）——同平台内都不统一 - 坐标系：百度全系输入输出默认 BD-09。把高德/腾讯的 GCJ-02 坐标
直接传入会偏移几百米；把 GPS 原始坐标传入偏移更大。
进百度先
convert，出百度无官方反向接口（社区近似算法有精度损失， 所以数据库存坐标建议存 GCJ-02 或 WGS-84，展示层再转 BD-09）
Agent 典型用法
- 坐标系清洗：一批 GPS 轨迹要在百度地图展示 → 循环
convert 1 5 - 位置偏移排障：用户反馈"标注偏了几百米" → 十有八九是坐标系混用， 按上面陷阱清单排查
- 找地点/周边分析：
search/around拿 POI 数据，按距离评分整理 - 批量地址入库：
geocode规范化地址，注意存储坐标系的选择（见上）
高频错误码（实测）
| status | 含义 | 处理 |
|---|---|---|
| 200 | AK 不存在 | 检查 AK 拼写（实测拼错返回的就是它，不是 210） |
| 210 | AK 校验失败 | 服务端 AK 配置了 IP 白名单但请求 IP 不在其中 |
| 302 | 天配额超限 | 免费版按接口独立计额，次日重置；量大需企业认证 |
| 401/402 | 并发超限 | 加限速重试 |
与其他平台对比
| 场景 | 建议 |
|---|---|
| 微信小程序 | 腾讯地图（见 tencent-map skill） |
| 导航/车机生态 | 高德（见 gaode skill） |
| 需要街景全景 | 百度（独有全景 API，用 call 调 /panorama/v2） |
| POI 数据对比 | 高德/百度各有覆盖强区，重要项目两家实测对比 |
本 skill 不做什么
- 不含 JavaScript API（前端渲染）细节，只覆盖服务端 Web API
- BD-09 → 其他坐标系的"逆转换"官方不支持，本 skill 不提供 近似算法实现（有精度损失，需要时明确告知用户风险）
相关专题
本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集，涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案，助你快速定位并解决Uvicorn运行中的各类问题。
2026.11.02
0
14
本专题汇总了Uvicorn使用教程与启动运行指南，涵盖其作为Python ASGI服务器的定位与特点，以及命令行启动（uvicorn main:app --reload）、参数配置（host/port/workers）、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧，助你快速掌握Uvicorn的运行与配置。
2026.11.02
0
17
本专题汇总了Uvicorn的安装配置教程与部署指南，涵盖通过pip安装Uvicorn、启动FastAPI/Starlette应用、开发模式热重载（--reload）及多进程工作模式配置等核心操作。同时整理了结合Gunicorn的生产部署方案、HTTPS与反向代理配置及性能调优技巧，助你快速完成Uvicorn服务的安装与上线部署。
2026.11.02
0
17
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章，帮助读者完成上线流程。
2026.10.28
0
16
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章，帮助读者完成从初始化到日常开发的配置。
2026.10.28
0
15
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章，帮助读者理解各文件夹的用途与引用方式。
2026.10.28
0
10
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.6万人学习
