是否存在支持API密钥限制的Google Play Services地理编码SDK？

没错，你想要的解决方案就是Google Play Services旗下的Places SDK for Android——它不仅提供了统一的Google Maps地理编码后端（完全规避AOSP内置Geocoder的实现差异问题），还完美支持API密钥的应用级限制，彻底解决REST API无法锁定到单一Android应用的痛点。

为什么它比你之前的选择更合适？ #

• 相对于AOSP内置Geocoder：Places SDK的地理编码服务直接对接Google Maps的官方后端，所有Android设备上的结果都是一致的，不会因为不同AOSP分支或IGeocodingProvider的自定义实现出现差异。
• 相对于Geocoding REST API：SDK通过Google Play Services的安全通道处理请求，你的API密钥配置在AndroidManifest.xml中，并且可以在Google Cloud控制台为该密钥绑定应用包名+SHA-1签名指纹。Google的服务器会验证请求来源的应用身份，只有匹配的应用才能使用该密钥，从根本上防止密钥被非法复用（REST API的密钥放在HTTP请求中，容易被抓包或反编译获取，限制手段远不如SDK可靠）。

快速上手指南 #

1. 添加SDK依赖 #

在Module级别的build.gradle（或build.gradle.kts）中引入Places SDK：

dependencies {
    implementation 'com.google.android.libraries.places:places:3.4.0'
}

2. 配置受限制的API密钥 #

首先在Google Cloud控制台为你的API密钥设置Android应用限制（指定你的应用包名和SHA-1指纹），然后在AndroidManifest.xml中配置密钥：

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="你的API密钥"/>

3. 地理编码示例代码 #

正向地理编码（地址转坐标/地点信息）

// 初始化Places客户端
val placesClient = Places.createClient(applicationContext)

// 构建地址查询请求
val request = FindAutocompletePredictionsRequest.builder()
    .setQuery("北京市海淀区中关村大街")
    .build()

placesClient.findAutocompletePredictions(request)
    .addOnSuccessListener { response ->
        response.autocompletePredictions.forEach { prediction ->
            Log.d("Geocoding", "地点ID: ${prediction.placeId}")
            Log.d("Geocoding", "地址: ${prediction.getFullText(null)}")
            // 如需获取坐标，可通过Place ID进一步请求详情
        }
    }
    .addOnFailureListener { exception ->
        if (exception is ApiException) {
            Log.e("Geocoding", "请求失败: 状态码 ${exception.statusCode}")
        }
    }

反向地理编码（坐标转地址）

如果需要根据经纬度获取地址，可以通过FetchPlaceRequest请求地点详情：

val placeId = "之前获取的地点ID"
val request = FetchPlaceRequest.builder(placeId, listOf(Place.Field.ADDRESS, Place.Field.LAT_LNG))
    .build()

placesClient.fetchPlace(request)
    .addOnSuccessListener { response ->
        val place = response.place
        Log.d("ReverseGeocoding", "地址: ${place.address}")
        Log.d("ReverseGeocoding", "坐标: ${place.latLng}")
    }

重要提示 #

• 确保你的Google Cloud项目已启用Places API（注意不是旧版的Geocoding API），并且API密钥的应用限制配置正确。
• 旧版的Google Play Services地理编码接口（如依赖com.google.android.gms:play-services-location的Geocoder扩展）已被弃用，官方强烈推荐使用Places SDK for Android替代。

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