iOS中GMSMarker触发弹窗或跳转谷歌地图后相机焦点异常求助

嘿，我来帮你排查这个地图相机偏移的问题！你遇到的弹窗弹出或从谷歌地图返回后焦点跑偏的情况，核心原因大概率是地图初始化时机不当，加上没有处理外部应用返回后的地图状态恢复。

问题根源拆解 #

你把地图初始化逻辑放在了viewDidLayoutSubviews里，这个方法会被频繁触发：弹窗弹出/消失、屏幕旋转、从其他应用返回、视图布局更新时都会调用它。虽然你加了mapView == nil的判断避免重复初始化，但仍有两个潜在坑：

1. 从谷歌地图返回时，系统会重新触发视图布局，GMSMapView可能因状态重置自动回到初始相机位置；
2. 弹窗导致的布局变化，可能让地图的相机计算出现意外偏差。

修复步骤与代码示例 #

1. 把地图初始化移到viewDidLoad

viewDidLoad只会在视图加载时执行一次，更适合做初始化操作，避免频繁触发的布局方法干扰：

class YourViewController: UIViewController, GMSMapViewDelegate {
    @IBOutlet weak var mapContainerView: UIView!
    var mapView: GMSMapView?
    // 保存相机位置，用于从外部应用返回后恢复
    private var savedCameraPosition: GMSCameraPosition?

    override func viewDidLoad() {
        super.viewDidLoad()
        setupMapView()
    }

    private func setupMapView() {
        guard mapView == nil else { return }
        
        // 初始相机位置
        let initialCamera = GMSCameraPosition.camera(withLatitude: 45.582045, longitude:74.32937, zoom: 14.0)
        mapView = GMSMapView.map(withFrame: mapContainerView.bounds, camera: initialCamera)
        mapView?.delegate = self
        
        // 设置地图样式
        do {
            if let styleURL = Bundle.main.url(forResource: "style", withExtension: "json") {
                mapView?.mapStyle = try GMSMapStyle(contentsOfFileURL: styleURL)
            } else {
                NSLog("Unable to find style.json")
            }
        } catch {
            NSLog("One or more of the map styles failed to load. \(error)")
        }
        
        mapContainerView.addSubview(mapView!)
        mapView?.settings.setAllGesturesEnabled(false)
        
        // 添加Marker并调整相机到目标区域
        let marker = AppointmentMapDataManager(mapView: mapView!).setAppointmentMarker()
        var bounds = GMSCoordinateBounds()
        bounds = bounds.includingCoordinate(marker.position)
        let edgeInsets = UIEdgeInsets(top: mapContainerView.frame.height/2 - 33, left: mapContainerView.frame.width/2 - 81, bottom: 0, right: 0)
        let cameraUpdate = GMSCameraUpdate.fit(bounds, with: edgeInsets)
        mapView?.moveCamera(cameraUpdate)
        
        // 保存调整后的相机位置
        savedCameraPosition = mapView?.camera
    }
}

2. 仅在viewDidLayoutSubviews中调整地图frame

这个方法只用来处理布局变化时的frame更新，不要做其他逻辑，避免干扰相机状态：

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    // 确保地图frame始终匹配容器视图
    mapView?.frame = mapContainerView.bounds
}

3. 从外部应用返回时恢复相机位置

在viewWillAppear中恢复之前保存的相机位置，确保从谷歌地图回来后焦点不变：

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    if let savedCamera = savedCameraPosition {
        mapView?.camera = savedCamera
    }
}

4. Marker点击跳转的优化（可选）

如果是点击Marker跳转到谷歌地图，建议跳转前主动保存当前相机位置，确保返回时精准恢复：

func mapView(_ mapView: GMSMapView, didTap marker: GMSMarker) -> Bool {
    // 点击Marker时保存当前相机位置
    savedCameraPosition = mapView.camera
    
    // 跳转到谷歌地图应用
    let mapUrl = URL(string: "comgooglemaps://?q=\(marker.position.latitude),\(marker.position.longitude)&zoom=14")!
    if UIApplication.shared.canOpenURL(mapUrl) {
        UIApplication.shared.open(mapUrl, options: [:])
    } else {
        //  fallback到网页版谷歌地图
        let webMapUrl = URL(string: "https://www.google.com/maps/search/?api=1&query=\(marker.position.latitude),\(marker.position.longitude)")!
        UIApplication.shared.open(webMapUrl, options: [:])
    }
    return true
}

额外提示 #

• 确保mapView是强引用（不要用weak），避免被意外释放导致重新初始化；
• 如果需要支持屏幕旋转，可在viewWillTransition(to:with:)中重新计算相机边界并调整。

内容的提问来源于stack exchange，提问作者Ali Shahid