Xpersona
agentCLAWHUBUnverified

Baidu Map IOS SDK（百度地图官方IOS SKills）

百度地图 iOS SDK 与 BMKLocationKit 集成与开发规范。覆盖地图、定位、步骑行导航、检索、路线、标注与覆盖物；输出专业地图方案。可快捷使用百度地图 SDK 的能力与数据，构建功能丰富、交互性强的专业地图类应用。 Skill: Baidu Map IOS SDK（百度地图官方IOS SKills） Owner: baidu-maps Summary: 百度地图 iOS SDK 与 BMKLocationKit 集成与开发规范。覆盖地图、定位、步骑行导航、检索、路线、标注与覆盖物；输出专业地图方案。可快捷使用百度地图 SDK 的能力与数据，构建功能丰富、交互性强的专业地图类应用。 Tags: latest:1.0.2 Version history: v1.0.2 | 2026-06-01T03:40:38.452Z | user baidu-map-ios-sdk 1.0.2 - 移除元数据文件 _meta.json。 - 移除技能简介卡片 skill-card.md。 - 保持主功能、集成文档和规则不变，仅精简技能包结构。 v1.0.1 | 2026-04-07T04:07:47.729Z | user Initial release

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

1.4k

Updated

Oct 10, 2026

Version

1.0.2

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.2release · observed Jun 1, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s178nge8tvzzhnan6cc08q0ech84dmtm:baidu-map-ios-sdk
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. 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-ios-sdk/snapshot"

Documentation

CLAWHUB

144,094 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: baidu-map-ios-sdk
description: 百度地图 iOS SDK 与 BMKLocationKit 集成与开发规范。覆盖地图、定位、步骑行导航、检索、路线、标注与覆盖物；输出专业地图方案。可快捷使用百度地图 SDK 的能力与数据，构建功能丰富、交互性强的专业地图类应用。
compatibility: iOS, Xcode, CocoaPods
---

# 百度地图 iOS SDK

## 目标与边界

- **目标**：在 iOS 工程中正确集成百度地图/定位/步骑行导航，并给出符合隐私与坐标系规范的实现方案。
- **负责**：BaiduMapKit、BMKLocationKit、BaiduWalkNaviKit 的集成、配置、API 选用与示例；与技能内 reference 文档一致。
- **不负责**：驾车导航细节（百度地图驾车导航文档）、服务端逻辑、非百度 SDK、UI 视觉设计（仅遵循 [ui-standards.md](references/ui-standards.md) 的规范）。

## 使用时机

满足其一即启用本技能：

- 关键词：百度地图、BMKMapView、BMKLocationKit、步骑行导航、BaiduWalkNaviKit、标注、路线规划、CocoaPods 集成、BD09、定位鉴权
- 需求类型：地图展示、单次/连续/后台定位、步行或骑行实时导航、POI/标注/覆盖物、路线绘制、逆地理、轨迹动画、点聚合、隐私弹窗

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

## 集成与编码顺序

- **未集成百度地图 SDK 时**：先配置并执行 CocoaPods（编写/补全 Podfile → 执行 `pod install` → 使用生成的 `.xcworkspace` 打开），**在能正确导入 SDK 头文件之后**再编写调用地图/定位/检索等的代码。这样既避免使用 `#if __has_include(...)` 做条件编译，也能以实际 SDK 头文件为准写代码，减少接口不一致或编译错误。
- **本地已集成 SDK 时**：直接按需导入头文件并写代码，**以当前工程内的 SDK 版本、头文件及接口为准**；类名、方法、参数与本地头文件一致，不写不存在的 API。若编译报错提示符号不存在，提示开发者核对或更新 Pod 版本后再重试。

## Agent 执行要求

