`uni.onLocationChange` 是 uni-app 的实时地理位置变化监听 API,可以用来持续获取用户的当前位置信息。

1,077 阅读1分钟

uni.onLocationChange 是 uni-app 的实时地理位置变化监听 API,可以用来持续获取用户的当前位置信息。

使用说明

使用 uni.onLocationChange 后,每次设备位置变化时,都会执行回调函数 CALLBACK。你可以在这个回调函数中获取到包括经纬度在内的位置信息。

API 结构

uni.onLocationChange(function (result) {
    console.log('当前位置的纬度:' + result.latitude);
    console.log('当前位置的经度:' + result.longitude);
});
  • result(Object):回调函数的参数,包含当前位置的信息,如纬度(latitude)和经度(longitude)等。

示例代码

以下是一个使用 uni.onLocationChange 的示例:

uni.onLocationChange(function (result) {
    console.log('位置变化:', result);
    // 你可以在这里更新位置信息,或执行其他相关的业务逻辑
});

要注意的是,当不需要继续接收位置变化信息时,应该调用 uni.offLocationChange 方法来取消监听,以避免不必要的性能消耗。

// 取消监听
uni.offLocationChange(function () {
    console.log('位置变化监听已关闭');
});

注意事项

  • 开启位置变化监听时,会持续使用 GPS 功能,这可能会增加电池的耗电量。
  • 此接口需在 manifest.json 配置中声明使用位置服务权限。
  • 确保用户已经同意使用位置权限。
  • 在不需要监听位置变化时,记得关闭监听以节约资源。

有关详细信息,建议查阅 uni-app 官方文档