# wx.onLocationChange(function listener)

基础库 2.8.1 开始支持,低版本需做兼容处理

小程序插件:不支持

微信 鸿蒙 OS 版:支持

# 功能描述

监听实时地理位置变化事件,需结合 wx.startLocationUpdateBackgroundwx.startLocationUpdate使用。

# 使用方法

自 2022 年 7 月 14 日后发布的小程序,若使用该接口,需要在 app.json 中进行声明,否则将无法正常使用该接口,2022年7月14日前发布的小程序不受影响。具体规则见公告

# 申请开通

暂只针对如下类目的小程序开放,需要先通过类目审核,再在小程序管理后台,「开发」-「开发管理」-「接口设置」中自助开通该接口权限。 接口权限申请入口将于2022年3月11日开始内测,于3月31日全量上线。并从4月18日开始,在代码审核环节将检测该接口是否已完成开通,如未开通,将在代码提审环节进行拦截。

# 国内主体开放类目

一级类目/主体类型 二级类目 应用场景
电商平台 / 售卖商品线下发货、收货、送货服务
商家自营 / 提供售卖商品线下发货、收货、送货服务、线下商超导览、导航服务
医疗服务 公立医疗机构、三级私立医疗机构、其他私立医疗机构、就医服务、其他医学健康服务、药品(非处方药)销售、非处方药销售平台、医疗器械生产企业、医疗器械自营、医疗器械经营销售平台、互联网医院血液、干细胞服务、临床试验 1、实际物品/药品接收服务 2、基于地理位置取号并现场报到、附近医院导航等服务
交通服务 / 代驾服务、租车网点导航等相关服务
生活服务 / 上门服务作业等线下场景
物流服务 收件/派件、查件、邮政、装卸搬运、快递柜、货物运输 快递/货物收发服务
餐饮服务 点餐平台、外卖平台 线下送餐服务
工具 天气、信息查询 与地理位置相关的服务,比如潮汐查询、海拔查询、天气查询等
金融 保险 提供线下网点预约、基于地理位置取号并现场报到、附近网点导航等服务
旅游 景区服务 提供景区导航、导览服务
政务民生 / 提供政务单位相关业务
政府主体账号 / 提供政务单位相关业务

# 海外主体开放类目

一级类目/主体类型 二级类目 应用场景
出行与交通 / 代驾服务、租车网点导航等相关服务
快递业与邮政 / 快递/货物收发服务
餐饮 / 线下送餐服务
电商平台 / 售卖商品线下发货、线下收货服务
出行与交通 / 代驾服务、租车网点导航等相关服务
跨境电商 / 提供售卖商品线下发货、收货服务、线下商超导览、导航服务
本地服务 服装/鞋/箱包、玩具、家电/数码/手机、美妆/洗护、珠宝/饰品/眼镜/钟表、运动/户外/乐器、鲜花/园艺/工艺品、家居/家饰/家纺、办公/文具、机械/电子器件、酒、食品、百货/超市/便利店、宠物食品/用品 提供售卖商品线下发货、线下收货服务、线下商超导览、导航服务
生活服务 家政、外送 上门服务作业等线下场景

# 参数

# function listener

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

# 参数

# Object res
属性 类型 说明 最低版本
latitude number 纬度,范围为 -90~90,负数表示南纬。使用 gcj02 国测局坐标系
longitude number 经度,范围为 -180~180,负数表示西经。使用 gcj02 国测局坐标系
speed number 速度,单位 m/s
accuracy number 位置的精确度
altitude number 高度,单位 m 1.2.0
verticalAccuracy number 垂直精度,单位 m(Android 无法获取,返回 0) 1.2.0
horizontalAccuracy number 水平精度,单位 m 1.2.0

# 示例代码

 const _locationChangeFn = function(res) {
  console.log('location change', res)
 }
 wx.onLocationChange(_locationChangeFn)
 wx.offLocationChange(_locationChangeFn)