用途:在 HarmonyOS NEXT 上使用百度地图鸿蒙 SDK 开发地图相关功能,包括地图组件展示与手势控件交互、Marker/线/面/圆/文字/信息窗口等覆盖物、普通/卫星/个性化/自定义瓦片图层、驾车步行骑行公交路线规划与步骑行导航、POI/AOI/室内 POI/建筑物/行政区/天气检索、正逆地理编码、坐标转换与调起百度地图等。不适用于 Web JS API、Android/iOS 原生 SDK、小程序地图及与地图无关的鸿蒙开发。
主要能力与用法:按需安装独立包,如 ohpm install @bdmap/base、@bdmap/search、@bdmap/util、@bdmap/map、@bdmap/locsdk;组合能力可用 ohpm install @bdmap/map_walkride_search 或 ohpm install @bdmap/navi_map。组合包与独立包不可混用,@bdmap/locsdk 不受此限制。开发前需检查 oh-package.json5 已有方案并保持一致。涉及网络、检索、路线规划需声明 ohos.permission.GET_WIFI_INFO、GET_NETWORK_INFO、GET_BUNDLE_INFO、INTERNET 等权限。
限制与规范:仅支持标准系统与华为手机,需 HarmonyOS NEXT Developer Preview1 及以上、对应 DevEco Studio 与 SDK 版本。日志须用统一 Logger 封装,禁止直接使用 console;图片资源需拷贝到 resources/rawfile/ 后以 rawfile:// 引用;覆盖物需显式设置 zIndex 并分层;回调与方法须显式声明类型以通过 ArkTSCheck。每次代码改动后需执行 ohpm install 与 hvigorw assembleHap --mode module -p product=default -p buildMode=debug --no-daemon 进行构建自检。具体 API 参数、枚举与错误码以本地 references 文档及官方在线文档为准,资料未提供的细节暂未提供。