Geocoder.getFromLocation()已弃用，低API级别适配方案咨询

Android 13（API 33）推出了带Geocoder.GeocodeListener的异步地理编码方法，替代了旧的同步getFromLocation()，但这个新方法只支持API 33+。针对更低版本的设备，你需要做版本兼容处理，以下是具体解决方案：

1. 版本分支实现兼容 #

通过Build.VERSION.SDK_INT判断系统版本，分别调用对应方法：

• API 33及以上：使用新的异步方法，无需手动管理线程，系统会在后台执行编码逻辑，结果通过回调返回
• API 33以下：继续使用旧的同步方法，但必须放在后台线程执行（避免主线程阻塞ANR）

示例代码（Kotlin） #

object GeocoderHelper {
    fun fetchAddress(
        context: Context,
        lat: Double,
        lng: Double,
        maxResults: Int = 1,
        onResult: (List<Address>?, Exception?) -> Unit
    ) {
        // 先检查设备是否支持地理编码服务
        if (!Geocoder.isPresent()) {
            onResult(null, Exception("Geocoder service not available on this device"))
            return
        }

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            Geocoder(context).getFromLocation(lat, lng, maxResults, object : Geocoder.GeocodeListener {
                override fun onGeocode(addresses: MutableList<Address>) {
                    onResult(addresses, null)
                }

                override fun onError(errorMessage: String?) {
                    onResult(null, Exception(errorMessage ?: "Geocoding failed with unknown error"))
                }
            })
        } else {
            // 低版本用后台线程执行同步方法
            Thread {
                try {
                    val addresses = Geocoder(context).getFromLocation(lat, lng, maxResults)
                    onResult(addresses, null)
                } catch (e: IOException) {
                    onResult(null, e)
                }
            }.start()
        }
    }
}

使用方式 #

在Activity或ViewModel中调用：

// 示例：在主线程调用，低版本回调会在后台线程，如需更新UI要切换到主线程
GeocoderHelper.fetchAddress(this, 39.9042, 116.4074) { addresses, error ->
    runOnUiThread {
        if (error != null) {
            // 处理错误
            return@runOnUiThread
        }
        addresses?.firstOrNull()?.let { address ->
            // 解析地址信息，比如address.getAddressLine(0)
        }
    }
}

2. 关键注意事项 #

• 必须检查Geocoder可用性：调用方法前先执行Geocoder.isPresent()，部分设备可能未预装地理编码服务，直接调用会返回空结果或抛出异常
• 低版本线程处理：旧同步方法绝对不能在主线程执行，否则会触发ANR，必须放在子线程、协程或AsyncTask中
• 权限问题：地理编码需要网络权限（android.permission.INTERNET），如果是定位相关场景，还需要定位权限，确保已在Manifest中声明并动态申请

3. 替代方案（可选） #

如果不想依赖系统Geocoder的兼容性问题，可以使用第三方地理编码服务，但需要注意：

• 需要申请对应服务的API_KEY并配置相关权限
• 存在请求次数限制，可能产生费用
• 需要自己处理网络请求和解析逻辑

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