1. **AK 与 Bundle 主动提示**  
   在编写或集成使用地图/定位 SDK 的代码时，**主动提示开发者**：
   - 在 [百度 LBS 控制台](https://lbsyun.baidu.com/) 申请 **iOS 应用 AK**，且应用的 **Bundle Identifier** 必须与工程中 `PRODUCT_BUNDLE_IDENTIFIER` 一致；
   - 在代码或配置中预留/替换 AK 的位置（如 `AppDelegate` 中的 key、或说明需在控制台配置），并注明「将 `YOUR_AK` 替换为实际 AK」。
   - 若工程尚未配置 Bundle ID，提醒开发者设置并与控制台申请时填写的包名一致。

2. **代码写完自动执行编译修复，编译无误后停止**  
   完成与百度地图/定位相关的代码修改后，**必须**按以下流程执行，**不得在编译未通过时结束**：
   - **自动执行编译**：使用 `xcodebuild -workspace xxx.xcworkspace -scheme xxx -destination 'generic/platform=iOS' build`（或等价命令；CocoaPods 工程用 workspace，纯工程用 project）。
   - **若编译报错**：根据报错信息**立即修复**（类名、方法签名、头文件、ARC、协议声明等），修复后**再次执行编译**。
   - **循环**：重复「编译 → 若有错误则修复 → 再编译」，直至**编译通过、无错误**。
   - **编译无误后停止**：仅当 build 成功（BUILD SUCCEEDED）后，才结束本轮代码修改与修复，不再继续做与编译无关的额外修改。

3. **配置 Launch Screen 避免 App 非全屏**  
   集成地图或涉及全屏展示时，**必须**确保工程已配置 Launch Screen，避免运行后出现黑边、非全屏。具体见 [project-config.md](references/project-config.md)「窗口初始化/Launch Screen」：
   - 工程内存在 **LaunchScreen.storyboard**（或等效 Launch 资源），并加入 target 的 Resources；
   - Info.plist 中配置 **UILaunchStoryboardName** 为 `LaunchScreen`；
   - 若缺失，主动创建或补充说明，并提醒开发者添加该配置。

## 必须遵守的规则

1. **隐私与配置**
   - 首次使用前必须弹窗让用户阅读并同意隐私政策，再调用对应接口。
   - **地图**：`[BMKMapManager setAgreePrivacy:YES]`（**类方法**，勿用 `sharedInstance`；未同意时检索可返回 nil）。
   - **定位**：通过 **BMKLocationAuth** 的 **setAgreePrivacy** 在用户同意后再初始化 BMKLocationManager 等；详见 [location.md](references/location.md)。
   - Info.plist 必配 **CFBundleDisplayName**；使用定位时配 NSLocationWhenInUseUsageDescription 等。详见 [project-config.md](references/project-config.md)。
   - **AK 与 Bundle**：编写集成代码时主动提示开发者提供/配置 AK，且 Bundle Identifier 与百度控制台申请一致（见上文「Agent 执行要求」）。
   - **Launch Screen**：必须配置 LaunchScreen.storyboard 与 Info.plist 的 UILaunchStoryboardName，避免运行后 App 非全屏、黑边；见 [project-config.md](references/project-config.md)。

2. **坐标系**
   - 地图 SDK 全局 **BD09**；定位 SDK 默认 **GCJ02**。与地图混用时须统一为 BD09：将定位 **coordi

_meta.json

{
  "ownerId": "kn778b6bf766ym71fdvrc5yvg98319rv",
  "slug": "baidu-map-ios-sdk",
  "version": "1.0.2",
  "publishedAt": 1780285238452
}

references/annotations.md

# 标注 (Annotation)

**边界**：addAnnotation 体系；覆盖物见 [overlays.md](overlays.md)。**必须遵守**：点标注**优先使用 Marker**（BMKIconMarker/BMKTextMarker，addOverlay），**不得使用** Annotation/PinAnnotation 做起终点、小车、普通图钉等；**仅**点聚合、固定屏选点等必须用 addAnnotation 的场景才用本 API。见 [SKILL.md](../SKILL.md) 规则 3。

## 使用须知
- **Delegate**：addAnnotation 前必须设置 `mapView.delegate`，并实现 `mapView:viewForAnnotation:`。
- **复用**：使用 `dequeueReusableAnnotationViewWithIdentifier`，identifier 建议唯一。
- **起终点**：推荐 BMKIconMarker（addOverlay），见 [overlays.md](overlays.md)。

## 核心类

| 类 | 头文件 | 说明 |
|----|--------|------|
| BMKAnnotation | BMKAnnotation.h | 标注协议，`coordinate`、`title` |
| BMKPointAnnotation | BMKPointAnnotation.h | 点标注 |
| BMKAnnotationView | BMKAnnotationView.h | 标注视图基类 |
| BMKPinAnnotationView | BMKPinAnnotationView.h | 大头针样式 |
| BMKActionPaopaoView | BMKActionPaopaoView.h | 气泡视图 |

**标注规范**：使用 `dequeueReusableAnnotationViewWithIdentifier` 复用，identifier 建议唯一。自定义图片用 BMKAnnotationView + image。

## 固定屏幕标注（地图选点）

`BMKPointAnnotation.isLockedToScreen = YES` + `screenPointToLock`，需在 `mapViewDidFinishLoading` 后设置。常用于地图选点。

**方式 B（BMKIconMarker）**：Marker 无 isLockedToScreen，需在 `regionDidChangeAnimated:reason:` 中（reason == BMKRegionChangeReasonGesture）同步 `marker.coordinate = mapView.centerCoordinate`。**区域回调**：regionWillChange 跳起，regionDidChange 落下 + 逆地理。**选点动画**见 [ui-standards.md](ui-standards.md)。

## BMKPinAnnotationView 常用属性

`centerOffset`、`calloutOffset`（正偏移朝右下方）、`enabled3D`、`canShowCallout`、`leftCalloutAccessoryView`/`rightCalloutAccessoryView`（默认气泡最大 32×41）、`pinColor`（Red/Green/Purple）、`animatesDrop`、`draggable`。直接设置 `selected` 时，非 PinAnnotation 需在设置后调用 `mapForceRefresh`。

## 碰撞检测与展示优先级

`BMKAnnotationView.displayPriority`（如 `BMKFeatureDisplayPriorityDefaultHigh`）、`isOpenCollisionDetection`、`collisionDetectionPriority`（数值越大越优先）、`isForceDisplay`（强制展示）、`displayMaxLevel`/`displayMinLevel`（层级限制）。

## 点聚合中的标注

点聚合（BMKClusterManager + BMKPointAnnotation）将大量标注按 zoom 聚合。`viewForAnnotation` 按 cluster.size 区分单点/聚合点；size>1 可显示数量、按档设圆点大小。**点击拆簇**：`annotationViewForBubble` 中 zoomIn。聚合逻辑见 [overlays.md](overlays.md)。

---

## 按需方案

| 需求 | 基础能力 |
|------|----------|
| 普通点标注 | BMKPointAnnotation + BMKAnnotationView |
| 大头针 | BMKPointAnnotation + BMKPinAnnotationView |
| 固定屏幕选点 | BMKPointAnnotation（isLockedToScreen + screenPointToLock）或 BMKIconMarker |
| 起终点大头针 | BMKPointAnnotation + BMKAnnotationView（起终点推荐 BMKIconMarker，见 [overlays.md](overlays.md)） |
| 点聚合标注 | BMKClusterManager + BMKPointAnnotation，viewForAnnotation 按 size 展示 |

references/assets.md

# 图片资源

**边界**：技能内 `assets/images/` 图片及用途；集成与构建见 [cocoapods.md](cocoapods.md)、[project-config.md](project-config.md)。

**路线小车**：路线上的小车图标**必须优先使用**本技能提供的纹理图（下表 icon_car / car_triangle / track_car）；仅当无可用纹理时，才使用纯色或自绘图片。实现时先 `[UIImage imageNamed:@"icon_car"]`（或对应名称），为 nil 再回退。

| 图片 | 用途 |
|------|------|
| icon_car | 小车 marker（**路线小车优先**） |
| car_triangle | 带方向小车（车头朝上） |
| track_car | 带方向小车（车头朝右），**轨迹动画推荐** |
| icon_start | 起点标注 |
| icon_end | 终点标注 |
| icon_via | 途经点 |
| **路况纹理**（BMKMultiPolyline + BMKMultiTexturePolylineView，drawIndexs 来自 BMKDrivingStep.traffics） | |
| traffic_texture_unknown | 无数据（traffics=0，drawIndex 0） |
| traffic_texture_smooth | 畅通（traffics=1，drawIndex 1） |
| traffic_texture_slow | 缓行（traffics=2，drawIndex 2） |
| traffic_texture_congestion | 拥堵（traffics=3，drawIndex 3） |
| traffic_texture_severe_congestion | 严重拥堵（traffics=4，drawIndex 4） |

references/class-index.md

# 类速查表

**边界**：按头文件组织的类速查；用法与示例见 [annotations.md](annotations.md)、[overlays.md](overlays.md) 等各功能文档。下表记录类名、头文件及主要方法/属性名，便于不依赖外链查阅。

## 地图核心

| 类 | 头文件 | 说明 |
|----|--------|------|
| BMKMapManager | BMKMapManager.h | 主引擎 |
| BMKMapView | BMKMapView.h | 地图视图 |
| BMKMapStatus | BMKMapStatus.h | 地图状态 |
| BMKMapViewDelegate | BMKMapView.h | 地图回调 |

## 标注

| 类 | 头文件 | 说明 |
|----|--------|------|
| BMKAnnotation | BMKAnnotation.h | 标注协议 |
| BMKPointAnnotation | BMKPointAnnotation.h | 点标注 |
| BMKAnnotationView | BMKAnnotationView.h | 标注视图基类 |
| BMKPinAnnotationView | BMKPinAnnotationView.h | 大头针样式 |
| BMKActionPaopaoView | BMKActionPaopaoView.h | 气泡视图 |

## 覆盖物

### 基础

| 类 | 头文件 | 说明 |
|----|--------|------|
| BMKOverlay | BMKOverlay.h | 覆盖物协议 |
| BMKOverlayView | BMKOverlayView.h | 覆盖物视图基类 |
| BMKPolyline | BMKPolyline.h | 单色/单纹理折线 |
| BMKPolylineView | BMKPolylineView.h | 折线视图 |
| BMKMultiPolyline | BMKMultiPolyline.h | 分段折线，需 drawIndexs |
| BMKMultiColorPolylineView | BMKMultiPolylineView.h | 分段颜色 |
| BMKMultiTexturePolylineView | BMKMultiPolylineView.h | 分段纹理（路况） |
| BMKCircle | BMKCircle.h | 圆形 |
| BMKCircleView | BMKCircleView.h | 圆形视图 |
| BMKPolygon | BMKPolygon.h | 多边形 |
| BMKPolygonView | BMKPolygonView.h | 多边形视图 |
| BMKGroundOverlay | BMKGroundOverlay.h | 图片图层 |
| BMKGroundOverlayView | BMKGroundOverlayView.h | 图片图层视图 |
| BMKTileLayer | BMKTileLayer.h | 瓦片图层基类 |
| BMKURLTileLayer | BMKTileLayer.h | URL 瓦片图层 |

### 曲线与渐变

| 类 | 头文件 | 说明 |
|----|--------|------|
| BMKArcline | BMKArcline.h | 圆弧 |
| BMKArclineView | BMKArclineView.h | 圆弧视图 |
| BMKGradientLine | BMKGradientLine.h | 渐变线 |
| BMKGradientLineView | BMKGradientLineView.h | 渐变线视图 |
| BMKGradientCircleView | BMKGradientCircleView.h | 渐变圆 |
| BMKGeodesicLine | BMKGeodesicLine.h | 大地线 |
| BMKGeodesicLineView | BMKGeodesicLineView.h | 大地线视图 |

### Marker

| 类 | 头文件 | 说明 |
|----|--------|------|
| BMKIconMarker | BMKIconMarker.h | 图标 Marker |
| BMKIconMarkerView | BMKIconMarkerView.h | 图标 Marker 视图 |
| BMKTextMarker | BMKTextMarker.h | 文本 Marker |
| BMKTextMarkerView | BMKTextMarkerView.h | 文本 Marker 视图 |
| BMKTextPathMarker | BMKTextPathMarker.h | 沿路径文字 |
| BMKTextPathMarkerView | BMKTextPathMarkerView.h | 沿路径文字视图 |

### 文本与海量点

| 类 | 头文件 | 说明 |
|----|--------|------|
| BMKText | BMKText.h | 文本 overlay |
| BMKTextView | BMKTextView.h | 文本 overlay 视图 |
| BMKMultiPointOverlay | BMKMultiPointOverlay.h | 海量点 |
| BMKMultiPointOverlayView | BMKMultiPointOverlayView.h | 海量点视图 |
| BMKMultiPointItem | BMKMultiPointOverlay.h | 海量点数据项 |

### 3D 与轨迹

| 类 | 头文件 | 说明 |
|----|--------|------|
| BMK3DModelOverlay | BMK3DModelOverlay.h | 3D 模型 |
| BMK3DModelOverlayView | BMK3DModelOverlayView.h | 3D 模型视图 |
| BMKPrismOverlay | BMKPrismOverlay.h | 棱柱/3D 建筑 |
| BMKPrismOverlayView | BMKPrismOverlayView.h | 棱柱视图 |
| BMKTraceOverlay | BMKTraceOverlay.h | 路书轨迹 |
| BMKTraceOverlayView | BMKTraceOverlayView.h | 路书轨迹视图 |
| BMK3DTraceOverlay | BMK3DTraceOverlay.h | 3D 轨迹 |
| BMK3DTraceOverlayView | BMK3DTraceOverlay

Related agents

Same protocol, similar job.

Github ReposUpdated 21h agoRank 70

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!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

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

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

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-ios-sdk",
      "sourceUrl": "https://clawhub.ai/baidu-maps/skills/baidu-map-ios-sdk",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T15:15:35.151Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-ios-sdk/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-ios-sdk/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-10T15:15:35.151Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.4K downloads",
      "href": "https://clawhub.ai/baidu-maps/baidu-map-ios-sdk",
      "sourceUrl": "https://clawhub.ai/baidu-maps/baidu-map-ios-sdk",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T15:15:35.151Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.0.2",
      "href": "https://clawhub.ai/baidu-maps/baidu-map-ios-sdk",
      "sourceUrl": "https://clawhub.ai/baidu-maps/baidu-map-ios-sdk",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-06-01T03:40:38.452Z",
      "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-ios-sdk/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-ios-sdk/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.2",
      "description": "baidu-map-ios-sdk 1.0.2 - 移除元数据文件 _meta.json。 - 移除技能简介卡片 skill-card.md。 - 保持主功能、集成文档和规则不变，仅精简技能包结构。",
      "href": "https://clawhub.ai/baidu-maps/baidu-map-ios-sdk",
      "sourceUrl": "https://clawhub.ai/baidu-maps/baidu-map-ios-sdk",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-06-01T03:40:38.452Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 10, 2026.

Sponsored

Ads related to Baidu Map IOS SDK（百度地图官方IOS SKills） and adjacent AI workflows.