← 返回 Skills 市场

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

Name: Baidu Map Android SDK（百度地图官方安卓 SKills）
Author: lbs-bmap

作者 baidu-maps · GitHub ↗ · v1.0.2 · MIT-0

cross-platform ✓ 安全检测通过

343

总下载

当前安装

版本数

在 OpenClaw 中安装

/install baidu-map-android-sdk

功能描述

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

使用说明 (SKILL.md)

百度地图 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

安全使用建议

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).

功能分析

Type: OpenClaw Skill Name: baidu-map-android-sdk Version: 1.0.2 The skill bundle is a comprehensive and legitimate documentation set for integrating the Baidu Map Android SDK into applications. It covers standard development procedures such as Gradle dependency management, AndroidManifest configuration, privacy compliance (v7.5.0+), and API usage for mapping, POI search, and navigation. There is no evidence of malicious intent, data exfiltration, or harmful prompt injection; all instructions and references (including development mirrors in gradle.md) are aligned with the stated purpose of assisting developers with Baidu's LBS services.

能力标签

crypto

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install baidu-map-android-sdk
安装完成后，直接呼叫该 Skill 的名称或使用 /baidu-map-android-sdk 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.2

- 新增 _meta.json 文件以补充元数据。 - 其余内容无变化。

v1.0.1

- No changes detected in files for this version. - No updates to functionality, documentation, or configuration.

v1.0.0

baidu-map-android-sdk 1.0.0 初始版本发布 - 提供百度地图 Android SDK 集成与开发规范，覆盖地图展示、定位、标注与覆盖物、POI 检索、路线规划、步骑行导航等关键场景 - 规范隐私合规、AK 配置、MapView 生命周期、坐标系等使用规则 - 指定开发流程：需求匹配 → 参考文档 → 配置依赖 → 关键 API → 示例 → 注意事项 - 提供各功能模块详细文档索引，便于按需查找和组合

元数据

Slug baidu-map-android-sdk

版本 1.0.2

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 3

常见问题