如何在Android应用中使用受限API密钥调用Google Geolocation API

嘿，这个问题我之前也踩过坑——直接发HTTP请求调用Google Geocode API确实会因为密钥的Android限制被拒绝，因为Web请求没法携带应用的包名和SHA-1验证信息。不过用官方的Android SDK就能完美解决这个问题，下面给你详细梳理：

核心原因 #

你的API密钥被限制为仅允许特定Android应用使用，Google服务器需要验证请求来自绑定的应用（通过包名和SHA-1指纹）。直接的HTTP请求无法提供这些验证信息，所以会被拦截；而Google Maps SDK for Android会自动在请求中携带这些验证数据，完全符合密钥的限制规则。

具体实现步骤 #

1. 前期准备 #

• 确保在Google Cloud控制台中，你的API密钥已经启用了Geocoding API，并且限制条件准确设置为你的Android应用（填写正确的包名和SHA-1指纹）。
• 在你的Android项目中添加Google Geocoding服务的依赖，在app模块的build.gradle（或build.gradle.kts）中加入：

  implementation 'com.google.android.gms:play-services-geocoding:18.0.0'
  

  （可以替换为官方最新版本号）
• 在AndroidManifest.xml中配置你的受限API密钥：

  <meta-data
      android:name="com.google.android.geo.API_KEY"
      android:value="YOUR_RESTRICTED_API_KEY" />
  

2. 代码实现（Kotlin示例） #

使用GeocodingClient发起反向地理编码请求，SDK会自动处理密钥的验证逻辑：

import com.google.android.gms.location.GeocodingRequest
import com.google.android.gms.location.GeocodingClient
import com.google.android.gms.tasks.OnFailureListener
import com.google.android.gms.tasks.OnSuccessListener

// 初始化GeocodingClient
val geocodingClient = GeocodingClient(context)

// 构建根据邮政编码的请求
val postalCodeRequest = GeocodingRequest.builder()
    .setAddressComponents(
        AddressComponents.builder()
            .setPostalCode("你的目标邮政编码")
            .build()
    )
    .build()

// 发起请求并处理结果
geocodingClient.geocode(postalCodeRequest)
    .addOnSuccessListener { response ->
        if (response.results.isNotEmpty()) {
            val firstResult = response.results[0]
            // 获取格式化的完整地址
            val formattedAddress = firstResult.formattedAddress
            // 获取对应的经纬度
            val latitude = firstResult.geometry.location.latitude
            val longitude = firstResult.geometry.location.longitude
            // 这里可以根据业务需求处理这些数据
        } else {
            // 未找到匹配的地理信息
        }
    }
    .addOnFailureListener { exception ->
        // 处理请求失败情况，比如网络异常、API配额耗尽等
        exception.printStackTrace()
    }

3. 注意事项 #

• 确保你的应用已经声明网络权限：<uses-permission android:name="android.permission.INTERNET" />
• 留意Google API的调用配额，避免超出限制导致请求被拒绝
• 如果需要频繁查询相同邮政编码，建议加入本地缓存机制，减少重复API调用

这样就能用受限的API密钥安全地调用Google的反向地理编码API了，既符合密钥的限制规则，又能获取到Google官方的准确地理数据。

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