需求评审定了要加门店定位和导航,会后 leader 就一句:接百度地图sdk。打开文档发现 Android、iOS、JS API、Web 服务好几个入口,先分清产品线再动手,不然 AK 申请了还得重来。

先选对产品线

手机 App 用 Android 或 iOS 原生 SDK;网页展示用 JS API,引入脚本加 AK 就能出地图,注意容器高度要给足,父级没高度地图显示空白;后端算距离、做地理编码走 Web 服务 API,不需要前端;只要一张地图截图的话有静态图 API,拼参数直接返回图片。选错线,后面申请的权限和接口全对不上。

接入的固定流程

注册开发者账号,进控制台创建应用,拿到 AK 密钥。Android 要绑定应用包名和签名的 SHA1,发布版和调试版都填上;签名对不上时定位和检索直接报 key 校验错误,地图能渲染但数据全空,新手常卡在这。然后按文档把依赖引进工程,注意定位和地图是两个包别漏引,Android 在 Application 里完成初始化再用 MapView。

常用能力和配额

地图显示、定位、POI 周边检索、驾车步行骑行路线规划、地理编码、离线地图,这些是用得最多的模块,离线地图一般只在原生 SDK 上提供。个人开发者有免费配额,跑通和小项目一般够用,上线后进控制台盯调用量,超了按量计费。AK 记得绑包名或域名,别提交到公开仓库,被扫到盗刷配额是常事,部分行业类目还要提交资质审核。

实际建议:网页展示门店位置,JS API 半天能上线;要深度定位导航再上原生 SDK,两边的评估工作量别混着算。