tmui-cli 2.0.3 → 2.0.5

package/data/uniappx/api/location-change.md

@@ -0,0 +1,533 @@
+## uni.onLocationChange(callback) @onlocationchange
+
+监听实时地理位置变化事件
+
+### onLocationChange 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS 系统版本 | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 4.81 | 4.81 | 5.0.0(11) | 4.81 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| listener | (res: [OnLocationChangeResult](#onlocationchangeresult-values)) => void | 是 | 
+
+### OnLocationChangeResult 的属性值 @onlocationchangeresult-values 
+
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| latitude | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+| longitude | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 经度，范围为-180~180，负数表示西经 |
+| speed | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 速度，浮点数，单位m/s |
+| accuracy | number | 是 |  | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 位置的精确度 |
+| altitude | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 高度，单位 m |
+| verticalAccuracy | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81 | 垂直精度，单位 m（Android 无法获取，返回 0） |
+| horizontalAccuracy | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 水平精度，单位 m（Android、HarmonyOS 无法获取，返回 0） |
+| address | string | 否 | null | Web x / 微信小程序 x / Android 3.9.0 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 地址信息 |
+
+### 返回值 
+
+| 类型 |
+| :- |
+| number |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.location.onLocationChange)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.onLocationChange.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=onLocationChange&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=onLocationChange&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=onLocationChange&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=onLocationChange&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=onLocationChange)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=onLocationChange&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+## uni.offLocationChange(callback) @offlocationchange
+
+移除实时地理位置变化事件。
+
+### offLocationChange 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS 系统版本 | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 4.81 | 4.81 | 5.0.0(11) | 4.81 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| listener | number \| (res: **OnLocationChangeResult**) => void | 否 |
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| latitude | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+| longitude | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 经度，范围为-180~180，负数表示西经 |
+| speed | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 速度，浮点数，单位m/s |
+| accuracy | number | 是 |  | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 位置的精确度 |
+| altitude | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61 | 高度，单位 m |
+| verticalAccuracy | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81 | 垂直精度，单位 m（Android 无法获取，返回 0） |
+| horizontalAccuracy | number | 是 | 0 | Web 4.0 / 微信小程序 4.41 / Android 3.9.0 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 水平精度，单位 m（Android、HarmonyOS 无法获取，返回 0） |
+| address | string | 否 | null | Web x / 微信小程序 x / Android 3.9.0 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 地址信息 |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.location.offLocationChange)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.offLocationChange.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=offLocationChange&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=offLocationChange&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=offLocationChange&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=offLocationChange&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=offLocationChange)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=offLocationChange&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+## uni.onLocationChangeError(callback) @onlocationchangeerror
+
+监听持续定位接口返回失败时触发。
+
+### onLocationChangeError 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS 系统版本 | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 4.81 | 4.81 | 5.0.0(11) | 4.81 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| listener | (listener: [IGetLocationFail](#igetlocationfail-values)) => void | 是 | 
+
+### IGetLocationFail 的属性值 @igetlocationfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errCode | number | 是 | 错误码 |
+| 合法值 | 兼容性 | 描述 |
+| :- |  :-: | :- |
+| 1505023 | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 不支持逆地理编码 |
+| 1505003 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 系统定位未开启，请在系统设置中开启系统定位 |
+| 1505004 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 应用定位权限未开启 |
+| 1505600 | Android 4.25 / iOS 4.25（部分支持，见上） | 超时 |
+| 1505601 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 不支持的定位类型 |
+| 1505602 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 捕获定位失败 |
+| 1505603 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 逆地理编码捕获失败 |
+| 1505604 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 服务供应商获取失败 |
+| 1505700 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 不支持逆地理编码 |
+| 1505701 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 没有找到具体的定位引擎（GPS_PROVIDER，NETWORK_PROVIDER，PASSIVE_PROVIDER等），请确定系统定位是否开启 |
+| 1505800 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 应用高精度定位权限未开启 |
+| 1505605 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 未通过配置预校验，通常是腾讯定位 api key 配置错误 |
+| 1505607 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 腾讯定位只支持GCJ-02 |
+| 1505608 | Android 4.81 / iOS 4.81 / HarmonyOS x（部分支持，见上） | 同一时间只能单个provider开启持续定位 |
+| 1505702 | Android 4.81 / iOS 4.81 / HarmonyOS x（部分支持，见上） | iOS plist文件中缺少后台定位配置：UIBackgroundModes->location |
+| ~~1505005~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 缺失高精度权限授权（iOS特有）  **从4.25开始已经废弃** |
+| ~~1505021~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 超时  **从4.25开始已经废弃** |
+| ~~1505022~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 不支持的定位类型  **从4.25开始已经废弃** |
+| ~~1505024~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 没有找到具体的定位引擎（GPS_PROVIDER，NETWORK_PROVIDER，PASSIVE_PROVIDER等），请定位开关是否已打开  **从4.25开始已经废弃** |
+| ~~1505025~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 逆地理编码捕获失败  **从4.25开始已经废弃** |
+| ~~1505026~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 捕获定位失败  **从4.25开始已经废弃** |
+| errSubject | string | 是 | 统一错误主题（模块）名称 |
+| data | any | 否 | 错误信息中包含的数据 |
+| cause | Error | 否 | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 |  |
+
+### 返回值 
+
+| 类型 |
+| :- |
+| number |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.location.onLocationChangeError)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.onLocationChangeError.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=onLocationChangeError&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=onLocationChangeError&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=onLocationChangeError&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=onLocationChangeError&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=onLocationChangeError)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=onLocationChangeError&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+## uni.offLocationChangeError(callback) @offlocationchangeerror
+
+移除监听持续定位接口返回失败事件。
+
+### offLocationChangeError 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS 系统版本 | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 4.81 | 4.81 | 5.0.0(11) | 4.81 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| listener | number \| (listener: **IGetLocationFail**) => void | 否 |
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errCode | number | 是 | 错误码 |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| 1505023 | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 不支持逆地理编码 |
+@@| 1505003 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 系统定位未开启，请在系统设置中开启系统定位 |
+@@| 1505004 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 应用定位权限未开启 |
+@@| 1505600 | Android 4.25 / iOS 4.25（部分支持，见上） | 超时 |
+@@| 1505601 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 不支持的定位类型 |
+@@| 1505602 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 捕获定位失败 |
+@@| 1505603 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 逆地理编码捕获失败 |
+@@| 1505604 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 服务供应商获取失败 |
+@@| 1505700 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 不支持逆地理编码 |
+@@| 1505701 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 没有找到具体的定位引擎（GPS_PROVIDER，NETWORK_PROVIDER，PASSIVE_PROVIDER等），请确定系统定位是否开启 |
+@@| 1505800 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 应用高精度定位权限未开启 |
+@@| 1505605 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 未通过配置预校验，通常是腾讯定位 api key 配置错误 |
+@@| 1505607 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 腾讯定位只支持GCJ-02 |
+@@| 1505608 | Android 4.81 / iOS 4.81 / HarmonyOS x（部分支持，见上） | 同一时间只能单个provider开启持续定位 |
+@@| 1505702 | Android 4.81 / iOS 4.81 / HarmonyOS x（部分支持，见上） | iOS plist文件中缺少后台定位配置：UIBackgroundModes->location |
+@@| ~~1505005~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 缺失高精度权限授权（iOS特有）  **从4.25开始已经废弃** |
+@@| ~~1505021~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 超时  **从4.25开始已经废弃** |
+@@| ~~1505022~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 不支持的定位类型  **从4.25开始已经废弃** |
+@@| ~~1505024~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 没有找到具体的定位引擎（GPS_PROVIDER，NETWORK_PROVIDER，PASSIVE_PROVIDER等），请定位开关是否已打开  **从4.25开始已经废弃** |
+@@| ~~1505025~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 逆地理编码捕获失败  **从4.25开始已经废弃** |
+@@| ~~1505026~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 捕获定位失败  **从4.25开始已经废弃** |
+| errSubject | string | 是 | 统一错误主题（模块）名称 |
+| data | any | 否 | 错误信息中包含的数据 |
+| cause | Error | 否 | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 |  |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.location.offLocationChangeError)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.offLocationChangeError.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=offLocationChangeError&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=offLocationChangeError&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=offLocationChangeError&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=offLocationChangeError&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=offLocationChangeError)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=offLocationChangeError&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+## uni.startLocationUpdate(options) @startlocationupdate
+
+开启应用进入前台时接收位置消息。
+
+### startLocationUpdate 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS 系统版本 | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 4.81 | 4.81 | 5.0.0(11) | 4.81 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **StartLocationUpdateOptions** | 是 |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| provider | string | 否 | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 定位服务提供商，通过 uni.getProvider 获取,目前支持系统定位(system)、腾讯定位(tencent), web端暂不支持provider机制。 |
+| type | string | 否 | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 默认为 wgs84 返回 gps 坐标，gcj02 返回可用于uni.openLocation的坐标，web端需配置定位 SDK 信息才可支持 gcj02； |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| "wgs84" | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | wgs84坐标系，系统定位默认取值wgs84，系统定位仅支持wgs84坐标系  |
+@@| gcj02 | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | gcj02坐标系，腾讯定位默认取值gcj02，腾讯定位仅支持gcj02坐标系  |
+| success | (result: StartLocationUpdateSuccess) => void | 否 | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 接口调用成功的回调函数 |
+| fail | (result: [IGetLocationFail](#igetlocationfail-values)) => void | 否 | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+#### IGetLocationFail 的属性值 @igetlocationfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errCode | number | 是 | 错误码 |
+| 合法值 | 兼容性 | 描述 |
+| :- |  :-: | :- |
+| 1505023 | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 不支持逆地理编码 |
+| 1505003 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 系统定位未开启，请在系统设置中开启系统定位 |
+| 1505004 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 应用定位权限未开启 |
+| 1505600 | Android 4.25 / iOS 4.25（部分支持，见上） | 超时 |
+| 1505601 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 不支持的定位类型 |
+| 1505602 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 捕获定位失败 |
+| 1505603 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 逆地理编码捕获失败 |
+| 1505604 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 服务供应商获取失败 |
+| 1505700 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 不支持逆地理编码 |
+| 1505701 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 没有找到具体的定位引擎（GPS_PROVIDER，NETWORK_PROVIDER，PASSIVE_PROVIDER等），请确定系统定位是否开启 |
+| 1505800 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 应用高精度定位权限未开启 |
+| 1505605 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 未通过配置预校验，通常是腾讯定位 api key 配置错误 |
+| 1505607 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 腾讯定位只支持GCJ-02 |
+| 1505608 | Android 4.81 / iOS 4.81 / HarmonyOS x（部分支持，见上） | 同一时间只能单个provider开启持续定位 |
+| 1505702 | Android 4.81 / iOS 4.81 / HarmonyOS x（部分支持，见上） | iOS plist文件中缺少后台定位配置：UIBackgroundModes->location |
+| ~~1505005~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 缺失高精度权限授权（iOS特有）  **从4.25开始已经废弃** |
+| ~~1505021~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 超时  **从4.25开始已经废弃** |
+| ~~1505022~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 不支持的定位类型  **从4.25开始已经废弃** |
+| ~~1505024~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 没有找到具体的定位引擎（GPS_PROVIDER，NETWORK_PROVIDER，PASSIVE_PROVIDER等），请定位开关是否已打开  **从4.25开始已经废弃** |
+| ~~1505025~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 逆地理编码捕获失败  **从4.25开始已经废弃** |
+| ~~1505026~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 捕获定位失败  **从4.25开始已经废弃** |
+| errSubject | string | 是 | 统一错误主题（模块）名称 |
+| data | any | 否 | 错误信息中包含的数据 |
+| cause | Error | 否 | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 |  |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.location.startLocationUpdate)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.startLocationUpdate.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=startLocationUpdate&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=startLocationUpdate&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=startLocationUpdate&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=startLocationUpdate&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=startLocationUpdate)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=startLocationUpdate&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+### 注意
+
+<md-hperm :permissions="['ohos.permission.APPROXIMATELY_LOCATION', 'ohos.permission.LOCATION', { name: 'ohos.permission.LOCATION_IN_BACKGROUND', desc: '自身只启动前台持续定位；但如果后续调用 uni.startLocationUpdateBackground 且已有 watchId，会额外检查后台定位权限。' }]" />
+
+## uni.stopLocationUpdate(options) @stoplocationupdate
+
+关闭监听实时位置变化，前后台都停止消息接收。
+
+### stopLocationUpdate 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS 系统版本 | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 4.81 | 4.81 | 5.0.0(11) | 4.81 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **StopLocationUpdateOptions** | 是 |
+| 名称 | 类型 | 必备 |
+| :- | :- | :- |
+| success | (result: StopLocationUpdateSuccess) => void | 否 |
+| fail | (result: [IGetLocationFail](#igetlocationfail-values)) => void | 否 |
+| complete | (result: any) => void | 否 | 
+
+#### IGetLocationFail 的属性值 @igetlocationfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errCode | number | 是 | 错误码 |
+| 合法值 | 兼容性 | 描述 |
+| :- |  :-: | :- |
+| 1505023 | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 不支持逆地理编码 |
+| 1505003 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 系统定位未开启，请在系统设置中开启系统定位 |
+| 1505004 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 应用定位权限未开启 |
+| 1505600 | Android 4.25 / iOS 4.25（部分支持，见上） | 超时 |
+| 1505601 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 不支持的定位类型 |
+| 1505602 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 捕获定位失败 |
+| 1505603 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 逆地理编码捕获失败 |
+| 1505604 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 服务供应商获取失败 |
+| 1505700 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 不支持逆地理编码 |
+| 1505701 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 没有找到具体的定位引擎（GPS_PROVIDER，NETWORK_PROVIDER，PASSIVE_PROVIDER等），请确定系统定位是否开启 |
+| 1505800 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 应用高精度定位权限未开启 |
+| 1505605 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 未通过配置预校验，通常是腾讯定位 api key 配置错误 |
+| 1505607 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 腾讯定位只支持GCJ-02 |
+| 1505608 | Android 4.81 / iOS 4.81 / HarmonyOS x（部分支持，见上） | 同一时间只能单个provider开启持续定位 |
+| 1505702 | Android 4.81 / iOS 4.81 / HarmonyOS x（部分支持，见上） | iOS plist文件中缺少后台定位配置：UIBackgroundModes->location |
+| ~~1505005~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 缺失高精度权限授权（iOS特有）  **从4.25开始已经废弃** |
+| ~~1505021~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 超时  **从4.25开始已经废弃** |
+| ~~1505022~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 不支持的定位类型  **从4.25开始已经废弃** |
+| ~~1505024~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 没有找到具体的定位引擎（GPS_PROVIDER，NETWORK_PROVIDER，PASSIVE_PROVIDER等），请定位开关是否已打开  **从4.25开始已经废弃** |
+| ~~1505025~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 逆地理编码捕获失败  **从4.25开始已经废弃** |
+| ~~1505026~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 捕获定位失败  **从4.25开始已经废弃** |
+| errSubject | string | 是 | 统一错误主题（模块）名称 |
+| data | any | 否 | 错误信息中包含的数据 |
+| cause | Error | 否 | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 |  |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.location.stopLocationUpdate)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.stopLocationUpdate.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=stopLocationUpdate&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=stopLocationUpdate&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=stopLocationUpdate&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=stopLocationUpdate&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=stopLocationUpdate)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=stopLocationUpdate&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+## uni.startLocationUpdateBackground(option) @startlocationupdatebackground
+### 注意
+- iOS平台：如果应用需要后台定位能力，需要在 info.plist 中配置 UIBackgroundModes 的 location，注意需在Xcode工程中添加相对应 Capabilities 中的 Background Modes，并且勾选 Location updates。
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  	<key>UIBackgroundModes</key>
+		<array>
+			<string>location</string>
+		</array>
+
+	</dict>
+</plist>
+```
+
+<md-hperm :permissions="['ohos.permission.APPROXIMATELY_LOCATION', 'ohos.permission.LOCATION', 'ohos.permission.LOCATION_IN_BACKGROUND']" />
+
+开始监听实时地理位置信息变化事件，应用进入前后台时均接收实时地理位置信息。
+
+### startLocationUpdateBackground 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS 系统版本 | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 4.81 | 4.81 | 5.0.0(11) | 4.81 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **StartLocationUpdateBackgroundOptions** | 是 |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| provider | string | 否 | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 定位服务提供商，通过 uni.getProvider 获取,目前支持系统定位(system)、腾讯定位(tencent), web端暂不支持provider机制。 |
+| type | string | 否 | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 默认为 wgs84 返回 gps 坐标，gcj02 返回可用于uni.openLocation的坐标，web端需配置定位 SDK 信息才可支持 gcj02； |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| "wgs84" | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | wgs84坐标系，系统定位默认取值wgs84，系统定位仅支持wgs84坐标系  |
+@@| gcj02 | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | gcj02坐标系，腾讯定位默认取值gcj02，腾讯定位仅支持gcj02坐标系  |
+| success | (result: StartLocationUpdateBackgroundSuccess) => void | 否 | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 接口调用成功的回调函数 |
+| fail | (result: [IGetLocationFail](#igetlocationfail-values)) => void | 否 | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | Web 4.0 / 微信小程序 x / Android 4.81 / iOS 4.81 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+#### IGetLocationFail 的属性值 @igetlocationfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errCode | number | 是 | 错误码 |
+| 合法值 | 兼容性 | 描述 |
+| :- |  :-: | :- |
+| 1505023 | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 不支持逆地理编码 |
+| 1505003 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 系统定位未开启，请在系统设置中开启系统定位 |
+| 1505004 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 应用定位权限未开启 |
+| 1505600 | Android 4.25 / iOS 4.25（部分支持，见上） | 超时 |
+| 1505601 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 不支持的定位类型 |
+| 1505602 | Android 4.25 / iOS 4.25 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.81（部分支持，见上） | 捕获定位失败 |
+| 1505603 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 逆地理编码捕获失败 |
+| 1505604 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 服务供应商获取失败 |
+| 1505700 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 不支持逆地理编码 |
+| 1505701 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 没有找到具体的定位引擎（GPS_PROVIDER，NETWORK_PROVIDER，PASSIVE_PROVIDER等），请确定系统定位是否开启 |
+| 1505800 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 应用高精度定位权限未开启 |
+| 1505605 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 未通过配置预校验，通常是腾讯定位 api key 配置错误 |
+| 1505607 | Android 4.25 / iOS 4.25 / HarmonyOS x（部分支持，见上） | 腾讯定位只支持GCJ-02 |
+| 1505608 | Android 4.81 / iOS 4.81 / HarmonyOS x（部分支持，见上） | 同一时间只能单个provider开启持续定位 |
+| 1505702 | Android 4.81 / iOS 4.81 / HarmonyOS x（部分支持，见上） | iOS plist文件中缺少后台定位配置：UIBackgroundModes->location |
+| ~~1505005~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 缺失高精度权限授权（iOS特有）  **从4.25开始已经废弃** |
+| ~~1505021~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 超时  **从4.25开始已经废弃** |
+| ~~1505022~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 不支持的定位类型  **从4.25开始已经废弃** |
+| ~~1505024~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 没有找到具体的定位引擎（GPS_PROVIDER，NETWORK_PROVIDER，PASSIVE_PROVIDER等），请定位开关是否已打开  **从4.25开始已经废弃** |
+| ~~1505025~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 逆地理编码捕获失败  **从4.25开始已经废弃** |
+| ~~1505026~~ | Web 4.0 / Android 3.9.0 / iOS 4.11 / HarmonyOS 系统版本 5.0.0(11) / HarmonyOS 4.61（部分支持，见上） | 捕获定位失败  **从4.25开始已经废弃** |
+| errSubject | string | 是 | 统一错误主题（模块）名称 |
+| data | any | 否 | 错误信息中包含的数据 |
+| cause | Error | 否 | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 |  |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.location.startLocationUpdateBackground)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.startLocationUpdateBackground.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=startLocationUpdateBackground&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=startLocationUpdateBackground&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=startLocationUpdateBackground&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=startLocationUpdateBackground&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=startLocationUpdateBackground)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=startLocationUpdateBackground&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+## 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/location-change/location-change.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/location-change/location-change.uvue) 
+::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/API/location-change/location-change
+
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/location-change/location-change
+
+>示例
+```vue
+<template>
+  
+  <text>显示简易操作日志(可滚动查看)</text><button size="mini" @click="data.log=''">清空日志</button>
+  <scroll-view style="max-height: 300px;">
+    <text style="margin: 2px; padding: 2px; border: 1px solid #000000;">{{ data.log }}</text>
+  </scroll-view>
+  <view class="uni-list">
+    <text style="margin-bottom: 4px"> 请选择定位服务提供商：</text>
+    <radio-group class="uni-row" @change="providerChange" style="flex-wrap: wrap">
+      <view class="uni-list-cell" style="margin-right: 15px" v-for="(item, index) in data.providerList" :key="item.id">
+        <radio :value="item.id" :checked="index === data.currentSelectedProvider" />
+        <text>{{ item.name }}</text>
+      </view>
+    </radio-group>
+  </view>
+
+  <view class="uni-list">
+    <text style="margin-bottom: 4px"> 请选择坐标系：</text>
+    <radio-group class="uni-row" @change="typeChange" style="flex-wrap: wrap">
+      <view class="uni-list-cell" style="margin-right: 15px" v-for="(item, index) in types" :key="item.value">
+        <radio :value="item.value" :checked="index === data.currentSelectedType" />
+        <text>{{ item.name }}</text>
+      </view>
+    </radio-group>
+  </view>
+
+  <scroll-view style="flex:1">
+  
+    <button class="btnstyle" type="primary" @tap="startLocationUpdate" id="startLocationUpdate">点击连续定位</button>
+    <button class="btnstyle" type="primary" @tap="startLocationUpdateBackground"
+      id="startLocationUpdateBackground">后台点击连续定位</button>
+    <button class="btnstyle" type="primary" @tap="stopLocationUpdate" id="stopLocationUpdate">点击关闭定位</button>
+    <button class="btnstyle" type="primary" @tap="onLocationChange" id="onLocationChange">onLocationChange</button>
+    <button class="btnstyle" type="primary" @tap="offLocationChange" id="offLocationChange">offLocationChange</button>
+    <button class="btnstyle" type="primary" @tap="onLocationChangeError"
+      id="onLocationChangeError">onLocationChangeError</button>
+    <button class="btnstyle" type="primary" @tap="offLocationChangeError"
+      id="offLocationChangeError">offLocationChangeError</button>
+  
+  </scroll-view>
+  
+</template>
+
+
+
+<style>
+  .uni-list {
+    border-bottom: 0px;
+    background-color: transparent;
+    margin-left: 10px;
+    margin-right: 10px;
+    margin-top: 4px;
+    margin-bottom: 4px;
+  }
+
+  .uni-list-cell {
+    position: relative;
+    display: flex;
+    flex-direction: row;
+    justify-content: space-between;
+    align-items: center;
+  }
+
+  .btnstyle {
+    margin: 4px;
+  }
+</style>
+
+```
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |