uni.getLocation失败主因是权限配置、平台限制和坐标系错配;uni.chooseLocation仅适用于微信小程序或真机App,H5不可用;uni.openLocation需严格匹配参数类型与gcj02坐标系。

uni.getLocation 能拿到真实坐标,但**不是调用一次就完事**——平台限制、权限配置、坐标系错配这三关没过,返回的 { latitude: 0, longitude: 0 } 或 getLocation:fail systemError: Location module is not available 就是常态。
uni.getLocation 失败主因是权限没配全或用户没授权
它在 iOS、Android、H5、微信小程序上行为完全不同,不是代码错了,是环境卡住了:
- iOS 微信浏览器直接拒绝定位,
uni.getLocation静默失败(不进 success 也不进 fail) - Android App 默认没开后台定位权限,manifest.json 里只勾了「定位」还不够,必须确认
android.permission.ACCESS_FINE_LOCATION已写入 - H5 端依赖浏览器地理位置 API,Chrome 89+ 要求 HTTPS + 用户主动触发(比如按钮点击),
onLoad里直接调用会被拦截 - 微信小程序必须在
manifest.json的mp-weixin.permission下声明scope.userLocation,且 desc 字段不能为空字符串
实操建议:
- 首次调用前,先走
uni.authorize({ scope: 'scope.location' })主动申请,再调uni.getLocation,避免弹窗未完成就发请求 - iOS 需在
manifest.json → iOS 设置填NSLocationWhenInUseUsageDescription(值不能是空字符串) - App 端打包前检查
manifest.json → 模块配置 → Maps是否启用(高德 or 百度),否则type: 'gcj02'会降级为wgs84甚至报错
uni.chooseLocation 在 H5 上直接不可用
uni.chooseLocation 不是纯 JS 方法,它依赖宿主地图能力:
- 微信小程序:自动唤起腾讯地图
- App 真机:需原生地图 SDK 支持(manifest.json 中 Maps 模块已启用)
- H5:调用即报错
chooseLocation:fail api not exists,没有替代方案
常见错误现象:
- 返回
{ address: '', name: '', latitude: 0, longitude: 0 }—— 地图 SDK 没就位或权限未通过 - iOS App 上
address字段常为空,应优先取name和经纬度,自行做逆地理编码
使用场景很明确:只适合微信小程序或打包成 App 后的真机调试,H5 页面别碰这个 API。
uni.openLocation 打不开?参数类型和坐标系必须严格匹配
uni.openLocation 是跳转动作,本质是拼 URL 或调原生地图 App,参数稍有偏差就会白屏或报错 openLocation:fail invalid data:
- 所有参数必须是字符串类型:
latitude、longitude、name、address都得转成 string,数字类型直接被拒 - 经纬度必须合法:不能是
0、null、NaN,也不能超出范围(纬度 -90~90,经度 -180~180) - 坐标系要对齐:
uni.getLocation返回的是wgs84,但uni.openLocation要求gcj02(国测局偏移坐标),直接传会导致地图定位偏移几公里
实操建议:
- 用
uni.getSystemInfoSync().platform === 'ios'判断平台,iOS/Android/App 端可配合transformFromWGS84库转换,H5 端建议走高德/腾讯 Web API 做服务端纠偏 - App 端更稳的方式是用
plus.geolocation.getCurrentPosition(需uni-app-plus扩展),它默认返回gcj02,和uni.openLocation天然兼容
map 组件显示定位点,show-location 不可靠
<map></map> 上设 show-location="true" 只在微信小程序和 App 端生效,H5 完全不支持;而且它不处理坐标系偏移,直接导致标记漂移。
更可靠的做法是手动控制:
- 调用
uni.getLocation成功后,把res.latitude和res.longitude传给center-lat/center-lng - 用
markers数组添加一个自定义标记,显式设置图标、气泡等 - 注意坐标系:高德/腾讯地图用
gcj02,uni.getLocation默认返回wgs84,不转换就传进去,地图上点会偏移 500 米以上
容易被忽略的关键点:
- App 端若用了原生地图(如 DCloud 提供的
uni-app-plus扩展),plus.geolocation比uni.getLocation更稳定,尤其在弱网或室内场景 - 微信小程序基础库低于 2.10.4 时,部分 iOS 机型无法唤起地图,需检查
project.config.json的libVersion - 不要依赖
geocode: true获取地址——它仅 App 平台支持,且需type: 'gcj02'+ 地图 SDK 配置完整,H5 和小程序都不认这个参数


















