小程序开放平台

文档中心
基础
路由
跳转
转发
界面
网络
支付
数据缓存
媒体
位置
getLocation
startLocationUpdate
startLocationUpdateBackground
stopLocationUpdate
onLocationChange
chooseLocation
openLocation
开放接口
设备
XHSML
性能
第三方平台
文件
数据分析
画布

xhs.startLocationUpdateBackground

开发
>
JS API
>
位置
>
startLocationUpdateBackground
>
更新时间:2025-04-11 15:04:09

以Promise风格调用: 支持

开启小程序进入前后台时均接收位置消息,需引导用户开启授权。授权以后,小程序在运行中或进入后台均可接受位置消息变化。

参数

Object object

属性
类型
默认值
必填
说明
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

属性
类型
说明
errMsgstring

实例代码

// 示例代码:以 Promise 风格调用 startLocationUpdateBackground
function startLocationUpdateBackground() {
  return new Promise((resolve, reject) => {
    xhs.startLocationUpdateBackground({
      success: (res) => resolve(res),
      fail: (err) => reject(err),
    });
  });
}

// 调用示例
startLocationUpdateBackground()
  .then((res) => {
    console.log('后台位置更新开启成功:', res.errMsg);
  })
  .catch((err) => {
    console.error('后台位置更新开启失败:', err);
  });