uni.onLocationChange(callback)
监听实时地理位置变化事件
onLocationChange 兼容性
Web | 微信小程序 | Android | iOS | HarmonyOS |
4.0 | 4.41 | 4.73 | x | x |
参数
GetLocationSuccess 的属性值
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
latitude | number | 是 | 0 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 纬度,浮点数,范围为-90~90,负数表示南纬 |
longitude | number | 是 | 0 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 经度,范围为-180~180,负数表示西经 |
speed | number | 是 | 0 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
| 速度,浮点数,单位m/s |
accuracy | number | 是 | - |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
| 位置的精确度 |
altitude | number | 是 | 0 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
| 高度,单位 m |
verticalAccuracy | number | 是 | 0 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | 4.41 | 3.9.0 | 4.11 | x |
| 垂直精度,单位 m(Android 无法获取,返回 0) |
horizontalAccuracy | number | 是 | 0 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | 4.41 | 3.9.0 | 4.11 | x |
| 水平精度,单位 m |
address | string | 否 | null |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| x | x | 3.9.0 | 4.11 | x |
| 地址信息 |
返回值
参见
uni.offLocationChange(callback)
移除实时地理位置变化事件。
offLocationChange 兼容性
Web | 微信小程序 | Android | iOS | HarmonyOS |
4.0 | 4.41 | 4.73 | x | x |
参数
GetLocationSuccess 的属性值
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
latitude | number | 是 | 0 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 纬度,浮点数,范围为-90~90,负数表示南纬 |
longitude | number | 是 | 0 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 经度,范围为-180~180,负数表示西经 |
speed | number | 是 | 0 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
| 速度,浮点数,单位m/s |
accuracy | number | 是 | - |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
| 位置的精确度 |
altitude | number | 是 | 0 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
| 高度,单位 m |
verticalAccuracy | number | 是 | 0 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | 4.41 | 3.9.0 | 4.11 | x |
| 垂直精度,单位 m(Android 无法获取,返回 0) |
horizontalAccuracy | number | 是 | 0 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | 4.41 | 3.9.0 | 4.11 | x |
| 水平精度,单位 m |
address | string | 否 | null |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| x | x | 3.9.0 | 4.11 | x |
| 地址信息 |
参见
uni.onLocationChangeError(callback)
监听持续定位接口返回失败时触发。
onLocationChangeError 兼容性
Web | 微信小程序 | Android | iOS | HarmonyOS |
4.0 | 4.41 | 4.73 | x | x |
参数
IGetLocationFail 的属性值
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
errCode | number | 是 | - | - | 错误码 |
合法值 | 兼容性 | 描述 | 1505003 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 系统定位未开启,请在系统设置中开启系统定位 | 1505004 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 应用定位权限未开启 | 1505023 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 不支持逆地理编码 | 1505600 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 超时 | 1505601 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 不支持的定位类型 | 1505602 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 捕获定位失败 | 1505603 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 逆地理编码捕获失败 | 1505604 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 服务供应商获取失败 | 1505605 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 未通过配置预校验,通常是腾讯定位 api key 配置错误 | 1505607 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 腾讯定位只支持GCJ-02 | 1505608 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.73 | x | - |
| GPS 服务已关闭 | 1505700 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 不支持逆地理编码 | 1505701 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请确定系统定位是否开启 | 1505800 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 应用高精度定位权限未开启 | 1505026 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 捕获定位失败 从4.25开始已经废弃 | 1505025 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 逆地理编码捕获失败 从4.25开始已经废弃 | 1505024 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请定位开关是否已打开 从4.25开始已经废弃 | 1505022 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 不支持的定位类型 从4.25开始已经废弃 | 1505021 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 超时 从4.25开始已经废弃 | 1505005 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 缺失高精度权限授权(iOS特有) 从4.25开始已经废弃 |
|
errSubject | string | 是 | - | - | 统一错误主题(模块)名称 |
data | any | 否 | - | - | 错误信息中包含的数据 |
cause | Error | 否 | - | - | 源错误信息,可以包含多个错误,详见SourceError |
errMsg | string | 是 | - | - | - |
返回值
参见
uni.offLocationChangeError(callback)
移除监听持续定位接口返回失败事件。
offLocationChangeError 兼容性
Web | 微信小程序 | Android | iOS | HarmonyOS |
4.0 | 4.41 | 4.73 | x | x |
参数
名称 | 类型 | 必填 | 默认值 | 兼容性 | 描述 |
listener | number | (listener: IGetLocationFail) => void | 否 | - | - | - |
IGetLocationFail 的属性值
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
errCode | number | 是 | - | - | 错误码 |
合法值 | 兼容性 | 描述 | 1505003 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 系统定位未开启,请在系统设置中开启系统定位 | 1505004 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 应用定位权限未开启 | 1505023 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 不支持逆地理编码 | 1505600 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 超时 | 1505601 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 不支持的定位类型 | 1505602 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 捕获定位失败 | 1505603 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 逆地理编码捕获失败 | 1505604 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 服务供应商获取失败 | 1505605 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 未通过配置预校验,通常是腾讯定位 api key 配置错误 | 1505607 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 腾讯定位只支持GCJ-02 | 1505608 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.73 | x | - |
| GPS 服务已关闭 | 1505700 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 不支持逆地理编码 | 1505701 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请确定系统定位是否开启 | 1505800 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 应用高精度定位权限未开启 | 1505026 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 捕获定位失败 从4.25开始已经废弃 | 1505025 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 逆地理编码捕获失败 从4.25开始已经废弃 | 1505024 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请定位开关是否已打开 从4.25开始已经废弃 | 1505022 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 不支持的定位类型 从4.25开始已经废弃 | 1505021 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 超时 从4.25开始已经废弃 | 1505005 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 缺失高精度权限授权(iOS特有) 从4.25开始已经废弃 |
|
errSubject | string | 是 | - | - | 统一错误主题(模块)名称 |
data | any | 否 | - | - | 错误信息中包含的数据 |
cause | Error | 否 | - | - | 源错误信息,可以包含多个错误,详见SourceError |
errMsg | string | 是 | - | - | - |
参见
uni.startLocationUpdate(options)
开启应用进入前台时接收位置消息。
startLocationUpdate 兼容性
Web | 微信小程序 | Android | iOS | HarmonyOS |
4.0 | 4.41 | 4.73 | x | x |
参数
名称 | 类型 | 必填 | 默认值 | 兼容性 | 描述 |
options | StartLocationUpdateOptions | 是 | - | - | |
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 | provider | string | 否 | - | - | | type | string | 否 | - | - | - | 合法值 | 兼容性 | 描述 | wgs84 | - | - | gcj02 | - | - |
| success | () => void | 否 | - | - | | fail | (result: IGetLocationFail) => void | 否 | - | - | | complete | (result: any) => void | 否 | - | - | |
|
IGetLocationFail 的属性值
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
errCode | number | 是 | - | - | 错误码 |
合法值 | 兼容性 | 描述 | 1505003 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 系统定位未开启,请在系统设置中开启系统定位 | 1505004 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 应用定位权限未开启 | 1505023 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 不支持逆地理编码 | 1505600 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 超时 | 1505601 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 不支持的定位类型 | 1505602 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 捕获定位失败 | 1505603 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 逆地理编码捕获失败 | 1505604 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 服务供应商获取失败 | 1505605 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 未通过配置预校验,通常是腾讯定位 api key 配置错误 | 1505607 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 腾讯定位只支持GCJ-02 | 1505608 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.73 | x | - |
| GPS 服务已关闭 | 1505700 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 不支持逆地理编码 | 1505701 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请确定系统定位是否开启 | 1505800 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 应用高精度定位权限未开启 | 1505026 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 捕获定位失败 从4.25开始已经废弃 | 1505025 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 逆地理编码捕获失败 从4.25开始已经废弃 | 1505024 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请定位开关是否已打开 从4.25开始已经废弃 | 1505022 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 不支持的定位类型 从4.25开始已经废弃 | 1505021 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 超时 从4.25开始已经废弃 | 1505005 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 缺失高精度权限授权(iOS特有) 从4.25开始已经废弃 |
|
errSubject | string | 是 | - | - | 统一错误主题(模块)名称 |
data | any | 否 | - | - | 错误信息中包含的数据 |
cause | Error | 否 | - | - | 源错误信息,可以包含多个错误,详见SourceError |
errMsg | string | 是 | - | - | - |
参见
uni.stopLocationUpdate(options)
关闭监听实时位置变化,前后台都停止消息接收。
stopLocationUpdate 兼容性
Web | 微信小程序 | Android | iOS | HarmonyOS |
4.0 | 4.41 | 4.73 | x | x |
参数
名称 | 类型 | 必填 | 默认值 | 兼容性 | 描述 |
options | StopLocationUpdateOptions | 是 | - | - | |
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 | provider | string | 否 | - | - | | success | () => void | 否 | - | - | | fail | (result: IGetLocationFail) => void | 否 | - | - | | complete | (result: any) => void | 否 | - | - | |
|
IGetLocationFail 的属性值
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
errCode | number | 是 | - | - | 错误码 |
合法值 | 兼容性 | 描述 | 1505003 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 系统定位未开启,请在系统设置中开启系统定位 | 1505004 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 应用定位权限未开启 | 1505023 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 不支持逆地理编码 | 1505600 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 超时 | 1505601 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 不支持的定位类型 | 1505602 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 捕获定位失败 | 1505603 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 逆地理编码捕获失败 | 1505604 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 服务供应商获取失败 | 1505605 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 未通过配置预校验,通常是腾讯定位 api key 配置错误 | 1505607 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 腾讯定位只支持GCJ-02 | 1505608 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.73 | x | - |
| GPS 服务已关闭 | 1505700 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 不支持逆地理编码 | 1505701 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请确定系统定位是否开启 | 1505800 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 应用高精度定位权限未开启 | 1505026 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 捕获定位失败 从4.25开始已经废弃 | 1505025 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 逆地理编码捕获失败 从4.25开始已经废弃 | 1505024 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请定位开关是否已打开 从4.25开始已经废弃 | 1505022 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 不支持的定位类型 从4.25开始已经废弃 | 1505021 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 超时 从4.25开始已经废弃 | 1505005 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 缺失高精度权限授权(iOS特有) 从4.25开始已经废弃 |
|
errSubject | string | 是 | - | - | 统一错误主题(模块)名称 |
data | any | 否 | - | - | 错误信息中包含的数据 |
cause | Error | 否 | - | - | 源错误信息,可以包含多个错误,详见SourceError |
errMsg | string | 是 | - | - | - |
参见
uni.startLocationUpdateBackground(option)
开始监听实时地理位置信息变化事件,应用进入前后台时均接收实时地理位置信息。
startLocationUpdateBackground 兼容性
Web | 微信小程序 | Android | iOS | HarmonyOS |
4.0 | 4.41 | 4.73 | x | x |
参数
名称 | 类型 | 必填 | 默认值 | 兼容性 | 描述 |
options | StartLocationUpdateBackgroundOptions | 是 | - | - | |
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 | provider | string | 否 | - | - | | type | string | 否 | - | - | - | 合法值 | 兼容性 | 描述 | wgs84 | - | - | gcj02 | - | - |
| success | () => void | 否 | - | - | | fail | (result: IGetLocationFail) => void | 否 | - | - | | complete | (result: any) => void | 否 | - | - | |
|
IGetLocationFail 的属性值
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
errCode | number | 是 | - | - | 错误码 |
合法值 | 兼容性 | 描述 | 1505003 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 系统定位未开启,请在系统设置中开启系统定位 | 1505004 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 应用定位权限未开启 | 1505023 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 不支持逆地理编码 | 1505600 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 超时 | 1505601 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 不支持的定位类型 | 1505602 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 捕获定位失败 | 1505603 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 逆地理编码捕获失败 | 1505604 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 服务供应商获取失败 | 1505605 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 未通过配置预校验,通常是腾讯定位 api key 配置错误 | 1505607 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 腾讯定位只支持GCJ-02 | 1505608 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.73 | x | - |
| GPS 服务已关闭 | 1505700 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 不支持逆地理编码 | 1505701 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请确定系统定位是否开启 | 1505800 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | - | 4.25 | 4.25 | - |
| 应用高精度定位权限未开启 | 1505026 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 捕获定位失败 从4.25开始已经废弃 | 1505025 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 逆地理编码捕获失败 从4.25开始已经废弃 | 1505024 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请定位开关是否已打开 从4.25开始已经废弃 | 1505022 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 不支持的定位类型 从4.25开始已经废弃 | 1505021 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 超时 从4.25开始已经废弃 | 1505005 |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| 4.0 | - | 3.9.0 | 4.11 | 4.61 |
| 缺失高精度权限授权(iOS特有) 从4.25开始已经废弃 |
|
errSubject | string | 是 | - | - | 统一错误主题(模块)名称 |
data | any | 否 | - | - | 错误信息中包含的数据 |
cause | Error | 否 | - | - | 源错误信息,可以包含多个错误,详见SourceError |
errMsg | string | 是 | - | - | - |
参见
通用类型
GeneralCallbackResult
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
errMsg | string | 是 | - |
Web
|
微信小程序
|
Android
|
iOS
|
HarmonyOS
| - | 4.41 | - | - | - |
| 错误信息 |