核心用法
本技能为百度地图 Android SDK 的官方开发规范文档，系统指导 Android 开发者完成地图功能的完整集成。核心流程包括：
1. 环境配置与初始化：通过 Gradle 引入 SDK 依赖，在 Application 中配置隐私合规接口（v7.5.0+ 必须在 SDKInitializer.initialize 之前调用），设置 AK（API Key）及坐标系类型（BD09LL 或 GCJ02）。
2. 地图容器管理：使用 MapView 作为地图容器，严格遵循生命周期绑定——在 Activity 的 onResume/onPause/onDestroy 中同步调用对应方法，避免内存泄漏。
3. 核心功能开发：
- 基础展示：通过
BaiduMap控制地图类型、层级、手势交互 - 定位集成：结合定位 SDK 实现蓝点展示、定位模式切换
- 覆盖物系统：Marker 点标记、Polyline 折线、Polygon 多边形等图形绘制
- 检索服务：POI 周边/城市/室内检索、地理编码/逆地理编码
- 路线规划：驾车/步行/骑行/公交多模态算路，支持自绘或使用开源 Overlay
- 步骑行导航：实时导航引擎、诱导播报、TTS 语音、偏航纠偏
4. 关键编码规范：检索与路线请求前必须先设置监听器；使用完毕后主动调用 destroy() 释放实例；坐标系混用时确保与定位 SDK 保持一致。
显著优点
- 权威性高：来自百度官方技术文档，API 定义与版本演进实时同步
- 覆盖完整：从基础地图展示到复杂导航场景，形成端到端能力闭环
- 合规先行：明确隐私合规调用时序与 AK 配置规范，降低上架审核风险
- 工程实践导向：提供 MapView 生命周期、依赖冲突、混淆规则等落地细节
- 多坐标系支持：BD09/GCJ02 灵活切换，适配不同业务场景
潜在局限
- 平台限定：仅覆盖 Android 端，iOS/HarmonyOS/跨平台需参考其他文档
- 服务端边界：不涉及后端逻辑实现，纯客户端 SDK 使用指南
- 版本敏感：SDK 版本迭代可能导致 API 变更，需以工程实机版本为准
- UI 约束：仅提供交互约定（如 Logo 位置、选点规范），视觉设计需自行实现
适合人群
- Android 应用开发者需集成地图展示、定位、检索、导航功能
- 正在迁移或升级百度地图 SDK 版本的存量项目维护者
- 需处理隐私合规、AK 鉴权、坐标转换等特定技术问题的工程师
- 步骑行导航、O2O 配送、出行服务等垂直场景开发者
常规风险
| 风险类别 | 具体表现 | 规避建议 |
|---------|---------|---------|
| 隐私合规 | 未在初始化前调用隐私接口导致 SDK 功能受限 | 严格遵循 `隐私 → initialize → 其他接口` 时序 |
| AK 鉴权 | 包名/签名与申请不一致引发 230 错误 | 核对 AndroidManifest 与控制台配置的一致性 |
| 生命周期 | MapView 未正确销毁导致内存泄漏 | Activity 销毁时务必调用 `mMapView.onDestroy()` |
| 监听器顺序 | 先请求后监听导致结果回调丢失 | 始终 `setListener` 先于 `search`/`route` 调用 |
| 版本兼容 | 引用不存在的新版 API 导致编译失败 | 以用户工程实际依赖版本为准，提示升级而非硬编码 |
| 坐标偏差 | BD09/GCJ02/WGS84 混用导致位置偏移 | 统一通过 `SDKInitializer.setCoordType` 设定 |
文档结构
技能内包含 14 份 reference 文档，按需求场景索引：集成配置、地图容器、定位、标注、覆盖物、检索、路线、坐标转换、工具类、错误码、类速查及 UI 规范，支持按需组合调用。