Baidu Map Android SDK(百度地图官方安卓 SKills)
百度地图 Android SDK 集成与开发规范。覆盖地图展示、MapView/BaiduMap 生命周期、定位、标注与覆盖物、POI 检索、路线规划、步骑行导航;输出符合隐私与 AK 配置的 Android 地图方案。在开发 Android 地图应用、集成百度地图 SDK、MapView、路线规划、POI、导航... Skill: Baidu Map Android SDK(百度地图官方安卓 SKills) Owner: baidu-maps Summary: 百度地图 Android SDK 集成与开发规范。覆盖地图展示、MapView/BaiduMap 生命周期、定位、标注与覆盖物、POI 检索、路线规划、步骑行导航;输出符合隐私与 AK 配置的 Android 地图方案。在开发 Android 地图应用、集成百度地图 SDK、MapView、路线规划、POI、导航... Tags: latest:1.0.3 Version history: v1.0.3 | 2026-06-01T03:41:59.477Z | user - Removed sample files: _meta.json, skill-card.md - No changes to core logic or documentation in SKILL.md v1.
Rank
62
Safety
84
Downloads
1.4k
Updated
Oct 10, 2026
Version
1.0.3
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.4K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.0.3release · observed Jun 1, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s178nge8tvzzhnan6cc08q0ech84dmtm:baidu-map-android-sdk- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-android-sdk/snapshot"
Documentation
CLAWHUB
127,460 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- 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/reference.md) 中选定文档,再引用对应 references 内容;需求含糊时先向用户澄清**再给方案**。 ## 必须遵守的规则 1. **隐私与初始化(v7.5.0+)** - 调用 SDK 任何接口前必须先调用隐私合规接口,且**必须在 `SDKInitializer.initialize` 之前**调用。见 [overview.md](references/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](references/overview.md)。 3. **MapView 生命周期** - Activity 的 `onResume`/`onPause`/`onDestroy` 中必须分别调用 `mMapView.onResume()`、`mMapView.onPause()`、`mMapView.onDestroy()`。见 [mapview.md](references/mapview.md)。 4. **坐标系** - 国内默认 BD09LL;可与 GCJ02 通过 `SDKInitializer.setCoordType` 统一。与定位混用时与定位 SDK 坐标类型一致;转换见 [coordinate.md](references/coordinate.md)。 5. **检索与路线** - **监听先于请求**:先 `setOnGetPoiSearchResultListener` 再 `searchNearby` 等;先 `setOnGetRoutePlanResultListener` 再 `drivingSearch` 等,否则可能拿不到回调。用完后 `destroy()` 释放实例。 6. **版本与 API 以工程为准** - 用户已集成 SDK 时,以其实机/工程内版本为准。若某类或方法**不存在**(编译报错或依赖中无此符号),**提示用户将对应依赖更新到兼容版本**后再重试,勿强行写不存在的 API。 7. **步骑行:按需求区分** - **路线规划(算路+画线)**:RoutePlanSearch(驾车/步行/骑行/公交),得到路线后自绘折线或使用开源 Overlay。见 [route.md](references/route.md)。 - **步骑行实时导航**:步行/骑行导航引擎、诱导、TTS、偏航纠偏等,类见 [overview.md](references/overview.md) 与 [class-reference.md](references/class-reference.md)。 - 二者是**不同服务**:仅需画线用 route;需实时诱导/TTS 用步骑行导航。给出方案前先按开发者需求选对文档。 ## 输出规范(可评估) - **可落地**:含具体类名、方法、调用顺序与必要配置(AndroidManifest、Application、AK、隐私)。 - **可验证**:隐私与 AK 明确;检索/路线监听顺序正确;若涉及定位/鉴权失败,方案可指向 [location.md](references/location.md) 或 [project-config.md](references/project-config.md) 的排查项。 - **可组合**:按 [reference.md](references/reference.md) 选文档与常见组合。无特殊要求时界面与交互遵循 [ui-standards.md](references/ui-standards.md)。 方案结构:需求 → 对应文档 → 配置与依赖 → 关键 API → 示例片段 → 注意事项。 ## 参考索引 - 按需求选文档与常见组合:[reference.md](references/reference.md) - Gradle 集成(依赖、冲突、NDK、环境与国内镜像):[gradle.md](references/gradle.md) - AndroidManifest、主题、混淆、集成经验与常见问题:[project-config.md](references/project-config.md) - 集成、AK、隐私、生命周期、核心类:[overview.md](references/overview.md) - 地图容器、类型、层级、方法交互:[mapview.md](references/mapview.md) - 显示定位、定位模式、自定义图标:[location.md](references/location.md) - 点标记、Marker 属性与事件:[marker.md](references/marker.md) - 折线、多边形、Polyline 属性:[overlays.md](references/overlays.
_meta.json
{
"ownerId": "kn778b6bf766ym71fdvrc5yvg98319rv",
"slug": "baidu-map-android-sdk",
"version": "1.0.3",
"publishedAt": 1780285319477
}references/class-reference.md
# 类与包速查 以下为百度地图 Android SDK 常用类与包,便于按能力查找。具体方法、参数以工程所集成的 SDK 版本为准。 ## 初始化与配置 - `com.baidu.mapapi.SDKInitializer`:initialize、setApiKey、setCoordType、setAgreePrivacy、getCoordType - `com.baidu.mapapi.CoordType`:BD09LL、GCJ02 ## 地图容器与控制器 - `com.baidu.mapapi.map.MapView`、`BaiduMap`、`getMap()`、onResume/onPause/onDestroy - `com.baidu.mapapi.map.SupportMapFragment`、`TextureMapView`、`TextureSupportMapFragment` - `com.baidu.mapapi.map.BaiduMapOptions`:mapType、compassEnable、zoomGesturesEnabled 等 ## 地图状态与视野 - `MapStatus`、`MapStatus.Builder`、`MapStatusUpdate`、`MapStatusUpdateFactory` - `MapStatusUpdateFactory.zoomTo/zoomIn/zoomOut/zoomBy`、`newLatLng`、`newLatLngBounds`、`newMapStatus` - `BaiduMap`:setMapStatus、animateMapStatus、setMapType、setTrafficEnabled、setBaiduHeatMapEnabled、setViewPadding、showMapPoi、setPoiTagEnable、setMapBackgroundColor ## 几何与覆盖物基础 - `com.baidu.mapapi.model.LatLng`、`LatLngBounds`、`LatLngBounds.Builder` - `com.baidu.mapapi.map.BitmapDescriptor`、`BitmapDescriptorFactory` - `OverlayOptions`、`Overlay`、`BaiduMap.addOverlay`、`clear` - `Marker`、`MarkerOptions`:position、icon、draggable、flat、alpha、animateType、titleOptions、isJoinCollision、poiCollided 等 - `Polyline`、`PolylineOptions`:points、width、color、dottedLine、colorsValues、customTextureList、textureIndex、isGeodesic、isGradient、bloomType 等 - `Polygon`、`PolygonOptions` ## 事件监听 - `BaiduMap.OnMarkerClickListener`、`OnMarkerDragListener`、`OnPolylineClickListener`、`OnMapLoadedCallback` ## 定位 - `com.baidu.location.LocationClient`、`LocationClientOption`、`BDAbstractLocationListener`、`BDLocation` - `com.baidu.mapapi.map.MyLocationData`、`MyLocationConfiguration`、`LocationMode`(NORMAL、FOLLOWING、COMPASS) - `BaiduMap`:setMyLocationEnabled、setMyLocationData、setMyLocationConfiguration ## 检索 - `com.baidu.mapapi.search.poi.PoiSearch`、`PoiSearch.newInstance()`、setOnGetPoiSearchResultListener、searchInCity、searchNearby、searchInBound、searchPoiDetail、destroy - `PoiCitySearchOption`、`PoiNearbySearchOption`、`PoiBoundSearchOption`、`PoiDetailSearchOption` - `OnGetPoiSearchResultListener`、`PoiResult`、`PoiDetailSearchResult`、`PoiInfo` - `com.baidu.mapapi.search.geocode.GeoCoder`、`GeoCodeOption`、`ReverseGeoCodeOption`、`OnGetGeoCoderResultListener`、`GeoCodeResult`、`ReverseGeoCodeResult` ## 路线规划 - `com.baidu.mapapi.search.route.RoutePlanSearch`、`RoutePlanSearch.newInstance()`、setOnGetRoutePlanResultListener、drivingSearch、walkingSearch、ridingSearch、transitSearch、destroy - `PlanNode`、`PlanNode.withCityNameAndPlaceName`、`PlanNode.withLocation` - `DrivingRoutePlanOption`、`WalkingRoutePlanOption`、`BikingRoutePlanOption`、`TransitRoutePlanOption` - `OnGetRoutePlanResultListener`、`DrivingRouteResult`、`WalkingRouteResult`、`BikingRouteResult`、`TransitRouteResult`、`getRouteLines()` - 开源 Overlay:DrivingRouteOverlay、WalkingRouteOverlay、BikingRouteOverlay、TransitRouteOverlay、PoiOverlay(overlayutil 包) ## 步骑行导航(实时诱导) - WalkNavigateHelper、BikeNavigateHelper、WalkNaviLaunchParam、BikeNaviLaunchParam、initNaviEngine、routePlanWithParams、on
references/coordinate.md
# 坐标转换与坐标系
## 坐标系类型
- **WGS84**:GPS 常用大地坐标系。
- **GCJ02**:国测局坐标系,由 WGS84 加密。
- **BD09**:百度坐标系,在 GCJ02 上再次加密。BD09LL 为百度经纬度,BD09MC 为百度墨卡托米制。
- 国内(含港澳台):地图 SDK 默认输入输出 BD09LL;可全局声明为 GCJ02,则全应用输入/输出为 GCJ02。海外统一 WGS84。
- 定位 SDK 默认输出 GCJ02;与地图混用时需统一,通常地图设为 BD09LL 且定位设置 `setCoorType("bd09ll")`,或地图设为 GCJ02。
## 全局坐标类型(自 4.3.0)
- `SDKInitializer.setCoordType(CoordType.BD09LL);` 或 `CoordType.GCJ02;` 声明全局类型。
- `SDKInitializer.getCoordType();` 获取当前类型。
- 自动转换仅适用于国内 GCJ02 输入;海外用 WGS84 无需转换。
## 通用坐标转换(CoordinateConverter)
- 将 WGS84/GCJ02 等转为 BD09LL(或当前声明的类型),需使用 SDK 提供的 CoordinateConverter,勿用非官方算法。
- 示例(其它坐标系 → 百度经纬度):
- 高德/腾讯等(COMMON):`CoordinateConverter().from(CoordType.COMMON).coord(sourceLatLng).convert();`
- GPS 设备原始坐标:`CoordinateConverter().from(CoordinateConverter.CoordType.GPS).coord(sourceLatLng).convert();`
- BD09MC → BD09LL:`from(CoordType.BD09MC).coord(sourceLatLng).convert();`
- 返回 `LatLng desLatLng = converter.convert();`
## 注意事项
- 国内非 BD09LL 坐标需先转为 BD09LL 再叠加到百度地图,否则会偏移。
- 海外 POI 使用 WGS84,地图海外也为 WGS84,无需转换。同时使用国内外数据时,自动坐标转换方式不适用,需手动按场景转换。references/errorcode.md
# 错误码对照表 检索、路线等接口返回结果中带 error/errorCode 时,可参考下表。更多可查官方错误码文档。 | 状态码 | 含义 | |--------|------| | 0 | 正常 | | 1 | 服务器内部错误(超时或系统错误) | | 10 | 上传内容超过 8M | | 101 | AK 参数不存在 | | 102 | mcode 参数不存在(Mobile 类型必需 Mcode) | | 200 | APP 不存在,AK 有误 | | 201 | APP 被用户禁用 | | 202 | APP 被管理员删除 | | 203 | APP 类型错误(Server/Mobile/Browser 等) | | 210 | APP IP 校验失败 | | 211 | APP SN 校验失败 | | 220 | APP Referer 校验失败 | | 230 | APP Mcode 校验失败 | | 240 | APP 服务被禁用 | | 250 | 用户不存在 | | 251 | 用户被自己删除 | | 252 | 用户被管理员删除 | | 260 | 服务不存在 | | 261 | 服务被禁用 | | 301 | 永久配额超限 | | 302 | 天配额超限 | | 401 | 并发量超过约定并发配额 | | 402 | 并发超限且总并发也超总配额 | 检索/路线结果判断:结果类(如 PoiResult、DrivingRouteResult)有 **result.error** 字段,类型为 **SearchResult.ERRORNO**(枚举)。成功:`result.error == SearchResult.ERRORNO.NO_ERROR`。 ### 路线规划常用 ERRORNO | 枚举值 | 含义 | |--------|------| | NO_ERROR | 成功 | | RESULT_NOT_FOUND | 未找到路线 | | AMBIGUOUS_ROURE_ADDR | 起终点或途经点地址歧义,可 result.getSuggestAddrInfo() | ### POI 检索常用 ERRORNO | 枚举值 | 含义 | |--------|------| | NO_ERROR | 成功 | | RESULT_NOT_FOUND | 未找到 | | AMBIGUOUS_KEYWORD | 关键字在本市无、其他城市有,可 result.getSuggestCityList() |
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/baidu-maps/skills/baidu-map-android-sdk",
"sourceUrl": "https://clawhub.ai/baidu-maps/skills/baidu-map-android-sdk",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T13:51:31.286Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-android-sdk/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-android-sdk/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T13:51:31.286Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.4K downloads",
"href": "https://clawhub.ai/baidu-maps/baidu-map-android-sdk",
"sourceUrl": "https://clawhub.ai/baidu-maps/baidu-map-android-sdk",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T13:51:31.286Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.3",
"href": "https://clawhub.ai/baidu-maps/baidu-map-android-sdk",
"sourceUrl": "https://clawhub.ai/baidu-maps/baidu-map-android-sdk",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-01T03:41:59.477Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-android-sdk/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-android-sdk/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.3",
"description": "- Removed sample files: _meta.json, skill-card.md - No changes to core logic or documentation in SKILL.md",
"href": "https://clawhub.ai/baidu-maps/baidu-map-android-sdk",
"sourceUrl": "https://clawhub.ai/baidu-maps/baidu-map-android-sdk",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-01T03:41:59.477Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
