MapBox iOS如何强制地图始终处于允许边界内 即使用户位置更新也不越界

问题根因 #

mapView(_:shouldChangeFrom:to:)代理仅拦截用户手势触发的地图相机变更，用户位置更新触发的系统自动相机调整（followWithHeading追踪模式下）不会触发该代理，因此原有校验逻辑不生效。

可行方案 #

优先选择手动实现位置追踪逻辑，替代系统自带的userTrackingMode，可以完全控制相机移动规则：

实现步骤 #

1. 移除原有mapView.userTrackingMode = .followWithHeading配置，仅保留显示用户位置的配置
2. 实现地图位置更新代理方法，自行判断是否需要移动地图相机
3. 复用原有边界校验逻辑，确保可见区域始终在限制范围内

示例代码 #

// 基础配置，仅保留显示用户位置
mapView.showsUserLocation = showUserLocation

// 实现用户位置更新回调
public func mapView(_ mapView: MGLMapView, didUpdate userLocation: MGLUserLocation?) {
    guard let userCoordinate = userLocation?.coordinate, 
          let allowedBounds = self.allowedBounds else { return }
    
    // 用户位置超出限制区域时仅更新蓝点，不移动相机
    guard MGLCoordinateInCoordinateBounds(userCoordinate, allowedBounds) else {
        return
    }
    
    // 构造新相机，保持当前缩放、俯仰参数，跟随用户位置和航向
    let currentCamera = mapView.camera
    let heading = userLocation?.heading?.trueHeading ?? currentCamera.heading
    let targetCamera = MGLMapCamera(
        lookingAtCenter: userCoordinate,
        altitude: currentCamera.altitude,
        pitch: currentCamera.pitch,
        heading: heading
    )
    
    // 复用原有可见区域校验逻辑
    mapView.camera = targetCamera
    let newVisibleBounds = mapView.visibleCoordinateBounds
    mapView.camera = currentCamera
    
    let boundsValid = MGLCoordinateInCoordinateBounds(newVisibleBounds.ne, allowedBounds) 
                   && MGLCoordinateInCoordinateBounds(newVisibleBounds.sw, allowedBounds)
    if boundsValid {
        mapView.setCamera(targetCamera, animated: true)
    }
}

备选方案 #

如果必须使用系统自带的追踪模式，可以通过KVO监听mapView.camera属性，每次属性变更前做边界校验，不符合规则则重置为合法相机。该方案可能存在轻微的相机跳闪问题，不推荐优先使用。

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