Uniapp实现地图获取定位功能

摘要：本文将手把手教你如何在Uniapp项目中集成地图功能、实现定位获取，并解决微信小程序、APP、H5三端的兼容性问题🚀🚀🚀

---

一、环境准备

1. 地图平台选择

   • 微信小程序：腾讯地图（强制使用）
   • H5/APP：可自由选择（高德/百度/谷歌地图）
   • 推荐方案：H5/APP使用高德地图（API免费额度高）

2. 申请开发者密钥

   • 微信小程序：需在微信公众平台申请mapKey
   • 高德地图：前往高德开放平台创建应用并获取Web端Key和Android/iOS Key

---

二、配置地图基础功能

2.1 微信小程序配置

1. manifest.json配置

   "mp-weixin": {"appid": "你的小程序ID","setting": {"urlCheck": false},"usingComponents": true,"permission": {"scope.userLocation": {"desc": "需要获取您的位置以提供地图服务"}},"requiredPrivateInfos": ["getLocation"]
   }
   

2. 页面中使用map组件

   <map id="myMap" style="width: 100%; height: 300px;" :latitude="latitude" :longitude="longitude"show-location
   ></map>
   

---

2.2 H5/APP配置（以高德地图为例）

1. manifest.json注入SDK

   "h5": {"sdkConfigs": {"maps": {"amap": {"key": "你的高德Web端Key"}}}
   },
   "app": {"maps": {"amap": {"iosKey": "iOS端Key","androidKey": "Android端Key"}}
   }
   

2. 通过uni.chooseLocation调用地图

   uni.chooseLocation({success: (res) => {console.log('位置名称：' + res.name);console.log('经纬度：', res.latitude, res.longitude);}
   });
   

---

三、获取用户定位

3.1 基础定位实现

// 获取经纬度
uni.getLocation({type: 'wgs84', // 微信小程序必须为wgs84success: (res) => {this.latitude = res.latitude;this.longitude = res.longitude;},fail: (err) => {uni.showToast({ title: '获取定位失败', icon: 'none' });}
});

3.2 定位转具体地址（逆地理编码）

// 需配合高德API（H5/APP示例）
import amap from '@/common/amap-wx.js'; // 从高德官网下载SDKconst amapPlugin = new amap.AMapWX({key: '你的高德Web端Key'
});amapPlugin.getRegeo({location: `${longitude},${latitude}`,success: (data) => {console.log('详细地址：', data[0].regeocodeData.formatted_address);}
});

---

四、多平台适配要点

4.1 条件编译处理差异

<!-- 微信小程序使用原生map组件 -->
<!-- #ifdef MP-WEIXIN -->
<map ...></map>
<!-- #endif --><!-- H5/APP使用第三方地图 -->
<!-- #ifdef H5 || APP -->
<web-view :src="amapUrl"></web-view>
<!-- #endif -->

4.2 权限配置

• Android：在manifest.json中添加：

  "android": {"permissions": ["<uses-permission android:name=\"android.permission.ACCESS_COARSE_LOCATION\"/>","<uses-permission android:name=\"android.permission.ACCESS_FINE_LOCATION\"/>"]
  }
  

• iOS：需在manifest.json中勾选Location usage description

---

五、常见问题及解决方案

问题现象	原因分析	解决方案
微信小程序地图不显示	未配置mapKey	在微信公众平台申请并配置mapKey
H5定位失败	非HTTPS环境	本地开发使用Chrome开启--unsafely-treat-insecure-origin-as-secure
APP返回错误代码LOCATION_FAILED	未开启定位权限	检查manifest配置并引导用户手动开启权限
逆地理编码返回null	未绑定安全域名（H5）	在高德控制台添加当前域名白名单

---

注意点

1. 统一坐标系：微信小程序使用wgs84，高德地图用gcj02，需注意转换
2. 错误兜底：定位失败时显示手动选择位置按钮
3. 性能优化：使用<map>组件的@regionchange事件懒加载标记点