ClawHub

Baidu Map Android SDK（百度地图官方安卓 SKills）

v1.0.2

百度地图 Android SDK 集成与开发规范。覆盖地图展示、MapView/BaiduMap 生命周期、定位、标注与覆盖物、POI 检索、路线规划、步骑行导航；输出符合隐私与 AK 配置的 Android 地图方案。在开发 Android 地图应用、集成百度地图 SDK、MapView、路线规划、POI、导航...

2· 355· 3 versions· 0 current· 1 all-time· Updated 7h ago· MIT-0
bybaidu-maps@lbs-bmap

Security Scans

VirusTotalBenignClawScanBenignStatic analysisBenign

Install

openclaw skills install baidu-map-android-sdk

百度地图 Android SDK

目标与边界

  • 目标：在 Android 工程中正确集成百度地图 SDK，并给出符合隐私、AK、坐标系规范的实现方案。
  • 负责：地图展示、MapView 生命周期、覆盖物、POI/路线/地理编码检索、步骑行导航等；以技能内 references 为准。
  • 不负责：服务端逻辑、非百度 SDK、UI 视觉设计。

使用时机

满足其一即启用本技能：

  • 关键词：百度地图 Android、MapView、BaiduMap、AK、路线规划、POI 检索、步骑行导航、BD09、坐标类型
  • 需求类型：地图展示、定位、标注与覆盖物、POI/地点检索、路线规划与画线、步行/骑行实时导航、地理编码

按需加载：先根据需求在 reference.md 中选定文档，再引用对应 references 内容；需求含糊时先向用户澄清再给方案。

必须遵守的规则

  1. 隐私与初始化（v7.5.0+）

    • 调用 SDK 任何接口前必须先调用隐私合规接口，且必须在 SDKInitializer.initialize 之前调用。见 overview.md 隐私合规小节。
    • Application 中：SDKInitializer.initialize(this)；自 4.3.0 起可用 SDKInitializer.setCoordType(CoordType.BD09LL) 或 CoordType.GCJ02。

  2. AK 与配置

    • 使用前需在控制台申请 Android SDK 密钥（AK），应用类型选「Android SDK」，填写包名、SHA1。AK 配置到 AndroidManifest 或 SDKInitializer.setApiKey；包名与签名须与申请一致。见 overview.md。

  3. MapView 生命周期

    • Activity 的 onResume/onPause/onDestroy 中必须分别调用 mMapView.onResume()、mMapView.onPause()、mMapView.onDestroy()。见 mapview.md。

  4. 坐标系

    • 国内默认 BD09LL；可与 GCJ02 通过 SDKInitializer.setCoordType 统一。与定位混用时与定位 SDK 坐标类型一致；转换见 coordinate.md。

  5. 检索与路线

    • 监听先于请求：先 setOnGetPoiSearchResultListener 再 searchNearby 等；先 setOnGetRoutePlanResultListener 再 drivingSearch 等，否则可能拿不到回调。用完后 destroy() 释放实例。

  6. 版本与 API 以工程为准

    • 用户已集成 SDK 时，以其实机/工程内版本为准。若某类或方法不存在（编译报错或依赖中无此符号），提示用户将对应依赖更新到兼容版本后再重试，勿强行写不存在的 API。

  7. 步骑行：按需求区分

    • 路线规划（算路+画线）：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 → 示例片段 → 注意事项。

参考索引

Version tags

latestvk97e2mxgbgwsq3tyqjrcy0w0d584d9he