核心用法
百度地图Android SDK是面向Android平台的官方地图开发工具包，主要用于集成地图展示、定位服务、POI检索、路线规划与步骑行导航等功能。
初始化流程：必须在Application.onCreate中先调用隐私合规接口（v7.5.0+），再执行SDKInitializer.initialize(context)；通过SDKInitializer.setApiKey或AndroidManifest配置AK密钥；可选设置坐标系（BD09LL/GCJ02）。
MapView生命周期：Activity的onResume/onPause/onDestroy必须同步调用MapView对应方法，防止内存泄漏与渲染异常。
核心功能模块：
- 地图展示：通过MapView/BaiduMap控制地图类型、层级、手势交互
- 定位：集成定位SDK，支持多种定位模式与自定义图标
- 覆盖物：Marker点标注、Polyline折线、Polygon多边形等自定义绘制
- POI检索：周边搜索、关键词检索、地理编码/逆编码，需先设置监听器再发起请求
- 路线规划：驾车/步行/骑行/公交路径计算，区分纯算路画线与实时导航两种场景
- 步骑行导航：独立引擎提供实时诱导、TTS语音、偏航纠偏能力
显著优点
- 官方权威：百度官方维护，API稳定性与地图数据更新有保障
- 功能完备：覆盖从基础展示到复杂导航的全链路能力
- 国内合规：内置隐私合规接口，适配中国网络安全法要求
- 坐标系灵活：支持BD09LL（默认）与GCJ02切换，兼容不同数据源
潜在缺点与局限性
- 生态封闭：仅支持百度地图生态，无法无缝切换高德/谷歌等竞品
- 版本碎片化：历史版本API差异较大，需严格匹配工程实际版本
- 隐私门槛高：v7.5.0后强制隐私合规调用，遗漏将导致SDK异常
- 监听顺序敏感：检索/路线类接口必须先设监听器再请求，否则回调丢失
- AK绑定严格：包名与SHA1签名必须一致，配置错误直接鉴权失败
适合人群
- 需要快速集成地图能力的Android应用开发者
- 构建LBS位置服务、O2O、出行类App的技术团队
- 需国内合规方案且接受百度生态绑定的企业项目
常规风险
| 风险项 | 说明 |
|--------|------|
| 隐私合规缺失 | 未在initialize前调用隐私接口导致SDK初始化失败 |
| AK配置错误 | 包名/SHA1/密钥不匹配引发鉴权失败（错误码4/5） |
| 生命周期管理不当 | MapView未同步Activity生命周期导致崩溃或内存泄漏 |
| 坐标系混淆 | BD09/GCJ02/WGS84混用导致位置偏移 |
| 版本API不存在 | 引用高版本特有API在低版本工程中编译失败 |
| 检索监听遗漏 | 未setListener直接search导致结果无法接收 |
开发时需严格遵循references目录下的专项文档，按需组合功能模块，避免跨版本API混用。