- 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 用步骑行导航。给出方案前先按开发者需求选对文档。
输出规范（可评估）
- 可落地：含具体类名、方法、调用顺序与必要配置（AndroidManifest、Application、AK、隐私）。
- 可验证：隐私与 AK 明确；检索/路线监听顺序正确；若涉及定位/鉴权失败，方案可指向 location.md 或 project-config.md 的排查项。
- 可组合：按 reference.md 选文档与常见组合。无特殊要求时界面与交互遵循 ui-standards.md。
方案结构：需求 → 对应文档 → 配置与依赖 → 关键 API → 示例片段 → 注意事项。
参考索引
- 按需求选文档与常见组合：reference.md
- Gradle 集成（依赖、冲突、NDK、环境与国内镜像）：gradle.md
- AndroidManifest、主题、混淆、集成经验与常见问题：project-config.md
- 集成、AK、隐私、生命周期、核心类：overview.md
- 地图容器、类型、层级、方法交互：mapview.md
- 显示定位、定位模式、自定义图标：location.md
- 点标记、Marker 属性与事件：marker.md
- 折线、多边形、Polyline 属性：overlays.md
- POI、地理编码、逆地理：search.md
- 路线规划与 Overlay：route.md
- 坐标转换与坐标系：coordinate.md
- 距离/面积、点与图形关系、调起地图、短地址分享：tools.md
- 错误码：errorcode.md
- 类与包速查：class-reference.md
- 检索/路线/选点/弹窗/Logo 等 UI 与交互约定：ui-standards.md