uni-app如何获取地理位置 uni-app地图定位功能实现方法【实战】

作者：袖梨 2026-07-29

uni.getLocation 在不同平台行为差异大：iOS微信拒绝定位，Android App需手动开启后台权限，H5需HTTPS+用户主动触发；uni.chooseLocation仅支持微信小程序和App真机调试，H5不支持；uni.openLocation参数须全为字符串且经纬度合法；自定义地图应缓存mapContext并用onLocationChange替代轮询。

平台差异，是 uni.getLocation 取不到坐标时的首要排查项

uni-app 的 uni.getLocation 代码本身并未写错，各端表现有别来自严格的平台限制：定位会被 iOS 微信浏览器直接拒绝，后台定位权限在 Android App 中默认关闭；浏览器则决定 H5 端的能力，Chrome 89+ 只有在 HTTPS 环境且用户主动触发时才会响应，例如点击按钮，否则失败过程没有提示。

常见错误现象：getLocation:fail systemError: Location module is not available 或返回 { errMsg: "getLocation:ok", latitude: 0, longitude: 0 } —— 这是降级兜底值，不是真实位置。

App 端需要在 manifest.json 中手动勾选「定位」权限，iOS 还需填写 NSLocationWhenInUseUsageDescription 描述
H5 端不要在 onLoad 中直接调用，应改成点击按钮后触发，以免被浏览器拦截
微信小程序需要预先在 app.json 的 permission 字段中声明 scope.userLocation

地图 SDK 配置，是排查 uni.chooseLocation 空结果的关键

uni.chooseLocation 宿主环境提供的地图能力是它的依赖，因此它不属于纯 JS 方法：原生地图 SDK 是 App 端的必要支持，腾讯地图由微信小程序自动采用；至于 H5 端，则因完全不受支持而在调用时直接报错 chooseLocation:fail api not exists。

它的适用范围很清楚：仅适合微信小程序，或打包为 App 后进行真机调试，H5 页面不要使用这个 API。

App 端打包之前确认 manifest.json → 模块配置 → Maps 已经启用（高德 or 百度）
微信小程序应在 project.config.json 内配置 libVersion 部分机型只有达到 ≥ 2.10.4 才能唤起地图
返回结果里的 address iOS App 上该字段存在空值可能，应把获取优先级给到 name 并利用经纬度自行进行逆地理编码

参数与协议是否匹配，决定 uni.openLocation 能否调起地图

uni.openLocation 它属于跳转动作，而不是渲染组件。本质上，它会拼接 URL 或唤起原生地图 App，因此参数略有偏差便可能出现白屏或报错 openLocation:fail invalid data。

必须全部采用字符串类型，是这些参数的关键要求；对于数字则要 toString()；latitude 和 longitude 必须为合法小数，例如 39.9087，不可使用 39.90870000000001）；到了 H5 端，能够支持的只有高德、百度、腾讯三家 URL 协议，同时 scheme 不可缺少。

App 端传入 name 和 address 并非必需，但微信小程序一定要传 name，不然地图不会显示标题
H5 端建议加兜底逻辑：try { uni.openLocation(...) } catch { window.location.href = 'https://uri.amap.com/marker?position=...' }
如果 iOS App 跳转后出现黑屏，经纬度超出范围的可能性很高，纬度为 ±90、经度为 ±180，应先完成校验再调用