Skip to content

qin.openLocation(OBJECT) ​

使用应用内置地图查看位置。

平台差异说明

H5微信小程序小红书小程序抖音小程序快手小程序
√√√√x

OBJECT 参数说明

参数名类型必填说明平台差异说明
latitudeFloat是纬度,范围为 -90~90 ,负数表示南纬,使用 gcj02 国测局坐标系
longitudeFloat是经度,范围为 -180~180 ,负数表示西经,使用 gcj02 国测局坐标系
scaleInt否缩放比例,范围为 5~18 ,默认为 18微信小程序
nameString否位置名支付宝必填
addressString否地址的详细说明支付宝必填
successFunction否接口调用成功的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数(调用成功、失败都会执行)

示例

js
qin.getLocation({
  type: 'gcj02', //返回可以用于qin.openLocation的经纬度
  success: (thRes) => {
    const latitude = thRes.latitude;
    const longitude = thRes.longitude;
    qin.openLocation({
      latitude: latitude,
      longitude: longitude,
      success: () => {
        console.log('success');
      },
    });
  },
});
qin.getLocation({
  type: 'gcj02', //返回可以用于qin.openLocation的经纬度
  success: (thRes) => {
    const latitude = thRes.latitude;
    const longitude = thRes.longitude;
    qin.openLocation({
      latitude: latitude,
      longitude: longitude,
      success: () => {
        console.log('success');
      },
    });
  },
});

注意

  • 本 API 是一个非原子的封装界面,开发者如有定制需求,可自己做页面实现类似功能。
  • 若定位不准,参考 qin.getLocation 文档的注意事项
  • <map> 组件默认为国测局坐标,调用 qin.getLocation 返回结果传递给 <map> 组件时,需指定 type 为 gcj02。
  • H5 端使用地图和定位相关,需要在 manifest.json 内配置腾讯或谷歌等三方地图服务商申请的秘钥 (key)。
  • 不同平台打开的地图不一样,H5端是腾讯地图或谷歌地图、微信小程序端是腾讯地图、百度小程序是百度地图、阿里小程序是高德地图、抖音小程序是高德地图。

三方定位和地图服务收费说明 ​

使用三方定位或者地图服务,需向服务提供商(如:高德地图、百度地图、腾讯地图、谷歌地图)申请商业授权和缴纳费用(5万/年)。