如何在不重置缩放级别的情况下更新SwiftUI Map位置？

需求说明 #

• SwiftUI Map 根据 CLLocationManager 传入的 GPS 坐标更新位置
• 用户可自行对地图进行缩放操作
• 后续 GPS 位置变更时，仅移动地图至新位置，不改变缩放级别（即 MapCamera 的 distance 属性）

问题描述 #

当前代码中，用户缩放地图后，mapCamPos.camera?.distance 值变为 nil，导致无法保留用户设置的缩放级别，每次位置更新都会 fallback 到默认的 1000 距离。

原代码示例 #

struct GCMap: View {
    
    @StateObject var locationMgr = GcFlightState()
    @State private var mapCamPos: MapCameraPosition = .automatic
    
    var body: some View {
        ZStack {
            Map(position: $mapCamPos) {
                Annotation("UserLocation", coordinate: self.locationMgr.location.coordinate) {
                    Image(systemName: "airplane.circle").rotationEffect(.degrees(270))
                }
            }
            .onMapCameraChange() {
                print("onMapCameraChange \(mapCamPos.camera?.distance)")
            }
            .onReceive(locationMgr.$location) { location in
                mapCamPos =  .camera(MapCamera(
                    centerCoordinate: location.coordinate,
                    distance: mapCamPos.camera?.distance ?? 1000,   // <<=== 问题点：distance 变为 nil
                    heading: location.course
                ))
            }
            
        }
    }
}

修复方案：手动保存缩放级别 #

问题根源是 MapCameraPosition 在用户交互后可能不会持续保留 camera 对象的完整属性，因此需要手动维护当前的缩放距离：

修改后的代码 #

struct GCMap: View {
    
    @StateObject var locationMgr = GcFlightState()
    @State private var mapCamPos: MapCameraPosition = .automatic
    @State private var currentZoomDistance: Double = 1000 // 初始默认距离
    
    var body: some View {
        ZStack {
            Map(position: $mapCamPos) {
                Annotation("UserLocation", coordinate: self.locationMgr.location.coordinate) {
                    Image(systemName: "airplane.circle").rotationEffect(.degrees(270))
                }
            }
            .onMapCameraChange(frequency: .continuous) { context in
                // 从回调 context 中直接获取当前相机的 distance，避免依赖 mapCamPos.camera
                if let distance = context.camera.distance {
                    currentZoomDistance = distance
                }
            }
            .onReceive(locationMgr.$location) { location in
                mapCamPos = .camera(MapCamera(
                    centerCoordinate: location.coordinate,
                    distance: currentZoomDistance, // 使用手动保存的距离值
                    heading: location.course
                ))
            }
            
        }
    }
}

关键改动说明 #

• 使用 onMapCameraChange 的 context 参数获取当前相机距离，该值在用户缩放后会准确更新
• 用 currentZoomDistance 变量持久化保存缩放级别，避免依赖 mapCamPos.camera 可能出现的 nil 问题
• 位置更新时直接复用保存的距离值，确保缩放级别不被重置

替代方案：使用 UIKit 的 MKMapView 包装 #

如果 SwiftUI Map 的问题依然存在，可以直接包装 UIKit 成熟的 MKMapView，其相机属性稳定性更高：

包装实现代码 #

struct MapViewUIKit: UIViewRepresentable {
    @ObservedObject var locationMgr: GcFlightState
    @State private var currentRegion: MKCoordinateRegion?
    
    func makeUIView(context: Context) -> MKMapView {
        let mapView = MKMapView()
        mapView.delegate = context.coordinator
        // 设置初始显示区域
        let initialRegion = MKCoordinateRegion(
            center: locationMgr.location.coordinate,
            latitudinalMeters: 2000,
            longitudinalMeters: 2000
        )
        mapView.setRegion(initialRegion, animated: true)
        currentRegion = initialRegion
        return mapView
    }
    
    func updateUIView(_ uiView: MKMapView, context: Context) {
        // 更新用户位置标注
        let annotation = MKPointAnnotation()
        annotation.coordinate = locationMgr.location.coordinate
        annotation.title = "UserLocation"
        
        uiView.removeAnnotations(uiView.annotations)
        uiView.addAnnotation(annotation)
        
        // 仅更新中心坐标，保留原缩放级别
        if let region = currentRegion {
            let newRegion = MKCoordinateRegion(
                center: locationMgr.location.coordinate,
                span: region.span // 复用原缩放 span
            )
            uiView.setRegion(newRegion, animated: true)
        }
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }
    
    class Coordinator: NSObject, MKMapViewDelegate {
        var parent: MapViewUIKit
        
        init(_ parent: MapViewUIKit) {
            self.parent = parent
        }
        
        func mapView(_ mapView: MKMapView, regionDidChangeAnimated animated: Bool) {
            // 保存当前区域，用于后续位置更新时保留缩放
            parent.currentRegion = mapView.region
        }
    }
}

// 使用方式
struct GCMap: View {
    @StateObject var locationMgr = GcFlightState()
    
    var body: some View {
        MapViewUIKit(locationMgr: locationMgr)
    }
}

替代方案优势 #

• 完全复用 UIKit 成熟的地图功能，相机和缩放属性无 nil 问题
• 支持更灵活的自定义扩展（如添加手势、自定义标注等）
• 符合你提到的 UIKit MKMapCamera 无此问题的预期

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