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

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

Security Scan

This is an instruction-only documentation skill for integrating the Baidu Map Android SDK; it does not request credentials, install code, or perform unexpected actions and appears consistent with its stated purpose.

Purpose & Capability

The name and description match the provided files: comprehensive integration and implementation guidance for Baidu Map Android SDK. The skill requests no environment variables, binaries, or installs, which is appropriate for a documentation-only skill.

Instruction Scope

SKILL.md and the referenced documents limit actions to providing integration guidance, API usage, lifecycle rules, Gradle configuration, and privacy/AK handling. There are no instructions to read unrelated system files, access credentials, call arbitrary endpoints, or exfiltrate data. References to commands (e.g., keytool) are explanatory for developers, not runtime agent actions.

Install Mechanism

No install spec and no code files to execute. Instruction-only skills are lowest-risk in install mechanism; nothing is downloaded or written to disk by the skill itself.

Credentials

The skill declares no required environment variables, no primary credential, and no config paths. The documentation explains how developers should supply an AK in their AndroidManifest or code, which is expected and proportionate to the skill's purpose.

Persistence & Privilege

Skill does not request persistent 'always' inclusion or system privileges. It is user-invocable and does not instruct modifying other skills or global agent settings.

Assessment

This skill is a collection of local documentation and examples for integrating Baidu Map Android SDK — it does not itself perform network calls or request secrets. Before using the generated code in a real app: (1) do not paste real AKs or private keys into public places; (2) follow the docs' privacy-requirement: call the privacy API before SDK initialize and obtain user consent as needed; (3) verify Gradle dependency versions and get the SDK from official sources (Maven Central or the vendor) rather than untrusted mirrors; (4) ensure your package name and SHA1 match the AK configuration in Baidu's console; (5) when the agent generates code that runs on your environment, review it manually (especially manifest entries, permissions, services, and any suggested keystore commands).

百度地图 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 → 示例片段 → 注意事项。

参考索引

• 按需求选文档与常见组合：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