如何实现GMSMapView超出边界时向ScrollView的平滑滚动切换？

我来帮你搞定这个地图和ScrollView滚动衔接不自然的问题！你现在的代码是直接设置固定的contentOffset，所以视觉上会有突兀的跳转，要实现自然过渡，核心是让ScrollView的滚动距离和地图超出边界的偏移量联动，而不是用固定值。下面是具体的改进方案：

一、核心思路 #

1. 实时计算地图相机位置超出边界的差值，把这个差值按比例映射到ScrollView的滚动偏移上
2. 避免地图动画触发的循环回调，直接修改相机位置而非使用动画
3. 处理地图和ScrollView的手势冲突，确保两者手势能协同工作

二、改进后的代码实现 #

1. 优化地图相机位置变化的回调逻辑 #

替换你现有的mapView(_:didChange:)方法，改成动态计算滚动偏移：

func mapView(_ mapView: GMSMapView, didChange position: GMSCameraPosition) {
    let targetLat = position.target.latitude
    var adjustedLat = targetLat
    var scrollOffsetY = scrollView.contentOffset.y
    
    // 计算纬度超出上下边界的差值
    let overTopDiff = targetLat - northEastLatitude
    let overBottomDiff = southWestLatitude - targetLat
    
    // 处理上边界超出：将地图超出的纬度差值映射为ScrollView的向上滚动距离
    if overTopDiff > 0 {
        // 这里的系数（*50）可以根据你的UI调整，值越大ScrollView滚动越灵敏
        // 可以结合地图缩放级别优化：let zoomFactor = pow(2, position.zoom)，然后乘以zoomFactor
        let scrollDelta = overTopDiff * 50
        scrollOffsetY = -scrollDelta
        adjustedLat = northEastLatitude
    }
    // 处理下边界超出：将地图超出的纬度差值映射为ScrollView的向下滚动距离
    else if overBottomDiff > 0 {
        let scrollDelta = overBottomDiff * 50
        scrollOffsetY = scrollDelta
        adjustedLat = southWestLatitude
    }
    // 未超出边界时，让ScrollView回到初始位置（可选，根据你的需求调整）
    else {
        if scrollOffsetY != 0 {
            scrollOffsetY = 0
        }
    }
    
    // 处理经度边界（和你原有逻辑一致，横向不需要联动ScrollView）
    var adjustedLon = position.target.longitude
    if position.target.longitude > nortEastLongitude {
        adjustedLon = nortEastLongitude
    } else if position.target.longitude < southWestLongitude {
        adjustedLon = southWestLongitude
    }
    
    // 实时更新ScrollView偏移，关闭动画避免卡顿（因为回调是实时触发的）
    scrollView.setContentOffset(CGPoint(x: 0, y: scrollOffsetY), animated: false)
    
    // 调整地图相机位置，直接设置而非使用animate，避免循环回调
    if adjustedLat != targetLat || adjustedLon != position.target.longitude {
        let adjustedCoord = CLLocationCoordinate2D(latitude: adjustedLat, longitude: adjustedLon)
        mapView.camera = GMSCameraPosition(
            target: adjustedCoord,
            zoom: position.zoom,
            bearing: position.bearing,
            viewingAngle: position.viewingAngle
        )
    }
}

2. 处理手势冲突 #

GMSMapView和ScrollView的平移手势会互相干扰，需要通过手势代理让它们协同工作：
首先在你的ViewController里遵循UIGestureRecognizerDelegate协议，然后在viewDidLoad中设置手势代理：

override func viewDidLoad() {
    super.viewDidLoad()
    // ... 其他初始化代码
    
    // 获取地图的平移手势识别器，设置代理
    if let panGesture = mapView.gestureRecognizers?.first(where: { $0 is UIPanGestureRecognizer }) {
        panGesture.delegate = self
        scrollView.panGestureRecognizer.delegate = self
    }
}

然后实现代理方法：

extension YourViewController: UIGestureRecognizerDelegate {
    func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        // 允许地图和ScrollView的平移手势同时识别
        return true
    }
    
    func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldBeRequiredToFailBy otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        // 当地图已经到达边界时，让ScrollView的手势优先响应
        if gestureRecognizer is UIPanGestureRecognizer && gestureRecognizer.view == mapView {
            let targetLat = mapView.camera.target.latitude
            return (targetLat >= northEastLatitude || targetLat <= southWestLatitude)
        }
        return false
    }
}

三、优化小贴士 #

• 调整映射系数：代码中的*50是纬度差值到ScrollView滚动距离的映射系数，你可以根据自己的UI布局和需求调整，让滚动速度和地图手势匹配。如果需要适配不同缩放级别，可以结合position.zoom计算动态系数（比如pow(2, position.zoom)）。
• 边界值校准：确保northEastLatitude、southWestLatitude等边界值是准确的，最好通过地图的可见区域计算，而不是固定值。
• 测试边缘场景：比如快速滚动到边界、手势中途改变方向等情况，确保过渡始终自然。

这样调整后，当地图滚动到边界时，ScrollView会跟随手势平滑滚动，过渡效果会自然很多～

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