wx.startLocationUpdateBackground

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']后使用
• 获取位置信息需配置地理位置用途说明。