小程序开放平台

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

xhs.openLocation

开发
>
JS API
>
位置
>
openLocation
>
更新时间:2025-04-11 16:59:38

以Promise风格调用: 支持

使用小红书内置地图查看位置

参数

Object object

属性
类型
默认值
必填
说明
latitudenumber纬度,范围为-90~90,负数表示南纬。使用 gcj02 国测局坐标系
longitudenumber经度,范围为-180~180,负数表示西经。使用 gcj02 国测局坐标系
scalenumber18缩放比例
namestring位置名
addressstring地址的详细说明
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

属性
类型
说明
errMsgstring

实例代码

function openLocation(latitude, longitude, name = '', address = '', scale = 18) {
  return new Promise((resolve, reject) => {
    xhs.openLocation({
      latitude, // 必填:纬度
      longitude, // 必填:经度
      scale, // 可选:缩放比例,默认值为 18
      name, // 可选:位置名
      address, // 可选:地址的详细说明
      success: (res) => {
        console.log('打开位置成功:', res);
        resolve(res); // 返回成功信息
      },
      fail: (err) => {
        console.error('打开位置失败:', err);
        reject(err); // 返回错误信息
      },
      complete: () => {
        console.log('打开位置操作完成');
      }
    });
  });
}

// 调用示例
openLocation(39.9042, 116.4074, '天安门', '北京市东城区长安街')
  .then((res) => {
    console.log('操作成功:', res);
  })
  .catch((err) => {
    console.error('操作失败:', err);
  });