uni-app怎么获取微信小程序的当前位置信息 uni-app持续获取经纬度【技巧】

冬杰吖_3335

冬杰吖_3335

2026-04-20

842人浏览

原创

uni.getlocation 是微信小程序获取位置的唯一可靠入口,需在 manifest.json 中声明 scope.userlocation 权限和 requiredprivateinfos、显式指定 type 参数(推荐 'gcj02')、地址解析须调用高德/腾讯服务端 api,持续定位应使用 uni.startlocationupdate + uni.onlocationchange。

uni-app怎么获取微信小程序的当前位置信息 uni-app持续获取经纬度【技巧】

uni-app 在微信小程序里获取当前位置,uni.getLocation 是唯一可靠入口,但直接调用大概率失败——不是 API 问题,而是权限、配置、坐标系三者没对齐。

manifest.json 必须声明 scope.userLocation 权限

微信强制要求提前声明定位权限,否则真机调用 uni.getLocation 会静默失败(控制台无报错,fail 回调也不触发)。必须在 manifest.json 的 mp-weixin 节点下补全:

"mp-weixin": {
  "permission": {
    "scope.userLocation": {
      "desc": "用于显示您附近的服务"
    }
  },
  "requiredPrivateInfos": ["getLocation"]
}
  • desc 字段不能为空或纯空格,否则审核可能被拒;建议用具体业务场景描述,比如“查找附近充电桩”
  • requiredPrivateInfos 是微信 2023 年起新增的隐私接口白名单,漏掉它,iOS 真机必报 errCode: -1, errMsg: getLocation:fail privacy permission is not authorized
  • HBuilderX 3.9+ 可视化配置会自动生成 permission,但不会加 requiredPrivateInfos,需手动补上

uni.getLocation 的 type 参数决定坐标系和精度

微信小程序返回的经纬度默认是 GCJ02(火星坐标系),但 uni.getLocation 的 type 参数会影响实际行为:

微信公众号自动发布增强版
微信公众号自动发布增强版

一键发布 Markdown/HTML 文章至微信公众号草稿箱,支持自动配图、排版美化、UTF‑8编码

下载
  • type: 'wgs84':返回 WGS84 坐标(GPS 原始坐标),但微信实测中部分安卓机型(如小米、华为)仍会返回 GCJ02,不可依赖
  • type: 'gcj02':明确要求 GCJ02,兼容性最好,高德/腾讯地图 SDK 解析地址时也默认按此处理
  • 不传 type:微信文档未定义行为,实测多数为 GCJ02,但 iOS 和安卓表现不一致,建议显式指定
  • 注意:uni.getLocation 不支持设置超时或重试次数,网络差时容易卡住,建议自行封装 Promise + setTimeout 包裹

地址解析必须用服务端或高德 SDK,别信 res.address

uni.getLocation 成功回调里的 res.address 字段永远是 undefined —— 这不是 bug,是微信设计如此。想拿到省市区街道,只有两条路:

  • 前端调用高德 Web 服务(需 key):引入 amap-wx.130.js,用 getRegeo 方法反查,注意 key 必须绑定微信小程序合法域名(https://restapi.amap.com 不行,得用自己备案的 HTTPS 域名代理)
  • 后端调用高德/腾讯地理编码 API:更推荐,避免 key 泄露,且可统一做缓存和限流;传 res.latitude 和 res.longitude 给后端,返回结构化地址
  • 切勿在 success 回调里硬拼“北京市朝阳区”,用户在深圳点击也会显示北京——这是新手最常踩的逻辑坑

持续定位要用 onLocationChange,不是轮询 getLocation

需要实时追踪位置(比如导航中更新车辆图标),不能 setInterval 调 uni.getLocation —— 微信限制每 5 秒最多调一次,且后台无法执行。正确做法是:

  • 先调一次 uni.startLocationUpdate(前台定位),再监听 uni.onLocationChange
  • 监听回调里拿到的 res 结构和 getLocation 一致,但频率更高(约 1~3 秒一次),且支持后台运行(需配置 mp-weixin.requiredPrivateInfos 加 startLocationUpdateBackground)
  • iOS 后台定位需额外在 manifest.json 的 mp-weixin 下加 "backgroundMode": ["location"],否则监听无效
  • 记得在页面卸载时调 uni.offLocationChange,否则内存泄漏

最难绷的是:哪怕所有配置都对,某些安卓机型(尤其 OPPO、vivo)仍会因系统级定位开关关闭而返回 fail: auth deny,此时 uni.openSetting 打开的设置页未必能直达定位开关——得引导用户手动进「设置 > 应用管理 > 小程序 > 权限」里开。

相关文章

微信app下载
微信app下载

微信是一款手机通信软件,支持通过手机网络发送语音短信、视频、图片和文字。微信可以单聊及群聊,还能根据地理位置找到附近的人,带给大家全新的移动沟通体验,有需要的小伙伴快来保存下载体验吧!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2283

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

4943

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6030

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5538

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

783

5

微信是谁开发的
微信是谁开发的

微信是由张小龙所带领的腾讯广州研发中心产品团队打造开发的,并不是马化腾开发的,而腾讯公司总裁马化腾是在产品策划的邮件中确定这款产品的名称叫做“微信”的。想了解更多微信相关的内容,可阅读本专题下面的相关文章。

2024.11.05

5515

8

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

80

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

80

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

80

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习