iOS应用集成Google Maps SDK后地图不显示问题求助

集成Google Maps SDK后，能看到定位点、谷歌Logo和「前往我的位置」按钮，但地图瓦片无法加载显示，已确认API密钥正确、已绑定对应Bundle ID、已添加结算账户，环境为Xcode 15.4、iOS 15.0、Google Maps SDK 9.0.0，可从以下方向排查：

• 确认Maps SDK for iOS已启用
  登录Google Cloud控制台，检查当前项目是否开启了Maps SDK for iOS服务，不要误开成Android版本的Maps SDK，未启用该服务会导致地图瓦片无法获取。

• 检查API密钥的限制规则
  确保密钥的限制类型为「iOS应用」，且Bundle ID输入完全匹配（注意大小写、前缀，比如com.xxx.MyApp不能写错）；避免同时设置多种限制（如IP限制+iOS应用限制），多重限制可能导致验证失败。

• 排查网络与ATS配置

  • 优先用真机测试，避免模拟器网络代理/配置异常导致无法访问Google地图服务器；
  • 确认设备网络正常，可尝试切换WiFi/蜂窝网络；
  • 若使用了自定义网络代理，暂时关闭后重试；
  • 检查Info.plist的NSAppTransportSecurity设置，确保允许HTTPS请求（Google地图瓦片均为HTTPS地址，一般无需额外配置，但如果存在自定义例外规则，需确认未拦截Google域名）。

• 验证地图视图的布局约束
  检查mapView的Auto Layout约束是否正确设置，确保其宽高不为0、未被其他视图完全遮挡；可在viewDidLoad中打印mapView.frame，或通过Xcode的视图调试工具查看地图视图的实际尺寸。

• 查看Google Maps错误日志
  在AppDelegate的didFinishLaunchingWithOptions中添加日志级别设置：

  GMSServices.setLogLevel(.error)
  

  运行App后查看Xcode控制台，Google Maps会输出具体的错误信息（如API未启用、密钥验证失败、网络请求错误等），根据日志定位问题。

• 检查SDK版本兼容性
  尝试升级Google Maps SDK到最新稳定版本，确认是否存在旧版本与Xcode 15.4的兼容性问题；同时确保项目的iOS部署目标与SDK要求匹配（SDK 9.0.0最低支持iOS 12.0，iOS 15.0符合要求）。

• 确认定位权限配置
  虽然已获取定位权限，但仍需检查Info.plist中是否添加了NSLocationWhenInUseUsageDescription字段并填写了合理描述，缺失该字段可能导致定位授权异常，间接影响地图加载（不过你已能看到定位点，此点优先级较低）。

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