更新记录

1.0.1（2026-04-17）

初始化发布

平台兼容性

其他

# yq-location

yq-location 是一个基于 UTS 的 Android 定位插件，提供单次定位、持续定位、定位服务检查、权限检查和系统设置页跳转能力。

特点

• 仅支持 Android
• 支持单次定位
• 支持持续定位
• 支持定位服务检查
• 支持权限检查
• 支持跳转系统定位设置页

平台

• App-Android
• minSdkVersion: 21

使用方法

import {
  getLocation,
  stopLocationUpdates,
  checkLocationService,
  checkPermission,
  showToast,
  startContinuousLocation,
  stopContinuousLocation,
  openLocationSettings
} from "@/uni_modules/yq-location";

基本调用

checkPermission((res) => {
  console.log("permission", res);
});

checkLocationService((res) => {
  console.log("service", res);
});

getLocation((res) => {
  console.log("single", res);
});

持续定位

startContinuousLocation((res) => {
  console.log("continuous", res);
});

stopContinuousLocation();

打开设置页

openLocationSettings((res) => {
  console.log(res);
});

回调结果

单次定位、持续定位返回：

{
  success: true,
  latitude: 39.9,
  longitude: 116.3,
  accuracy: 12.5,
  altitude: 0,
  speed: 0,
  bearing: 0,
  timestamp: 123456789,
  provider: "gps"
}

错误时返回：

{
  success: false,
  error: "错误信息"
}

注意事项

• 需要授权 ACCESS_FINE_LOCATION 或 ACCESS_COARSE_LOCATION
• 设备需开启 GPS 或网络定位
• 持续定位结束后请调用 stopContinuousLocation()