Geocoder.getFromLocation不稳定，咨询经纬度转地址的优化/替代方案

问题 #

通过经纬度获取街道地址时，使用系统Geocoder.getFromLocation()存在不稳定、偶尔无法获取地址且耗时较长的问题，当前实现的Kotlin代码如下：

fun getLastKnownLocation() {
    fusedLocationClient.lastLocation
        .addOnSuccessListener { location ->
            if (location != null) {
                longitude.value = location.longitude
                latitude.value = location.latitude

                val geocoder = Geocoder(app)

                if (Build.VERSION.SDK_INT >= 33) {
                    geocoder.getFromLocation(
                        location.latitude,
                        location.longitude,
                        1
                    ) { addresses ->
                        address.value = addresses.first().getAddressLine(0)
                    }
                } else {
                    try {
                        val addresses = geocoder.getFromLocation(
                            location.latitude,
                            location.longitude,
                            1)?.firstOrNull()
                        address.value = addresses?.getAddressLine(0) ?: "No address found"
                    } catch (Exp: Exception) {
                        address.value = "No address found"
                    }
                }
            }
        }
}

优化与替代方案 #

一、优化系统Geocoder的实现 #

系统Geocoder的问题核心在于低版本为同步阻塞调用、缺乏重试机制，且依赖设备Google Play服务状态，可从以下方向优化：

• 异步处理低版本同步调用：低版本getFromLocation()是同步方法，直接在主线程调用会阻塞UI，必须放到后台线程执行，推荐用Kotlin协程实现异步逻辑；
• 增加重试与超时限制：针对临时服务不可用的情况，添加1-2次重试；给同步调用设置超时时间，避免无限等待；
• 缓存查询结果：对相同经纬度的地址做内存/本地缓存，减少重复查询开销。

优化后的代码示例：

fun getLastKnownLocation() {
    fusedLocationClient.lastLocation
        .addOnSuccessListener { location ->
            if (location != null) {
                longitude.value = location.longitude
                latitude.value = location.latitude
                viewModelScope.launch(Dispatchers.IO) {
                    val addressResult = getAddressWithRetry(location.latitude, location.longitude)
                    withContext(Dispatchers.Main) {
                        address.value = addressResult ?: "No address found"
                    }
                }
            }
        }
}

private suspend fun getAddressWithRetry(lat: Double, lon: Double, retryCount: Int = 2): String? {
    repeat(retryCount) { attempt ->
        try {
            return withTimeout(5000) { // 设置5秒超时
                val geocoder = Geocoder(app)
                if (Build.VERSION.SDK_INT >= 33) {
                    suspendCoroutine { cont ->
                        geocoder.getFromLocation(lat, lon, 1) { addresses ->
                            cont.resume(addresses.firstOrNull()?.getAddressLine(0))
                        }
                    }
                } else {
                    geocoder.getFromLocation(lat, lon, 1)?.firstOrNull()?.getAddressLine(0)
                }
            }
        } catch (e: Exception) {
            // 重试前短暂延迟，避免频繁请求
            delay(1000)
        }
    }
    return null
}

二、使用第三方逆地理编码服务替代 #

如果系统Geocoder稳定性无法满足需求，可切换到第三方地理服务提供商的API，比如国内的高德、百度、腾讯地图，或国外的OpenStreetMap Nominatim等。这类服务基于HTTP请求，稳定性更高，且有明确的错误码和重试策略。

实现思路：

1. 申请对应服务商的API密钥；
2. 构造包含经纬度、密钥的HTTP请求；
3. 用Retrofit或OkHttp异步发起请求；
4. 解析返回的JSON数据，提取街道地址；
5. 处理网络异常、API限额、无效经纬度等错误场景。

示例伪代码（协程+OkHttp）：

private suspend fun getAddressFromThirdParty(lat: Double, lon: Double): String? {
    val client = OkHttpClient()
    val request = Request.Builder()
        .url("https://your-service-domain/geocode/reverse?lat=$lat&lon=$lon&key=your_api_key")
        .build()
    
    return try {
        client.newCall(request).await().use { response ->
            if (!response.isSuccessful) return null
            val jsonBody = response.body?.string() ?: return null
            // 根据服务商返回的JSON结构解析地址，示例：
            JSONObject(jsonBody).optJSONObject("result")?.optString("formatted_address", null)
        }
    } catch (e: Exception) {
        null
    }
}

注意：使用第三方服务需要添加网络权限（android.permission.INTERNET），且API密钥不要硬编码到代码中，可通过本地配置或服务器代理请求的方式管理。

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