`uni.chooseLocation(OBJECT)` 是 uni-app 的 API,用于调起地图界面,供用户选择位置。

1,034 阅读1分钟

uni.chooseLocation(OBJECT) 是 uni-app 的 API,用于调起地图界面,供用户选择位置。

使用说明

此接口调用后会展示一个地图界面,用户可以在地图上选择一个位置。用户选择的位置信息将作为回调函数的参数返回。

API 结构

uni.chooseLocation({
    success: function (res) {
        console.log('选择的位置 latitude:' + res.latitude + ',longitude:' + res.longitude);
        // 用户选择的位置名称
        console.log('位置名称:' + res.name);
        // 用户选择的位置详细地址
        console.log('详细地址:' + res.address);
    },
    fail: function () {
        console.log('选择位置失败');
    },
    complete: function () {
        console.log('调用结束');
    }
});
  • success(Function):成功的回调函数,返回用户选择的地理位置信息,其中 res 参数将包含位置信息,如 latitude(纬度), longitude(经度), name(位置名), address(详细地址)等。
  • fail(Function):可选,失败的回调函数。
  • complete(Function):可选,无论成功或失败都会执行的回调函数。

示例代码

以下是一个使用 uni.chooseLocation 方法的示例:

uni.chooseLocation({
    success: function (res) {
        console.log('选择的位置:', res.name);
        console.log('纬度:' + res.latitude + ',经度:' + res.longitude);
        // 其他业务逻辑
    },
    fail: function (error) {
        console.error('Choose location failed: ' + JSON.stringify(error));
    },
    complete: function () {
        console.log('chooseLocation operation is complete');
    }
});

在调用此API前,请确保应用已获取地图服务所需的权限。

查看更多参数和详细的功能描述,可以访问 uni-app 官方文档。使用时要注意遵守相关地图服务的使用条款以及处理用户数据时要保证用户隐私安全。