Google Geocoding API Key iOS应用限制失效问题求助

排查与修复步骤 #

• 确认API服务启用状态：检查Google Cloud控制台中，Geocoding API是否已启用——即使Key设置了限制，服务未开启也会触发授权错误。
• 严格匹配Bundle ID：确保控制台填写的Bundle ID与iOS项目中的完全一致，注意区分大小写，不能有多余空格或符号，比如com.yourapp.name和com.Yourapp.Name会被判定为不同ID。
• 添加必要的HTTP请求头：iOS应用限制依赖X-Ios-Bundle-Identifier头识别应用，直接用URLSession发起请求时需手动添加，示例代码：

  var request = URLRequest(url: URL(string: "https://maps.googleapis.com/maps/api/geocode/json?latlng=xxx,xxx&key=YOUR_API_KEY")!)
  request.setValue(Bundle.main.bundleIdentifier, forHTTPHeaderField: "X-Ios-Bundle-Identifier")
  let task = URLSession.shared.dataTask(with: request) { data, response, error in
      // 处理响应逻辑
  }
  task.resume()
  

  若使用第三方网络库（如Alamofire），同样要确保添加该头字段，否则Google服务器无法识别应用身份。
• 等待配置缓存刷新：Google Cloud的限制设置存在缓存延迟，修改后等待5-10分钟，重启应用再测试，避免旧配置干扰。
• 用真实设备测试：模拟器的网络请求可能无法正确携带Bundle ID头，建议切换到真机验证。
• 确认限制类型选择正确：控制台中需选择iOS apps类型的限制，而非HTTP referrers或IP addresses，选错类型会导致限制规则不生效。

额外注意事项 #

• 不要在请求URL中拼接Bundle ID，必须通过HTTP头传递，这是Google识别iOS应用授权的唯一有效方式。
• 若应用有多个Target（如Debug/Release），需将每个Target的Bundle ID加入允许列表，或使用通配符（如com.yourapp.*）覆盖所有子ID。

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