小程序开放平台

文档中心
基础
路由
跳转
转发
界面
网络
支付
数据缓存
媒体
位置
getLocation
startLocationUpdate
startLocationUpdateBackground
stopLocationUpdate
onLocationChange
chooseLocation
openLocation
开放接口
设备
XHSML
性能
第三方平台
文件
数据分析
画布

xhs.chooseLocation

开发
>
JS API
>
位置
>
chooseLocation
>
更新时间:2025-04-11 16:58:31

以Promise风格调用: 支持

打开地图选择位置

参数

Object object

属性
类型
默认值
必填
说明
latitudenumber目标地纬度
longitudenumber目标地经度
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

属性
类型
说明
namestring位置名称
addressstring详细地址
latitudenumber纬度,浮点数,范围为-90~90,负数表示南纬。使用 gcj02 国测局坐标系
longitudenumber经度,浮点数,范围为-180~180,负数表示西经。使用 gcj02 国测局坐标系
errMsgstring

实例代码

function chooseLocation() {
  return new Promise((resolve, reject) => {
    xhs.chooseLocation({
      latitude: 39.9042, // 可选:目标地纬度
      longitude: 116.4074, // 可选:目标地经度
      success: (res) => {
        console.log('选择位置成功:', res);
        resolve(res); // 返回选择的位置信息
      },
      fail: (err) => {
        console.error('选择位置失败:', err);
        reject(err); // 返回错误信息
      },
      complete: () => {
        console.log('选择位置操作完成');
      }
    });
  });
}

// 调用示例
chooseLocation()
  .then((location) => {
    console.log('位置信息:', location);
  })
  .catch((error) => {
    console.error('错误信息:', error);
  });