uni-app鸿蒙定位权限配置与API实战：getLocation+ch

鸿蒙专家

在基于uni-app开发鸿蒙应用时，定位和地图选点是最常见的基础能力之一。uni-app提供了两个核心API——uni.getLocation（获取当前坐标）和uni.chooseLocation（打开地图让用户选择位置），它们在鸿蒙NEXT 5.0上均可正常使用，但需要完成一系列关键的权限配置，否则API调用会直接失败。本文从权限配置开始，梳理完整的调用流程与踩坑经验。

一、uni.getLocation：获取当前位置

最简单的GPS坐标获取方式如下：

2. uni.getLocation({
3.   type: 'wgs84',
4.   success: function (res) {
5.     console.log('经度：' + res.longitude);
6.     console.log('纬度：' + res.latitude);
7.     console.log('精度：' + res.accuracy);
8.   },
9.   fail: function (err) {
10.     console.error('定位失败：' + JSON.stringify(err));
11.   }
12. });

复制代码

type参数可选wgs84（国际标准GPS坐标）或gcj02（国测局坐标，适用于map组件和uni.openLocation）。返回信息包含经纬度、精度等。

如果需要更高精度，可启用isHighAccuracy参数：

2. uni.getLocation({
3.   type: 'gcj02',
4.   isHighAccuracy: true,
5.   highAccuracyExpireTime: 5000,  // 超时时间，单位ms
6.   success: function (res) {
7.     console.log('高精度定位结果：', res.latitude, res.longitude);
8.   }
9. });

复制代码

当isHighAccuracy为true时，鸿蒙会申请精确位置权限（ohos.permission.LOCATION），否则仅申请模糊位置权限（ohos.permission.APPROXIMATELY_LOCATION）。

二、uni.chooseLocation：打开地图选位置

用于让用户在地图上选取地点（如填写收货地址），返回坐标格式为gcj02：

2. uni.chooseLocation({
3.   success: function (res) {
4.     console.log('位置名称：' + res.name);
5.     console.log('详细地址：' + res.address);
6.     console.log('纬度：' + res.latitude);
7.     console.log('经度：' + res.longitude);
8.   }
9. });

复制代码

三、鸿蒙定位权限配置（最容易踩坑的部分）

不配好权限，定位API完全无法使用。需要按照以下步骤操作：

1. 复制module.json5
从HBuilderX产物目录复制：

2. unpackages/dist/dev/app-harmony/entry/src/main/module.json5
3. → 复制到 →
4. [HBuilderX工程目录]/harmony-configs/entry/src/main/module.json5

复制代码

2. 复制string.json

2. unpackages/dist/dev/app-harmony/entry/src/main/resources/base/element/string.json
3. → 复制到 →
4. [HBuilderX工程目录]/harmony-configs/entry/src/main/resources/base/element/string.json

复制代码

3. 添加定位权限
在module.json5的requestPermissions中追加：

2. {
3.   "name": "ohos.permission.APPROXIMATELY_LOCATION",
4.   "reason": "$string:location_reason",
5.   "usedScene": {
6.     "when": "inuse"
7.   }
8. },
9. {
10.   "name": "ohos.permission.LOCATION",
11.   "reason": "$string:location_reason",
12.   "usedScene": {
13.     "when": "inuse"
14.   }
15. }

复制代码

两个权限必须同时存在，缺一不可。APPROXIMATELY_LOCATION是模糊定位，LOCATION是精确位置，通过isHighAccuracy参数切换。

4. 配置权限说明文案
编辑string.json，添加定位用途说明：

2. {
3.   "name": "location_reason",
4.   "value": "用于为您推荐附近的商家和服务"
5. }

复制代码

注意：module.json5中reason字段必须用$string:引用string.json中的key，不能直接写中文，否则编译会报错。

四、地图服务商配置

uni.getLocation和uni.chooseLocation底层依赖地图服务商。鸿蒙平台需要在manifest.json中配置地图厂商的key：
manifest.json → App模块配置 → 定位(geolocation) → 选择服务商并填写key。

常用服务商：高德、百度、腾讯。三方定位和地图服务需要商业授权，费用约5万/年；个人项目或测试可用免费额度。

注意：鸿蒙上uni.chooseLocation依然使用manifest中配置的key，与Android/iOS不同（Android/iOS上地点搜索需通过uni-map-co云对象，因为安全网络限制）。

五、实际场景代码示例

场景一：获取当前位置并展示在地图上

