百度定位 UTS-API 插件基于百度地图定位 SDK，为 uni-app x 应用提供统一的原生定位能力，支持 Android、iOS 和 HarmonyOS NEXT。插件可用于单次定位、连续定位、后台定位、地址解析和周边 POI 获取。

• Android：Android 7.0（API 24）及以上。

• iOS：iOS 12.0 及以上。

• HarmonyOS NEXT：API 17 及以上。

将 baidumap-location 插件放入 uni-app x 项目的 uni_modules 目录。插件已包含三端原生定位 SDK 依赖，业务代码从项目内的插件路径导入 API。

import {
  BMapLocationClient, LocationListener, LocationClientOption,
  Location, Permission, checkPermission, guideSettingPermission
} from '@/uni_modules/baidumap-location'

请确认权限配置已合入最终安装包。仅使用前台定位时配置前台定位权限；使用后台定位时，还需按平台要求配置后台权限和后台运行能力。

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

在最终应用的 Info.plist 中配置 NSLocationWhenInUseUsageDescription。需要后台定位时，还应配置 NSLocationAlwaysAndWhenInUseUsageDescription，并启用 UIBackgroundModes 中的 location。权限文案应准确描述业务用途。

在最终 HAP 中确认已声明 ohos.permission.LOCATION、ohos.permission.APPROXIMATELY_LOCATION 和网络权限。需要后台定位时，还需声明 ohos.permission.LOCATION_IN_BACKGROUND、ohos.permission.KEEP_BACKGROUND_RUNNING，并配置 location 类型的 backgroundModes。

首次定位前，应按“用户同意隐私政策 → 设置隐私状态 → 配置 AK → 申请定位权限 → 创建客户端 → 设置监听和参数 → 发起定位”的顺序初始化。Android 和 HarmonyOS 的鉴权 Promise 完成不等同于 AK 一定有效，仍需处理定位回调中的鉴权失败状态。

BMapLocationClient.setAgreePrivacy(true)
await BMapLocationClient.checkAuthKey('您的密钥')
const permission: Permission = await checkPermission()
if (!permission.IS_GRANT) {
  guideSettingPermission()
}

页面卸载或业务结束时调用 destroy()。该方法会停止定位、关闭后台定位并注销监听，避免持续耗电、无效回调和资源泄漏。