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