2. uni.getLocation({
3.   type: 'gcj02',
4.   success: function (res) {
5.     this.latitude = res.latitude;
6.     this.longitude = res.longitude;
7.   }
8. });

复制代码

2. <map
3.   :latitude="latitude"
4.   :longitude="longitude"
5.   :markers="[{latitude: latitude, longitude: longitude, title: '当前位置'}]"
6.   style="width: 100%; height: 300px;">
7. </map>

复制代码

场景二：填写收货地址

2. uni.chooseLocation({
3.   success: function (res) {
4.     this.addressName = res.name;
5.     this.addressDetail = res.address;
6.     this.latitude = res.latitude;
7.     this.longitude = res.longitude;
8.   }
9. });

复制代码

场景三：判断定位权限是否开启

2. uni.getSetting({
3.   success: function (res) {
4.     if (!res.authSetting['scope.userLocation']) {
5.       uni.showModal({
6.         title: '需要位置权限',
7.         content: '请开启位置权限以获取更好的服务',
8.         success: function (res) {
9.           if (res.confirm) {
10.             uni.openSetting();
11.           }
12.         }
13.       });
14.     }
15.   }
16. });

复制代码

六、踩坑记录与注意事项

1. 模糊定位和精确定位必须同时申请
如果只申请APPROXIMATELY_LOCATION而不申请LOCATION，高精度定位不可用；反之上架审核会不通过。正确的做法是两个权限都声明，通过isHighAccuracy控制使用哪个。

2. 权限弹窗时机与引导
鸿蒙的定位权限弹窗仅在用户首次打开App时弹出一次。如果用户拒绝，需要通过uni.getSetting检查权限状态，再引导用户手动开启。

3. 鸿蒙4（非纯血）不支持系统定位
如果目标设备是鸿蒙4（非鸿蒙NEXT 5.0），需要配置三方定位SDK（如高德），并设置type: 'gcj02'。纯血鸿蒙5.0没有此问题。

4. 真机调试与正式打包
使用HBuilderX标准基座运行到真机，定位正常（基座内置DCloud的key）。但打包正式应用后，必须更换为manifest中自己配置的key，否则定位会失效。

5. 验证环境
uni-app 4.36+、HBuilderX 4.36+、DevEco Studio 5.0.3.400、HarmonyOS NEXT 5.0.0.29。

总结：在uni-app鸿蒙开发中，定位与地图选点功能的核心难点不在API调用本身，而在于权限配置的细节。严格按照上述步骤配置module.json5和string.json，同时注意权限弹窗的引导逻辑，即可稳定实现定位功能。

热心网友3

感谢楼主分享，干货满满！我之前在鸿蒙上搞定位时就是卡在权限配置那一步，差点被module.json5和string.json的引用给绕晕。按你写的方法配好两个定位权限后，getLocation和chooseLocation终于能正常跑起来了。 一个小补充：如果用了高精度定位，记得在真机上也要手动开启“精确位置”开关（系统设置里），否则即使代码里配了ohos.permission.LOCATION，实际返回的还是模糊坐标。另外地图服务商key在鸿蒙上最好选支持鸿蒙SDK的，之前我用某家key跑chooseLocation一直报错，换了一家就好了。不知道楼主有没有碰到过类似的情况？

热心网友3

感谢楼主分享这么详细的鸿蒙定位API实战教程！权限配置部分确实容易踩坑，特别是module.json5和string.json的复制路径，还有两个权限必须同时配置这点，如果不注意很容易导致定位失败。另外关于`isHighAccuracy`参数切换精确/模糊权限的说明也很清晰，以前没留意到鸿蒙上这个参数会直接影响权限申请类型。 想请教一下，如果只使用`uni.chooseLocation`（不调用getLocation），是否也需要同时配置`APPROXIMATELY_LOCATION`和`LOCATION`两个权限？还是说选位置只需要其中一个？另外地图服务商配置中，如果选择高德，在鸿蒙上是否也需要像Android一样申请高德平台的专用key？谢谢！

热心网友3

感谢楼主分享，非常详细！权限配置那块确实是坑，我之前就是漏了APPROXIMATELY_LOCATION，导致一直失败。看了你的教程，才意识到两个权限必须同时配。另外高精度定位那个参数切换权限的解释也很清楚，之前一直没搞懂什么时候用精确什么时候用模糊。对了，你提到地图服务商需要商业授权，个人项目用免费额度的话，具体是哪家的免费额度比较够用？