Swift中Google Maps仅显示带标记空白页面问题求助

我来帮你梳理这个问题，Google Maps只显示标记但地图瓦片空白，通常是几个常见原因导致的，咱们一步步来排查：

1. 确认API Key的有效性与权限配置 #

• 首先检查你在AppDelegate.swift里的GMSServices.provideAPIKey("KEY")，有没有把占位符"KEY"替换成真实有效的Google Maps iOS SDK API Key？这是最容易犯的错误。
• 登录Google Cloud控制台，确认你的API Key已经启用了Maps SDK for iOS服务——很多时候开发者会创建Key但忘记开启对应的服务，导致请求被拒绝。
• 检查Key的限制设置：如果你的Key设置了Bundle ID限制，要确保限制里的Bundle ID和你Xcode项目里的完全一致（包括大小写），否则地图请求会被拦截。

2. 检查模拟器的网络与位置服务设置 #

• 模拟器的网络是否正常？可以打开模拟器里的Safari，随便访问一个网页测试网络连通性——Google Maps需要联网加载地图瓦片，网络不通的话自然显示空白。
• 确认模拟器的定位服务是否开启：进入模拟器的「设置」→「隐私与安全性」→「定位服务」，确保总开关是打开的，并且给你的App授予了定位权限（即使你用的是固定坐标，SDK可能仍需要权限声明才能正常加载地图）。

3. 代码与配置文件的细节检查 #

• 查看你的ViewController.swift代码：你直接将mapView赋值给了self.view，这本身没问题，但要确认storyboard或其他代码里没有添加覆盖在地图上的视图（比如一个透明的UIView），导致地图被遮挡。
• 别忘了在Info.plist中添加位置权限声明：添加NSLocationWhenInUseUsageDescription键，值填类似"需要访问位置信息以显示地图"的描述——即使你不需要动态获取位置，Google Maps SDK可能仍需要这个声明才能正常工作。
• 检查你设置的经纬度是否有效：你用的23.431351, 85.325879是印度的有效坐标，这部分应该没问题，但可以试着换成其他知名坐标（比如北京、纽约）测试一下，排除坐标异常的可能。

4. 查看Xcode控制台的错误日志 #

运行App时，打开Xcode的控制台面板，仔细查看有没有Google Maps相关的错误信息——比如API Key无效、权限不足、网络请求失败等，这些日志会直接告诉你问题所在，是最快速的排查方式。

举个例子，如果控制台输出Google Maps SDK for iOS cannot connect or validate APIKey: Error Domain=com.google.maps Code=-5，那就是API Key的问题，回到第一步重新检查Key的配置。

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