Flutter使用geocoding包iOS端无法从地址描述获取经纬度如何解决

• Android端从地址描述解析对应经纬度功能运行正常
• iOS端先后测试geocoder、flutter_geocoder、location_geocoder等多款地理编码插件，均无法正常完成解析
• 原有地理编码实现逻辑参考：
  

你用的这几款插件基本都是停止维护3年以上的老旧插件，在iOS端失效是必然的：

• 未适配iOS 14+的权限规则：哪怕你只做地址转坐标、不需要获取用户当前位置，iOS 14及以上版本也要求App必须配置位置权限描述，否则地理编码接口会被直接拦截无响应，这几个老插件都没做相关适配和提示
• 未遵守苹果原生CLGeocoder的调用规则：苹果要求地理编码接口必须在主线程调用，且有严格的频率限制，短时间高频调用会直接被封停接口返回空结果，老插件基本都没做线程切换和频率限制处理
• 部分插件依赖谷歌移动服务做地理编码，iOS端默认没有GMS环境，自然无法运行

优先方案：替换为官方维护的geocoding插件 #

这是目前双端兼容性最好的方案，不需要自己写原生代码：

1. 删掉pubspec.yaml里之前引入的所有老旧地理编码插件，添加官方维护的依赖：

dependencies:
  geocoding: ^3.0.0 # 直接拉取最新稳定版即可，由Flutter核心社区维护，持续适配新系统版本

2. 配置iOS端必要权限，打开ios/Runner/Info.plist文件，在根<dict>节点下添加如下配置：

<key>NSLocationWhenInUseUsageDescription</key>
<string>用于地址位置信息解析</string>

3. 替换原有地理编码代码，增加必要的异常捕获和频率控制：

import 'package:geocoding/geocoding.dart';

Future<Location?> parseAddressToLngLat(String fullAddress) async {
  try {
    // iOS端注意控制调用频率，两次调用间隔不要低于1秒，避免触发苹果接口限流
    final locationList = await locationFromAddress(fullAddress);
    return locationList.isNotEmpty ? locationList.first : null;
  } catch (e) {
    debugPrint('地址解析失败: $e');
    return null;
  }
}

自定义原生方案（适配特殊定制需求） #

如果官方插件满足不了需求，可以自己通过MethodChannel调用iOS原生接口，注意必须切主线程执行：

// iOS端原生地理编码实现片段
let geocoder = CLGeocoder()
// 必须在主线程调用
DispatchQueue.main.async {
  geocoder.geocodeAddressString(inputAddress) { [weak self] placemarks, err in
    guard err == nil, let firstPlace = placemarks?.first, let coord = firstPlace.location?.coordinate else {
      // 错误回调
      return
    }
    // 把coord.longitude、coord.latitude回传Flutter层即可
  }
}

• 苹果原生地理编码成功率和地址完整度强相关，传入地址尽量带上省、市、区信息，仅传模糊的地名、商铺名解析成功率会远低于Android端
• 不要批量循环调用地理编码接口，苹果对单设备的调用限制约为每分钟50次，触发限流后1-2分钟内所有解析请求都会失败
• 测试时尽量用真机，iOS模拟器偶尔会出现定位服务异常导致地理编码失效的问题
• 不要使用依赖谷歌服务、第三方Web服务做解析的插件，这类插件要么需要额外配置API Key，要么在跨网络环境下会出现访问失败的问题

内容的提问来源于stack exchange，提问作者Aungko Maw