变更
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 并做了请求参数最小化,方法名与回调签名不变。以下为必须确认/修改的调用:
行为变化:未传 radius 时周边检索默认半径由 2000 米变为服务端默认 1000 米;V3 排序更贴近百度地图 App 推荐,结果顺序可能与 v2 不同;suggestion 返回不再含 cityid,如需城市编码改用 city / adcode。
迁移检查清单
全局搜索 suggestion( 调用:确认均传 region;
全局搜索 search( 调用:确认均传 query;周边检索场景评估是否需显式 radius;
对结果顺序敏感的业务(如订单、推荐位)升级后与 v2 对拍一次。
新增接口
路线规划: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 升级为产品化示例:周边探索、多方案路线规划、静态图取景联动、天气主题与国际城市切换。
新增 geocoding 接口,支持地址信息到经纬度的转换。
2017-01-11 发布 v1.0,支持 search、suggestion、regeocoding、weather 四种接口。
2017-02-15 修复 location 参数无效的问题。
上一篇
下一篇