MKMapCamera俯仰调整部分地区失效，如何检测3D视图可用性？

我的App使用MapKit卫星影像，默认用pitch=0的MKMapCamera实现2D卫星地图，用户可切换为pitch=80、距离更低的3D视图。该功能在芝加哥市区正常，但在阿拉巴马、西德克萨斯、纳什维尔及亚特兰大周边农村地区失效：调整pitch时限制极大，缩小距离后相机直接俯冲向地面，无法呈现预期3D效果。

推测原因是极端（80度）3D视图仅在苹果Flyover覆盖区域可用，但isPitchEnabled仅判断是否允许调整俯仰，而非该位置能否实现请求的俯仰效果。希望通过编程检测指定位置是否支持此类3D视图，在不支持的地区禁用3D切换按钮。

以下是相关代码片段：

设置MKMapCamera #

var mapCamera: MKMapCamera {
        
        // MARK: This sets the camera perspective and position.  It may be generally a 2D view showing the map from directly above or it may be a 3D view looking down the line

        return MKMapCamera(
            lookingAtCenter: cameraCenter(),
            fromDistance: cameraDistanceUsed * locations.cameraZoom,
            pitch: locations.cameraAngle,
            heading: locations.bearing()
        )
    }
    
    func cameraCenter() -> CLLocationCoordinate2D {
        
        // MARK: This sets the center of the map
        
        if locations.cameraZoom == CameraZoom.birdsEye.rawValue  {
            // In the 2D (birds-eye) view, set the camera center to be the midpoint of the scene so that the entire scene is visible.
            return locations.midpoint.scene
            
        } else {
            // In the 3D view, set the camera center to be the midpoint between the user and the target so that the map is aligned with the direction of the user
            return locations.midpoint.target
        }
    }

创建MapView #

func makeUIView(context: Context) -> MKMapView {

        // MARK: This creates the satellite map
        
        let mapView = MKMapView()
        
        // Sets the map type to Satellite view
        mapView.preferredConfiguration = MKImageryMapConfiguration(elevationStyle: .realistic)
                
        // Shows the user's location on the map
        mapView.showsUserLocation = true
        
        // Sets the map camera and the coordinator
        mapView.delegate = context.coordinator
        mapView.camera = mapCamera
        
        mapView.isPitchEnabled = true
        
        //
        DispatchQueue.main.async {
            self.courseMap = mapView
        }
        
        return mapView
    }

切换2D/3D的枚举 #

enum CameraAngle: Double {
    
    // MARK:  This sets the value for the camera angle on the map.
    // Degrees of "0" means the camera is directly above the map, in a 2D "birds-eye" view.  Increasing the degrees of results in a more 3D view looking down the target line.
    
    case birdsEye = 0
    case threeD = 80
}

enum CameraZoom: Double {
    
    // MARK:  This sets the value for the camera zoom on the map.
    // Zoom factor of "2.2" is used for the 2D "birds-eye" view.  A lower zoom factor is used for 3D view looking down the target line since you don't need to see too far in the distance.
    
    case birdsEye = 2.2
    case threeD = 0.5
}

2D与3D切换按钮 #

Button {
     // Change the camera angle and distance from the ground to create the 3D view where available
     locations.cameraAngle = CameraAngle.threeD.rawValue
     locations.cameraZoom = CameraZoom.threeD.rawValue
                    
} label: {
     Image(systemName: "chevron.up")
         .font(.title)
}

Button {
     // Raise the camera and set the angle to 0º to create the 2D "bird's eye" view of the map
    locations.cameraAngle = CameraAngle.birdsEye.rawValue
    locations.cameraZoom = CameraZoom.birdsEye.rawValue
                    
} label: {
    Image(systemName: "chevron.down")
        .font(.title)                        
}

苹果没有提供直接查询Flyover覆盖区域的API，但可以通过以下两种方式间接检测指定位置是否支持目标3D视图：

方法1：尝试设置目标相机后验证实际参数 #

创建临时MKMapCamera并应用到地图，检查实际生效的相机参数是否与你设置的一致。如果不一致，说明该位置不支持该3D配置。

示例代码：

func is3DViewSupported(at coordinate: CLLocationCoordinate2D) -> Bool {
    guard let mapView = courseMap else { return false }
    
    // 保存当前相机状态
    let originalCamera = mapView.camera
    
    // 创建目标3D相机
    let testCamera = MKMapCamera(
        lookingAtCenter: coordinate,
        fromDistance: cameraDistanceUsed * CameraZoom.threeD.rawValue,
        pitch: CameraAngle.threeD.rawValue,
        heading: 0
    )
    
    // 应用测试相机
    mapView.camera = testCamera
    
    // 验证参数差异（允许微小误差）
    let isSupported = abs(mapView.camera.pitch - CameraAngle.threeD.rawValue) < 1 && 
                      abs(mapView.camera.distance - (cameraDistanceUsed * CameraZoom.threeD.rawValue)) < 10
    
    // 恢复原相机
    mapView.camera = originalCamera
    
    return isSupported
}

提示：可以配合MKMapViewDelegate的cameraDidChange(_:)回调完成验证，避免地图未加载导致的误判。

方法2：使用MKMapSnapshotter预测试 #

通过快照请求模拟应用目标相机，检查返回的快照相机参数是否符合预期，无需修改当前地图视图状态。

示例代码：

func check3DSupport(at coordinate: CLLocationCoordinate2D, completion: @escaping (Bool) -> Void) {
    let configuration = MKImageryMapConfiguration(elevationStyle: .realistic)
    let testCamera = MKMapCamera(
        lookingAtCenter: coordinate,
        fromDistance: cameraDistanceUsed * CameraZoom.threeD.rawValue,
        pitch: CameraAngle.threeD.rawValue,
        heading: 0
    )
    
    let snapshotOptions = MKMapSnapshotter.Options()
    snapshotOptions.mapConfiguration = configuration
    snapshotOptions.camera = testCamera
    snapshotOptions.size = CGSize(width: 1, height: 1) // 最小尺寸减少资源消耗
    
    let snapshotter = MKMapSnapshotter(options: snapshotOptions)
    snapshotter.start { snapshot, error in
        guard let snapshot = snapshot else {
            completion(false)
            return
        }
        
        // 验证快照相机参数
        let actualPitch = snapshot.camera.pitch
        let actualDistance = snapshot.camera.distance
        let isSupported = abs(actualPitch - CameraAngle.threeD.rawValue) < 1 && 
                          abs(actualDistance - (cameraDistanceUsed * CameraZoom.threeD.rawValue)) < 10
        
        completion(isSupported)
    }
}

应用到按钮禁用逻辑 #

在地图中心变化、用户位置更新等时机调用检测方法，根据结果控制按钮状态：

// 示例：地图区域变化时触发检测
func mapView(_ mapView: MKMapView, regionDidChangeAnimated animated: Bool) {
    let centerCoordinate = mapView.centerCoordinate
    check3DSupport(at: centerCoordinate) { [weak self] isSupported in
        DispatchQueue.main.async {
            self?.is3DButtonEnabled = isSupported
        }
    }
}

提示：频繁检测可能影响性能，建议添加1-2秒的防抖延迟。

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