必须调用 wx.chooselocation,因 uni.chooselocation 在微信小程序中不生效;需在 #ifdef mp-weixin 条件编译下使用,并确保 manifest.json 配置 requiredprivateinfos、权限声明及后台接口开通。

uni-app 调用微信小程序地图选点必须用 wx.chooseLocation
uni-app 的跨端能力在地图选点上是「假跨端」——uni.chooseLocation 在微信小程序环境里根本不会调起地图,它只在 H5 和 App 端生效。真正在微信小程序里打开地图并选点,必须穿透到底层调用原生 API:wx.chooseLocation。
实操时注意:这个 API 只能在真机调试或正式环境中运行,开发者工具里会报错 fail system error 或直接静默失败。
- 必须确保
manifest.json中微信小程序配置项已填写正确 AppID,否则wx对象可能未初始化 - 需在
mp-weixin平台下条件编译,其他平台不能调用wx原生方法 - 调用前建议先判断
typeof wx !== 'undefined' && typeof wx.chooseLocation === 'function'
怎么写条件编译调用 wx.chooseLocation
不能直接写 wx.chooseLocation(...),否则 H5 或 App 端会报 wx is not defined。必须用 uni-app 官方推荐的条件编译语法包裹:
#ifdef MP-WEIXIN
wx.chooseLocation({
success: (res) => {
console.log('纬度:', res.latitude);
console.log('经度:', res.longitude);
console.log('地址:', res.address);
},
fail: (err) => {
console.error('选点失败', err);
}
});
#endif
-
#ifdef MP-WEIXIN是唯一可靠写法;/* #ifdef MP-WEIXIN */注释式写法在某些 CLI 版本中会被忽略 -
res返回的是标准微信小程序格式,latitude/longitude是字符串,需parseFloat转数字再传给后端 - 没有默认坐标,如果用户取消,
fail回调触发,err.errMsg通常是chooseLocation:fail cancel
为什么不能用 uni.getLocation 替代选点?
uni.getLocation 只能获取当前设备位置(且需用户授权),和「手动在地图上点击选择收货地址」是两回事。电商类收货地址必须支持用户自定义拖拽/搜索/点击,这是 uni.getLocation 完全无法满足的。
-
uni.getLocation返回的是经纬度,无地址文本;而wx.chooseLocation同时返回address、name、latitude、longitude,开箱即用 - 微信地图选点界面自带搜索框、周边 POI、路线预览,体验远超手写地图组件
- 若强行用
map组件 +bindmarkertap自研,要处理逆地理编码(经纬度转地址)、权限弹窗、兼容性、地图 SDK 加载失败等一堆问题
常见错误:选点后地址乱码、坐标偏移、回调不触发
这些问题基本都出在配置或环境上,和代码逻辑关系不大:
- 地址乱码 → 检查微信小程序后台「开发管理 → 开发者工具」是否启用了「增强编译」,关闭它;同时确认项目
vue.config.js里没误加transpileDependencies: ['wx'] - 坐标明显偏移(比如显示在内蒙古但实际在杭州)→ 微信地图默认使用 GCJ-02 坐标系,后端若用 WGS-84 解析就会偏移;务必前后端统一用 GCJ-02,或调用腾讯地图 API 做一次坐标转换
- 回调不触发 → 大概率是没在
onLoad或用户主动触发的事件里调用(如按钮click),微信禁止页面 onLoad 阶段自动唤起地图
地图选点看着简单,但卡在环境、配置、坐标系这三关的人最多。别急着改代码,先确认真机能跑、AppID 正确、没开增强编译、回调绑在用户可感知的操作上。











