| name | baidu-map-android-sdk |
| description | 百度地图 Android SDK 集成与开发规范。覆盖地图展示、MapView/BaiduMap 生命周期、定位、标注与覆盖物、POI 检索、路线规划、步骑行导航；输出符合隐私与 AK 配置的 Android 地图方案。在开发 Android 地图应用、集成百度地图 SDK、MapView、路线规划、POI、导航时使用。 |
| compatibility | Android, Gradle, Android Studio |
百度地图 Android SDK
目标与边界
- 目标：在 Android 工程中正确集成百度地图 SDK，并给出符合隐私、AK、坐标系规范的实现方案。
- 负责：地图展示、MapView 生命周期、覆盖物、POI/路线/地理编码检索、步骑行导航等；以技能内 references 为准。
- 不负责：服务端逻辑、非百度 SDK、UI 视觉设计。
使用时机
满足其一即启用本技能：
- 关键词：百度地图 Android、MapView、BaiduMap、AK、路线规划、POI 检索、步骑行导航、BD09、坐标类型
- 需求类型：地图展示、定位、标注与覆盖物、POI/地点检索、路线规划与画线、步行/骑行实时导航、地理编码
按需加载：先根据需求在 reference.md 中选定文档，再引用对应 references 内容；需求含糊时先向用户澄清再给方案。
必须遵守的规则
-
隐私与初始化（v7.5.0+）
- 调用 SDK 任何接口前必须先调用隐私合规接口，且必须在
SDKInitializer.initialize 之前调用。见 overview.md 隐私合规小节。
- Application 中：
SDKInitializer.initialize(this)；自 4.3.0 起可用 SDKInitializer.setCoordType(CoordType.BD09LL) 或 CoordType.GCJ02。
-
AK 与配置
- 使用前需在控制台申请 Android SDK 密钥（AK），应用类型选「Android SDK」，填写包名、SHA1。AK 配置到 AndroidManifest 或
SDKInitializer.setApiKey；包名与签名须与申请一致。见 overview.md。
-
MapView 生命周期
- Activity 的
onResume/onPause/onDestroy 中必须分别调用 mMapView.onResume()、mMapView.onPause()、mMapView.onDestroy()。见 mapview.md。
-
坐标系
- 国内默认 BD09LL；可与 GCJ02 通过
SDKInitializer.setCoordType 统一。与定位混用时与定位 SDK 坐标类型一致；转换见 coordinate.md。
-
检索与路线
- 监听先于请求：先
setOnGetPoiSearchResultListener 再 searchNearby 等；先 setOnGetRoutePlanResultListener 再 drivingSearch 等，否则可能拿不到回调。用完后 destroy() 释放实例。
-
版本与 API 以工程为准
- 用户已集成 SDK 时，以其实机/工程内版本为准。若某类或方法不存在（编译报错或依赖中无此符号），提示用户将对应依赖更新到兼容版本后再重试，勿强行写不存在的 API。
-
步骑行：按需求区分
- 路线规划（算路+画线）：RoutePlanSearch（驾车/步行/骑行/公交），得到路线后自绘折线或使用开源 Overlay。见 route.md。
- 步骑行实时导航：步行/骑行导航引擎、诱导、TTS、偏航纠偏等，类见 overview.md 与 class-reference.md。
- 二者是不同服务：仅需画线用 route；需实时诱导/TTS 用步骑行导航。给出方案前先按开发者需求选对文档。
输出规范（可评估）
方案结构：需求 → 对应文档 → 配置与依赖 → 关键 API → 示例片段 → 注意事项。
参考索引
