核心定位
百度地图 HarmonyOS SDK 开发 Skill 是面向 HarmonyOS NEXT 平台的专业开发指南，提供从依赖管理到功能实现的全链路支持。该 Skill 涵盖独立包（@bdmap/base、@bdmap/map、@bdmap/search、@bdmap/util）与组合包（@bdmap/map_walkride_search、@bdmap/navi_map）两套方案，以及独立的定位 SDK（@bdmap/locsdk）。
核心能力矩阵
地图展示与交互：MapComponent 组件化接入、MapController 精细化控制、手势/控件/事件管理、多地图类型切换（标准/卫星/个性化/室内图）、离线地图能力。
覆盖物体系：Marker（含点聚合、动画）、Polyline（含轨迹动画）、Polygon/Circle、PopView/Label 信息窗口、3D 棱柱/建筑物/GLTF 模型、热力图/瓦片图层，支持 zIndex 分层与性能优化。
检索服务：POI/AOI/室内 POI 检索、地理编码/逆编码、行政区边界、建筑物信息、天气服务、推荐上车点、公交线/Sug 联想检索。
路线规划：驾车/步行/骑行/公交/跨城公交多模式规划，支持策略偏好、途经点设置。
步骑行导航：完整导航引擎（BDNaviService）、实时状态监听、语音播报插件、模拟导航、默认导航 UI 组件。
定位能力：前台/后台连续定位、单次定位、地址/POI 反查，严格遵循隐私合规与权限申请流程。
显著优势
- 官方权威性：直接对接百度地图 LBS 官方 SDK，API 语义与在线文档保持一致
- 工程规范严格：强制要求依赖前置安装、包管理互斥规则、Logger 统一封装、ArkTSCheck 类型安全
- 性能优化指导：覆盖物缓存复用、zIndex 分层、高频 UI 更新最佳实践
- 调试支持完善：Auto Run 构建自检、模拟导航、完整错误码映射
潜在局限
- 平台限制：仅支持 HarmonyOS NEXT 标准系统华为手机，DevEco Studio NEXT DP1+ 及对应 SDK 版本
- 包管理约束：组合包与独立包严格互斥，切换需执行卸载-替换-验证流程
- 生态依赖：部分高级能力（如 3D 模型、粒子效果）需确认设备硬件支持
适用人群
HarmonyOS NEXT 应用开发者、需要集成地图能力的工具/出行/生活服务类应用团队、从 Android/iOS 地图 SDK 迁移至鸿蒙平台的开发者。
常规风险
- 权限合规风险：定位功能涉及用户隐私，必须严格遵循「隐私同意 → AK 鉴权 → 权限申请」时序
- 依赖冲突风险：混用组合包与独立包会导致编译失败，需严格遵循包管理互斥规则
- 坐标系混淆：外部 WGS84/GCJ-02 数据需经 CoordTrans 转换为 BD09ll，否则定位偏移
- 资源引用错误：rawfile 图片资源需手动拷贝至工程目录，路径错误导致覆盖物不显示
- 生命周期泄漏：导航引擎、定位客户端需在页面销毁时显式释放，避免内存泄漏