# wx.startLocationUpdateBackground(Object object)

> 基础库 2.8.0 开始支持，低版本需做[兼容处理](1003706)。

> __以 [Promise 风格](/miniprogram/dev/framework/app-service/api.md#异步-API-返回-Promise) 调用__：支持
> 
> __[用户授权](/miniprogram/dev/framework/open-ability/authorize.md)__：需要 scope.userLocationBackground
> 
> __小程序插件__：不支持
> 
> __微信 鸿蒙 OS 版__：支持

> 相关文档: [地理位置接口新增与相关流程调整](/community/develop/doc/000a02f2c5026891650e7f40351c01)

## 功能描述

开启小程序在前后台时均可接收位置消息，后台包括离开小程序后继续使用微信（微信仍在前台）、离开微信（微信在后台）两个场景，需引导用户开启[授权](/miniprogram/dev/framework/open-ability/authorize.md#后台定位)。授权以后，小程序在运行中或进入后台均可接受位置消息变化。
  ## 使用方法
 自 2022 年 7 月 14 日后发布的小程序，若使用该接口，需要在 app.json 中进行声明，否则将无法正常使用该接口，2022年7月14日前发布的小程序不受影响。[具体规则见公告](https://developers.weixin.qq.com/community/develop/doc/000a02f2c5026891650e7f40351c01)

  ## 申请开通
  暂只针对如下类目的小程序开放，需要先通过类目审核，再在小程序管理后台，「开发」-「开发管理」-「接口设置」中自助开通该接口权限。从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']后使用
- 获取位置信息需配置[地理位置用途说明](/miniprogram/dev/reference/configuration/app.md#permission)。