文章目录
- 一、获取当前的地理位置、速度 uni.getLocation(OBJECT)
- 二、打开地图选择位置 uni.chooseLocation(OBJECT)
- 三、使用应用内置地图查看位置。uni.openLocation(OBJECT)
一、获取当前的地理位置、速度 uni.getLocation(OBJECT)
- App平台 manifest中配置好自己的地图厂商key，在地图厂商的后台，填写正确包名和证书摘要。地图厂商的sdk会在运行时校验key、包名、证书的一致性
- Web平台 manifest中配置好自己的地图厂商key，使用web接口如涉及白名单，需确保自己的域名在地图厂商那里正确配置了域名白名单
- 确保在地图厂商那里配额足够
- 确保在地图厂商那里有周边服务的权限。否则无法获取周围地址
- 如果运行在微信浏览器中，可以使用微信的jssdk的定位能力。这个是微信向腾讯地图申请的key，开发者无需配置自己的key。
- OBJECT 参数说明
参数名 类型 必填 说明 平台差异说明 type String 否 默认为 wgs84 返回 gps 坐标，gcj02 返回国测局坐标，可用于 uni.openLocation 和 map 组件坐标，App 和 H5 需配置定位 SDK 信息才可支持 gcj02。 altitude Boolean 否 传入 true 会返回高度信息，由于获取高度需要较高精确度，会减慢接口返回速度 抖音小程序、飞书小程序、支付宝小程序不支持 geocode Boolean 否 默认false，是否解析地址信息 仅App平台支持（安卓需指定 type 为 gcj02 并配置三方定位SDK） highAccuracyExpireTime Number 否 高精度定位超时时间(ms)，指定时间内返回最高精度，该值3000ms以上高精度定位才有效果 App (3.2.11+)、H5 (3.2.11+)、微信小程序 (基础库 2.9.0+) timeout String 否 默认为 5，定位超时时间，单位秒 仅飞书小程序支持 cacheTimeout Number 否 定位缓存超时时间，单位秒；每次定位缓存当前定位数据，并记下时间戳，当下次调用在cacheTimeout之内时，返回缓存数据 仅飞书小程序、支付宝小程序支持 accuracy String 否 默默认为 high，指定期望精度，支持 high，best。当指定 high 时，期望精度值为100m，当指定 best 时期望精度值为20m。当定位得到的精度不符合条件时，在timeout之前会继续定位，尝试拿到符合要求的定位结果 仅飞书小程序支持 isHighAccuracy Boolean 否 开启高精度定位 App (3.4.0+)、H5 (3.4.0+)、微信小程序 (基础库 2.9.0+) success Function 是 接口调用成功的回调函数，返回内容详见返回参数说明。 fail Function 否 接口调用失败的回调函数 complete Function 否 接口调用结束的回调函数（调用成功、失败都会执行） - success 返回参数说明
参数 说明 latitude 纬度，浮点数，范围为-90~90，负数表示南纬 longitude 经度，浮点数，范围为-180~180，负数表示西经 speed 速度，浮点数，单位m/s accuracy 位置的精确度 altitude 高度，单位 m verticalAccuracy 垂直精度，单位 m（Android 无法获取，返回 0） horizontalAccuracy 水平精度，单位 m address 地址信息（仅App端支持，需配置geocode为true） <template><view style="padding: 20px;"><button @click="getLocation">获取地理位置</button></view> </template><script> export default {data() {return {};},onLoad() {},methods: {getLocation() {uni.getLocation({type: 'wgs84',success: function (res) {console.log(res)console.log('当前位置的经度：' + res.longitude);console.log('当前位置的纬度：' + res.latitude);}})}}, }; </script>
需要配置权限，若没有配置会有弹窗提示
若没有配置会有弹窗提示
配置完，需要点击允许
二、打开地图选择位置 uni.chooseLocation(OBJECT)
- 如果是cli或离线打包，需要配套升级cli和离线sdk
- manifest中配置好自己的地图厂商key。web和app都需要。一般标准基座正常，自定义基座和打包后异常，都是这个原因
- 确保在地图厂商那里配额足够
- 确保在地图厂商那里有周边服务的权限。否则无法获取周围地址
- web平台确保自己的域名在地图厂商那里正确配置了域名白名单
可使用差异：App，H5，微信小程序，支付宝小程序，百度小程序，抖音小程序、飞书小程序，QQ小程序
- OBJECT 参数说明
参数名 类型 必填 说明 平台差异说明 latitude Number 否 目标地纬度 微信小程序（2.9.0+）、H5-Vue3（3.2.10+） longitude Number 否 目标地经度 微信小程序（2.9.0+）、H5-Vue3（3.2.10+） keyword String 否 搜索关键字，仅App平台支持 useSecureNetwork Boolean 否 是否通过安全网络调用地点搜索、逆地址解析，默认false success Function 是 接口调用成功的回调函数，返回内容详见返回参数说明。 fail Function 否 接口调用失败的回调函数（获取定位失败、用户取消等情况下触发） complete Function 否 接口调用结束的回调函数（调用成功、失败都会执行） - success 返回参数说明
参数 说明 name 位置名称 address 详细地址 latitude 纬度，浮点数，范围为-90~90，负数表示南纬，使用 gcj02 国测局坐标系。 longitude 经度，浮点数，范围为-180~180，负数表示西经，使用 gcj02 国测局坐标系。 <template><view style="padding: 20px;"><button @click="getLocation">获取地理位置</button></view> </template><script> export default {data() {return {};},onLoad() {},methods: {getLocation() {uni.chooseLocation({success: function (res) {console.log(res)console.log('位置名称：' + res.name);console.log('详细地址：' + res.address);console.log('纬度：' + res.latitude);console.log('经度：' + res.longitude);}});}}, }; </script>
点击确认后打印的位置
注意：- 不同端，使用地图选择时基于的底层地图引擎不一样，详见地图map组件的地图服务商支持。
- app 中也可以使用百度定位，在 manifest 中配置，打包后生效。
- app-nvue 里只能用高德定位和Google地图(3.4+)，不能用百度地图。另外选择地图、查看地图位置的API也仅支持高德地图和Google地图(3.4+)。所以App端如无特殊必要，建议使用高德地图。
- H5 端 使用地图和定位相关，需要在 manifest.json 内配置腾讯或谷歌等三方地图服务商申请的秘钥（key）。
- 微信内置浏览器 中可使用微信js sdk，详见
- chooseLocation 属于封装型API，开发者若觉得不够灵活，可自行基于原始的 map 组件进行封装。插件市场已经有各种封装样例了。
- 若 Android App端 位置不准，见上文 uni.getLocation 的注意事项
- 微信小程序在2023年10月17日之后，使用API需要配置隐私协议
- 不同端，使用地图选择时基于的底层地图引擎不一样，详见地图map组件的地图服务商支持。
三、使用应用内置地图查看位置。uni.openLocation(OBJECT)
可使用差异：App，H5，微信小程序，支付宝小程序， 百度小程序 ，抖音小程序、飞书小程序，元服务 小红书小程序
- 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 | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
<template><view style="padding: 20px;"><button @click="getLocation">获取地理位置</button></view>
</template><script>
export default {data() {return {};},onLoad() {},methods: {getLocation() {uni.getLocation({type: 'gcj02', //返回可以用于uni.openLocation的经纬度success: function (res) {console.log(res)const latitude = res.latitude;const longitude = res.longitude;uni.openLocation({latitude: latitude,longitude: longitude,success: function (succ) {console.log(succ, 'success');}});}});}},
};
</script>
