uni.chooseLocation在App端无法返回坐标？

Question

在使用 `uni.chooseLocation` 实现地图选点功能时，部分开发者反馈在 App 端调用后无法返回经纬度坐标，仅能获取地址描述信息。该问题常见于 Android 平台的原生 App（如通过 uni-app 打包的 APK），主要原因是未正确配置高德或腾讯地图 SDK 的 AppKey，或未在 manifest 中声明定位权限。此外，H5 端依赖浏览器定位，而原生 App 需通过原生插件支持坐标返回。若未集成对应地图插件或 Key 配置错误，将导致坐标获取失败。需确保已在项目中正确配置第三方地图服务并申请合法密钥，同时检查是否开启“位置信息”权限。

Answer 1

1. 问题背景与现象描述

在使用 uni.chooseLocation 实现地图选点功能时，开发者普遍反馈：在 App 端（尤其是 Android 平台的原生 APK）调用该 API 后，仅能获取地址描述信息（如“北京市朝阳区XX大厦”），而无法返回经纬度坐标（latitude 和 longitude）。这一问题严重影响了需要精确地理坐标的业务场景，例如位置打卡、路径规划或 POI 标注。

H5 端通常依赖浏览器的 Geolocation API，可正常返回坐标；但在原生 App 中，由于底层依赖第三方地图 SDK（如高德、腾讯地图），若未正确集成插件或配置密钥，则会导致坐标缺失。

2. 核心原因分析

• 未配置地图 SDK 的 AppKey：uni-app 在 App 端默认使用高德地图（Android）或腾讯地图（iOS）作为地图服务提供方。若未在 manifest.json 中填写正确的 AppKey，SDK 初始化失败，导致无法获取精确坐标。
• 缺少定位权限声明：Android 平台需在 AndroidManifest.xml 中显式声明位置权限，否则系统将拒绝访问 GPS 数据。
• 未启用原生地图插件：部分项目未勾选或未安装 DCloud 提供的地图原生插件（如“高德地图插件”），导致 chooseLocation 退化为纯前端地址搜索，不返回坐标。
• H5 与 App 端实现机制差异：H5 使用浏览器定位 + 地图 JS API 反查地址，而 App 端依赖原生桥接调用，二者逻辑分离，容易造成开发误解。

3. 深度排查流程图

graph TD
    A[调用 uni.chooseLocation] --> B{是否为 H5 端?}
    B -- 是 --> C[检查浏览器是否支持 Geolocation]
    B -- 否 --> D[检查 manifest.json 是否配置地图 AppKey]
    D --> E{AppKey 是否有效?}
    E -- 否 --> F[申请并填写合法 Key]
    E -- 是 --> G[检查 AndroidManifest.xml 权限]
    G --> H[是否包含 ACCESS_FINE_LOCATION?]
    H -- 否 --> I[添加权限并重新打包]
    H -- 是 --> J[确认是否启用原生地图插件]
    J --> K{插件已启用?}
    K -- 否 --> L[在 HBuilderX 中启用高德/腾讯地图插件]
    K -- 是 --> M[测试真机运行结果]
    

4. 关键配置项与代码示例

以下是解决该问题的核心配置步骤：

1. 申请地图平台 AppKey：前往高德开放平台（https://lbs.amap.com）注册应用，获取 Android 平台 SHA1 + 包名绑定的 API Key。
2. 配置 manifest.json：

{
  "app-plus": {
    "distribute": {
      "android": {
        "permissions": [
          "<uses-permission android:name=\"android.permission.ACCESS_FINE_LOCATION\"/>",
          "<uses-permission android:name=\"android.permission.ACCESS_COARSE_LOCATION\"/>"
        ]
      },
      "maps": {
        "amap": {
          "apikey": "你的高德AppKey"
        }
      }
    }
  }
}

注意：iOS 若使用腾讯地图，需对应配置 qqmap 节点。

5. 原生插件启用与构建验证

在 HBuilderX 中，必须手动启用地图插件：

步骤	操作说明
1	打开项目根目录下的 manifest.json
2	进入“App模块配置”页签
3	勾选“Maps(地图)” -> “高德地图(Android)” 或 “腾讯地图(iOS)”
4	重新云打包或本地打包生成 APK

未启用插件时，uni.chooseLocation 将降级为基于关键词搜索的伪地图选择器，无法返回坐标。

6. 运行时权限处理建议

即使 manifest 已声明权限，Android 6.0+ 需动态请求。推荐在调用前添加权限检测：

uni.authorize({
  scope: 'scope.userLocation',
  success() {
    uni.chooseLocation({
      success: (res) => {
        console.log('地址:', res.address);
        console.log('纬度:', res.latitude); // 正常情况下应有值
        console.log('经度:', res.longitude);
      },
      fail: err => {
        console.error('选点失败', err);
      }
    });
  },
  fail: () => {
    uni.showToast({ title: '请开启位置权限', icon: 'none' });
  }
});

此模式可提升用户体验，并避免因权限拒绝导致的静默失败。

7. 跨平台行为对比表

平台	地图引擎	是否需 AppKey	是否需原生插件	能否返回坐标
H5	浏览器 Geolocation + 第三方 JS API	视地图库而定	否	是（依赖用户授权）
App-Android	高德地图 SDK	是	是	配置正确时可返回
App-iOS	腾讯地图 SDK	是	是	配置正确时可返回
微信小程序	微信地图组件	否	否	是

可见，App 端对原生能力依赖更强，配置复杂度显著高于其他端。