Appearance
qin.openLocation(OBJECT)
使用应用内置地图查看位置。
平台差异说明
| H5 | 微信小程序 | 小红书小程序 | 抖音小程序 | 快手小程序 |
|---|---|---|---|---|
| √ | √ | √ | √ | x |
OBJECT 参数说明
| 参数名 | 类型 | 必填 | 说明 | 平台差异说明 |
|---|---|---|---|---|
| latitude | Float | 是 | 纬度,范围为 -90~90 ,负数表示南纬,使用 gcj02 国测局坐标系 | |
| longitude | Float | 是 | 经度,范围为 -180~180 ,负数表示西经,使用 gcj02 国测局坐标系 | |
| scale | Int | 否 | 缩放比例,范围为 5~18 ,默认为 18 | 微信小程序 |
| name | String | 否 | 位置名 | 支付宝必填 |
| address | String | 否 | 地址的详细说明 | 支付宝必填 |
| success | Function | 否 | 接口调用成功的回调函数 | |
| fail | Function | 否 | 接口调用失败的回调函数 | |
| complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例
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万/年)。