wx.onLocationChange

wx.onLocationChange(function listener)

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

小程序插件：不支持

微信 鸿蒙 OS 版：支持

功能描述

监听实时地理位置变化事件，需结合 wx.startLocationUpdateBackground、wx.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)