Swift集成Google Maps仅显示标记，地图白屏问题求助

API 探路者

2026-7-20

Google Maps iOS集成白屏（可显示标记）问题排查

可能的原因及解决方法

1. API密钥权限配置缺失

检查Google Cloud Console，确认你的API密钥已启用Maps SDK for iOS服务。标记能显示是因为它是本地绘制元素，但地图瓦片加载依赖Maps SDK权限，若仅启用Places API会导致白屏。
验证密钥的应用限制：如果设置了Bundle ID限制，必须确保Xcode项目的Bundle Identifier与Console中配置的完全一致，包括大小写和拼写；iOS应用限制需正确绑定对应Bundle ID。

2. 网络相关问题

确认设备/模拟器可正常访问Google服务：国内环境下Google Maps服务无法直接访问，需配置对应网络环境。
检查Info.plist网络权限：iOS 10+需确保NSAppTransportSecurity配置允许HTTPS请求，可添加NSAllowsArbitraryLoads（测试环境）或针对googleapis.com配置例外域，避免请求被拦截。

3. MapView布局异常

当前代码用CGRect.zero初始化MapView后直接赋值给view，可能因自动布局逻辑导致地图未正确渲染。可修改为以下方式确保MapView填充父视图：

override func viewDidLoad() {
    super.viewDidLoad()
    let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
    let mapView = GMSMapView.map(withFrame: view.bounds, camera: camera)
    mapView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
    view.addSubview(mapView)
    
    let marker = GMSMarker()
    marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
    marker.title = "Sydney"
    marker.snippet = "Australia"
    marker.map = mapView
}