# uni.onLocationChange(callback)

监听实时地理位置变化事件

# onLocationChange 兼容性

Web 微信小程序 Android iOS HarmonyOS
4.0 4.41 4.73 x x

# 参数

名称 类型 必填 默认值 兼容性 描述
listener (res: GetLocationSuccess) => void - - -

# GetLocationSuccess 的属性值

名称 类型 必备 默认值 兼容性 描述
latitude number 0
纬度,浮点数,范围为-90~90,负数表示南纬
longitude number 0
经度,范围为-180~180,负数表示西经
speed number 0
速度,浮点数,单位m/s
accuracy number -
位置的精确度
altitude number 0
高度,单位 m
verticalAccuracy number 0
垂直精度,单位 m(Android 无法获取,返回 0)
horizontalAccuracy number 0
水平精度,单位 m
address string null
地址信息

# 返回值

类型
number

# 参见

# uni.offLocationChange(callback)

移除实时地理位置变化事件。

# offLocationChange 兼容性

Web 微信小程序 Android iOS HarmonyOS
4.0 4.41 4.73 x x

# 参数

名称 类型 必填 默认值 兼容性 描述
listener number | (res: GetLocationSuccess) => void - - -

# GetLocationSuccess 的属性值

名称 类型 必备 默认值 兼容性 描述
latitude number 0
纬度,浮点数,范围为-90~90,负数表示南纬
longitude number 0
经度,范围为-180~180,负数表示西经
speed number 0
速度,浮点数,单位m/s
accuracy number -
位置的精确度
altitude number 0
高度,单位 m
verticalAccuracy number 0
垂直精度,单位 m(Android 无法获取,返回 0)
horizontalAccuracy number 0
水平精度,单位 m
address string null
地址信息

# 参见

# uni.onLocationChangeError(callback)

监听持续定位接口返回失败时触发。

# onLocationChangeError 兼容性

Web 微信小程序 Android iOS HarmonyOS
4.0 4.41 4.73 x x

# 参数

名称 类型 必填 默认值 兼容性 描述
listener (listener: IGetLocationFail) => void - - -

# IGetLocationFail 的属性值

名称 类型 必备 默认值 兼容性 描述
errCode number - - 错误码
合法值 兼容性 描述
1505003
系统定位未开启,请在系统设置中开启系统定位
1505004
应用定位权限未开启
1505023
不支持逆地理编码
1505600
超时
1505601
不支持的定位类型
1505602
捕获定位失败
1505603
逆地理编码捕获失败
1505604
服务供应商获取失败
1505605
未通过配置预校验,通常是腾讯定位 api key 配置错误
1505607
腾讯定位只支持GCJ-02
1505608
GPS 服务已关闭
1505700
不支持逆地理编码
1505701
没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请确定系统定位是否开启
1505800
应用高精度定位权限未开启
1505026
捕获定位失败 从4.25开始已经废弃
1505025
逆地理编码捕获失败 从4.25开始已经废弃
1505024
没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请定位开关是否已打开 从4.25开始已经废弃
1505022
不支持的定位类型 从4.25开始已经废弃
1505021
超时 从4.25开始已经废弃
1505005
缺失高精度权限授权(iOS特有) 从4.25开始已经废弃
errSubject string - - 统一错误主题(模块)名称
data any - - 错误信息中包含的数据
cause Error - - 源错误信息,可以包含多个错误,详见SourceError
errMsg string - - -

# 返回值

类型
number

# 参见

# 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
系统定位未开启,请在系统设置中开启系统定位
1505004
应用定位权限未开启
1505023
不支持逆地理编码
1505600
超时
1505601
不支持的定位类型
1505602
捕获定位失败
1505603
逆地理编码捕获失败
1505604
服务供应商获取失败
1505605
未通过配置预校验,通常是腾讯定位 api key 配置错误
1505607
腾讯定位只支持GCJ-02
1505608
GPS 服务已关闭
1505700
不支持逆地理编码
1505701
没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请确定系统定位是否开启
1505800
应用高精度定位权限未开启
1505026
捕获定位失败 从4.25开始已经废弃
1505025
逆地理编码捕获失败 从4.25开始已经废弃
1505024
没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请定位开关是否已打开 从4.25开始已经废弃
1505022
不支持的定位类型 从4.25开始已经废弃
1505021
超时 从4.25开始已经废弃
1505005
缺失高精度权限授权(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
系统定位未开启,请在系统设置中开启系统定位
1505004
应用定位权限未开启
1505023
不支持逆地理编码
1505600
超时
1505601
不支持的定位类型
1505602
捕获定位失败
1505603
逆地理编码捕获失败
1505604
服务供应商获取失败
1505605
未通过配置预校验,通常是腾讯定位 api key 配置错误
1505607
腾讯定位只支持GCJ-02
1505608
GPS 服务已关闭
1505700
不支持逆地理编码
1505701
没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请确定系统定位是否开启
1505800
应用高精度定位权限未开启
1505026
捕获定位失败 从4.25开始已经废弃
1505025
逆地理编码捕获失败 从4.25开始已经废弃
1505024
没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请定位开关是否已打开 从4.25开始已经废弃
1505022
不支持的定位类型 从4.25开始已经废弃
1505021
超时 从4.25开始已经废弃
1505005
缺失高精度权限授权(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
系统定位未开启,请在系统设置中开启系统定位
1505004
应用定位权限未开启
1505023
不支持逆地理编码
1505600
超时
1505601
不支持的定位类型
1505602
捕获定位失败
1505603
逆地理编码捕获失败
1505604
服务供应商获取失败
1505605
未通过配置预校验,通常是腾讯定位 api key 配置错误
1505607
腾讯定位只支持GCJ-02
1505608
GPS 服务已关闭
1505700
不支持逆地理编码
1505701
没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请确定系统定位是否开启
1505800
应用高精度定位权限未开启
1505026
捕获定位失败 从4.25开始已经废弃
1505025
逆地理编码捕获失败 从4.25开始已经废弃
1505024
没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请定位开关是否已打开 从4.25开始已经废弃
1505022
不支持的定位类型 从4.25开始已经废弃
1505021
超时 从4.25开始已经废弃
1505005
缺失高精度权限授权(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
系统定位未开启,请在系统设置中开启系统定位
1505004
应用定位权限未开启
1505023
不支持逆地理编码
1505600
超时
1505601
不支持的定位类型
1505602
捕获定位失败
1505603
逆地理编码捕获失败
1505604
服务供应商获取失败
1505605
未通过配置预校验,通常是腾讯定位 api key 配置错误
1505607
腾讯定位只支持GCJ-02
1505608
GPS 服务已关闭
1505700
不支持逆地理编码
1505701
没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请确定系统定位是否开启
1505800
应用高精度定位权限未开启
1505026
捕获定位失败 从4.25开始已经废弃
1505025
逆地理编码捕获失败 从4.25开始已经废弃
1505024
没有找到具体的定位引擎(GPS_PROVIDER,NETWORK_PROVIDER,PASSIVE_PROVIDER等),请定位开关是否已打开 从4.25开始已经废弃
1505022
不支持的定位类型 从4.25开始已经废弃
1505021
超时 从4.25开始已经废弃
1505005
缺失高精度权限授权(iOS特有) 从4.25开始已经废弃
errSubject string - - 统一错误主题(模块)名称
data any - - 错误信息中包含的数据
cause Error - - 源错误信息,可以包含多个错误,详见SourceError
errMsg string - - -

# 参见

# 通用类型

# GeneralCallbackResult

名称 类型 必备 默认值 兼容性 描述
errMsg string -
错误信息