uni.getLocation(OBJECT)
是 uni-app 提供的一个API,用于获取当前设备的地理位置信息。
使用说明
此方法可以获取设备的当前位置,通常用于地图显示或位置信息的获取。它可以返回经度和纬度等信息,并且可以指定是否需要高精度的位置信息。
API 结构
javascript
uni.getLocation({
type: 'wgs84', // 默认值
success: function (res) {
console.log('Latitude: ' + res.latitude + ', Longitude: ' + res.longitude);
}
});
type
(String):可选值为wgs84
或gcj02
,指定返回的位置数据是国际标准的GPS坐标还是经过国内加密的坐标。success
(Function):成功获取位置后的回调函数,res
参数中将包含位置信息。fail
(Function):可选,获取位置失败的回调。complete
(Function):可选,接口调用结束的回调函数(调用成功、失败都会执行)。
示例代码
以下是调用 uni.getLocation
方法的一个基本示例:
javascript
uni.getLocation({
type: 'gcj02', // 返回可以用于uni.openLocation的坐标
success: function (res) {
console.log('Latitude: ' + res.latitude + ', Longitude: ' + res.longitude);
// 可以将 res.longitude 和 res.latitude 用于地图展示等
},
fail: function (error) {
console.error('Location acquisition failed: ' + JSON.stringify(error));
},
complete: function () {
console.log('getLocation operation is complete');
}
});
在使用这个API之前,确保已经向用户请求了位置信息的权限,并且用户已经同意。
更多详情和参数设置,可以参考 uni-app官方文档。使用这个API时,请注意用户隐私和法律法规对位置信息的相关要求。