uni-app中获取用户实时位置的操作指南

getLocation:fail the api need to be declared in the requiredPrivateInfos field in app.json/ext.json

wx.onLocationChange need to be declared in the requiredPrivateInfos field in app.json/ext.json

{
  "mp-weixin": {
    "appid": "你的小程序AppID",
    "requiredPrivateInfos": [
      "getLocation"
    ],
    "permission": {
      "scope.userLocation": {
        "desc": "你的位置信息将用于小程序定位服务"
      }
    }
  }
}

{
  "mp-weixin": {
    "appid": "你的小程序AppID",
    "requiredPrivateInfos": [
      "onLocationChange",
      "startLocationUpdate",
      "startLocationUpdateBackground"
    ],
    "permission": {
      "scope.userLocation": {
        "desc": "你的位置信息将用于小程序实时定位服务"
      }
    }
  }
}

// 检查权限并获取位置
function getCurrentLocation() {
  // 返回一个 Promise 对象，用于异步处理位置获取
  return new Promise((resolve, reject) => {
    // 调用 uni.authorize 方法检查用户是否已授权位置信息
    uni.authorize({
      scope: 'scope.userLocation', // 指定需要授权的范围为用户位置信息
      success: () => {
        // 如果用户已授权或成功授权
        uni.getLocation({
          type: 'wgs84', // 指定返回的位置坐标系为 WGS84
          success: (res) => {
            // 如果成功获取位置信息
            resolve(res); // 将位置信息通过 resolve 返回
          },
          fail: (err) => {
            // 如果获取位置信息失败
            reject(err); // 将错误通过 reject 抛出
          }
        });
      },
      fail: () => {
        // 如果用户未授权或拒绝授权
        uni.showModal({
          title: '权限提示', // 弹窗标题
          content: '需要获取您的位置信息，请前往设置开启权限', // 弹窗内容
          success: (res) => {
            // 弹窗关闭后的回调
            if (res.confirm) {
              // 如果用户点击了“确定”按钮
              uni.openSetting(); // 打开设置页面，让用户手动开启权限
            }
            // 抛出错误，提示用户拒绝授权
            reject(new Error('用户拒绝授权'));
          }
        });
      }
    });
  });
}

// 使用示例
getCurrentLocation()
  .then(res => console.log('位置信息:', res)) // 如果成功获取位置信息，打印位置信息
  .catch(err => console.error('获取位置失败:', err)); // 如果获取位置失败，打印错误信息

let locationListener = null;

// 开始监听位置变化
function startLocationUpdate() {
  return new Promise((resolve, reject) => {
    uni.authorize({
      scope: 'scope.userLocation',
      success: () => {
        wx.startLocationUpdate({
          success: () => {
            locationListener = wx.onLocationChange(res => {
              console.log('位置变化:', res);
              // 在这里处理位置变化逻辑
            });
            resolve();
          },
          fail: (err) => {
            reject(err);
          }
        });
      },
      fail: () => {
        uni.showModal({
          title: '权限提示',
          content: '需要持续获取您的位置信息，请前往设置开启权限',
          success: (res) => {
            if (res.confirm) {
              uni.openSetting();
            }
            reject(new Error('用户拒绝授权'));
          }
        });
      }
    });
  });
}

// 停止监听
function stopLocationUpdate() {
  if (locationListener) {
    wx.stopLocationUpdate();
    wx.offLocationChange(locationListener);
    locationListener = null;
  }
}

// 使用示例
startLocationUpdate()
  .then(() => console.log('已开始监听位置变化'))
  .catch(err => console.error('开启监听失败:', err));

// 需要停止时调用
// stopLocationUpdate();

wx.startLocationUpdateBackground({
  success: () => {
    console.log('后台定位已开启');
    wx.onLocationChange((res) => {
      console.log('后台位置变化:', res);
    });
  },
  fail: (err) => {
    console.error('后台定位开启失败:', err);
  }
});

// 设置超时机制
function getLocationWithTimeout(timeout = 10000) {
  return new Promise((resolve, reject) => {
    const timer = setTimeout(() => {
      reject(new Error('获取位置超时'));
    }, timeout);
    
    uni.getLocation({
      type: 'wgs84',
      success: (res) => {
        clearTimeout(timer);
        resolve(res);
      },
      fail: (err) => {
        clearTimeout(timer);
        reject(err);
      }
    });
  });
}

uni.getSetting({
  success(res) {
    if (res.authSetting['scope.userLocation']) {
      console.log('已授权位置权限');
    }
  }
});

uni.getSetting({
  success(res) {
    if (res.authSetting['scope.userLocation']) {
      console.log('已授权位置权限');
    }
  }
});