百度地图开放平台
更新时间: 2026/09/23 18:01
更新日志
v2.1(2026-09)

变更

  • Place API 全面升级 V3:search 移除 /place/v2/search,改为 /place/v3/around(周边检索)与 /place/v3/region(城市检索),按是否传 region 自动分派;方法名与回调签名不变。

  • search:query 变为必选(移除默认关键词“生活服务$美食&酒店”);未传 radius 由 SDK 默认 2000 改为服务端默认 1000;新增 region / tag / type / radius_limit / is_light_version / extensions_adcode / center 透传。

  • suggestion:升级为 /place/v3/suggestion;region 变为必选(region/bounds/location 三选一);新增 location 排序参考点;返回元素不再包含 cityid,如需城市编码请改用 city / adcode(SDK 已将 V3 的 results 归一为 result,契约不变)。

  • 请求参数最小化:未显式传入的参数不再代填默认值(radius / page_size / page_num / scope / output / tactics / extensions_road / extensions_town / language 等),与官方文档一致,由服务端按默认处理;仅保留必要默认 output=json(地理编码/逆编码)与 extensions_poi=1。

  • 路线规划、天气、静态图无 V3 版本,保持不变。

升级指南(v2.0 → v2.1)
Place API 迁移至 V3 并做了请求参数最小化,方法名与回调签名不变。以下为必须确认/修改的调用:

调用形态v2 行为v2.1 行为处理

suggestion({ query }) 未传 region

SDK 默认城市“全国”

服务端报 status:2(region/bounds/location 不能全空)

调用处补 region(城市名/区县名)

search({ location }) 未传 query

SDK 默认关键词“生活服务$美食&酒店”

服务端报参数错误

调用处补 query

行为变化:未传 radius 时周边检索默认半径由 2000 米变为服务端默认 1000 米;V3 排序更贴近百度地图 App 推荐,结果顺序可能与 v2 不同;suggestion 返回不再含 cityid,如需城市编码改用 city / adcode。
迁移检查清单

  1. 全局搜索 suggestion( 调用:确认均传 region;

  2. 全局搜索 search( 调用:确认均传 query;周边检索场景评估是否需显式 radius;

  3. 对结果顺序敏感的业务(如订单、推荐位)升级后与 v2 对拍一次。

v2.0(2026-09)

新增接口

  • 路线规划:driving / walking / transit / riding,返回规范化 routes 与主方案折线 wxPolylineData。

  • 静态图:staticMap 支持全参数(markers / labels / paths 及各自样式、bbox 取景、scale 高清图),本地拼装 URL,不发起网络请求。

  • 海外天气:weatherAbroad,仅接受"经度,纬度",不支持城市名。

修复与变更

  • 天气服务恢复可用:原 telematics 老接口已下线,改用新版天气接口。

  • regeocoding 规范化为 reverseGeocoding,旧方法名保留为兼容别名。

  • 失败回调补充结构化字段 message 与 rawMessage,rawMessage 保留完整原文不截断。

  • 坐标系统一为 gcj02;公交路线规划自动换算为百度坐标后请求。

工程

  • 统一请求管线:定位 → 参数组装 → 请求 → 错误码映射 → 回调。

  • 构建链改为 babel 转 ES5 + terser 压缩,产物输出至 dist/,推荐引入 dist/bmap-wx.min.js。

  • 补充 index.d.ts 完整类型声明。

  • Demo 升级为产品化示例:周边探索、多方案路线规划、静态图取景联动、天气主题与国际城市切换。

v2.0 对部分接口的参数与返回值语义有调整,升级时请对照各接口文档核对;request 合法域名要求不变。
v1.1(2019-07-03)
  • 新增 geocoding 接口,支持地址信息到经纬度的转换。

v1.0(2017)
  • 2017-01-11 发布 v1.0,支持 search、suggestion、regeocoding、weather 四种接口。

  • 2017-02-15 修复 location 参数无效的问题。

上一篇

类参考和DEMO

下一篇

相关下载
本篇文章对您是否有帮助?