# wx.startLocationUpdateBackground(Object object)
基础库 2.8.0 开始支持,低版本需做兼容处理。
以 Promise 风格 调用:支持
用户授权:需要 scope.userLocationBackground
小程序插件:不支持
微信 鸿蒙 OS 版:支持
相关文档: 地理位置接口新增与相关流程调整
# 功能描述
开启小程序在前后台时均可接收位置消息,后台包括离开小程序后继续使用微信(微信仍在前台)、离开微信(微信在后台)两个场景,需引导用户开启授权。授权以后,小程序在运行中或进入后台均可接受位置消息变化。
# 使用方法
自 2022 年 7 月 14 日后发布的小程序,若使用该接口,需要在 app.json 中进行声明,否则将无法正常使用该接口,2022年7月14日前发布的小程序不受影响。具体规则见公告
# 申请开通
暂只针对如下类目的小程序开放,需要先通过类目审核,再在小程序管理后台,「开发」-「开发管理」-「接口设置」中自助开通该接口权限。从2022年7月14日开始,在代码审核环节将检测该接口是否已完成开通,如未开通,将在代码提审环节进行拦截。
# 国内主体开放类目
一级类目/主体类型 | 二级类目 | 应用场景 |
---|---|---|
电商平台 | / | 在小程序内提供线下商超导览、导航服务 |
商家自营 | / | 在小程序内提供线下商超导览、导航服务 |
交通服务 | / | 代驾服务、打车出行、城市共享交通、实时导航服务等 |
生活服务 | 跑腿、共享服务 | 含有B端小程序配送服务,基于地理位置共享工具类服务 |
物流服务 | 收件/派件、查件、邮政、装卸搬运、快递柜、货物运输 | 提供B端小程序快递/货物收发服务 |
餐饮服务 | 点餐平台、外卖平台 | 提供B端小程序餐饮配送服务、线下门店实时导航 |
工具 | 健康管理 | 基于实时地理位置提供身体管理记录等服务 |
旅游 | 景区服务、住宿服务 | 在小程序内提供景区导航、导览服务、酒店导航服务 |
政务民生 | / | 提供政务单位相关业务 |
政府主体账号 | / | 提供政务单位相关业务 |
# 海外主体开放类目
一级类目/主体类型 | 二级类目 | 应用场景 |
---|---|---|
交通服务 | / | 代驾服务、打车出行、城市共享交通、实时导航服务等 |
生活服务 | 家政、外送 | 含有B端小程序配送服务,基于地理位置导航上门服务 |
快递业与邮政 | / | 提供B端小程序快递/货物收发服务 |
餐饮服务 | 外卖点餐 | 提供B端小程序餐饮配送服务、线下门店实时导航 |
电商平台 | / | 在小程序内提供线下商超导览、导航服务 |
跨境电商 | / | 在小程序内提供线下商超导览、导航服务 |
本地服务 | 服装/鞋/箱包、玩具、家电/数码/手机、美妆/洗护、珠宝/饰品/眼镜/钟表、运动/户外/乐器、鲜花/园艺/工艺品、家居/家饰/家纺、办公/文具、机械/电子器件、酒、食品、百货/超市/便利店、宠物食品/用品 | 在小程序内提供线下商超导览、导航服务 |
# 参数
# Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
type | string | gcj02 | 否 | wgs84 返回 gps 坐标,gcj02 返回可用于 wx.openLocation 的坐标 |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
# 注意
- 安卓微信7.0.6版本,iOS 7.0.5版本起支持该接口
- 需在app.json中配置requiredBackgroundModes: ['location']后使用
- 获取位置信息需配置地理位置用途说明。