如何在iOS MapView中更新标注坐标并实现平滑动画效果

问题场景 #

项目中使用MKMapView展示车辆位置，车辆坐标每15秒更新一次，需要同步刷新地图标注位置：

• 初始实现方案为先移除所有title不为"person"的现有标注，再重新添加对应新坐标的车辆标注，该方案下标注会瞬时跳转，无法实现动画过渡效果
• 参考通用开发经验直接修改标注的coordinate属性做动态更新测试，发现方法并未生效

原有实现代码 #

旧版移除重加实现 #

func updateVehicleLocations(){
    let annotations = mapView.annotations.filter {
        $0.title != "person"
    }
    mapView.removeAnnotations(annotations)
    
    for vehicle in vehicles {
        let pin = MKPointAnnotation()
        pin.coordinate = CLLocationCoordinate2D(latitude: vehicle.latitude, longitude: vehicle.longitude)
        pin.title = vehicle.vehicleID
        mapView.addAnnotation(pin)
    }
    
    if isSetCoordinatesMoreThanOnce { return }
    mapView.showAnnotations(mapView.annotations, animated: true)
    isSetCoordinatesMoreThanOnce = true
}

直接修改coordinate的测试实现 #

func updateVehicleLocations(){
    for annotation in busAnnotations {
        UIView.animate(withDuration: 0.5) { [self] in
            if let vehicle = self.vehicles.first(where: { $0.vehicleID == annotation.vehicleID }) {
                annotation.coordinate = CLLocationCoordinate2D(latitude: vehicle.latitude, longitude: vehicle.longitude)
            }
        }
    }

   if isSetCoordinatesMoreThanOnce { return }
    
    for vehicle in vehicles {
        let pin = BusAnnotation(coordinate: CLLocationCoordinate2D(latitude: vehicle.latitude, longitude: vehicle.longitude), vehicleID: vehicle.vehicleID)
        busAnnotations.append(pin)
    }
    
    mapView.addAnnotations(busAnnotations)
    mapView.showAnnotations(mapView.annotations, animated: true)
    isSetCoordinatesMoreThanOnce = true
}

失效核心原因 #

1. 测试代码逻辑顺序错误：首次加载时busAnnotations为空数组，遍历更新坐标的逻辑拿不到有效标注对象；后续更新时isSetCoordinatesMoreThanOnce为true，遍历完坐标后会直接return，不会执行新增车辆的标注添加逻辑
2. 自定义BusAnnotation类的coordinate属性未添加@objc dynamic修饰，MapKit无法通过KVO监听属性变更触发视图刷新，这是修改coordinate不生效的根本原因
3. MKAnnotationView的位置更新不需要用UIView.animate包裹，MapKit本身对标注coordinate属性变化有内置动画渲染逻辑，额外的UIView动画会干扰系统渲染流程

正确实现方案 #

1. 修正自定义标注类，确保coordinate属性支持KVO监听：

class BusAnnotation: NSObject, MKAnnotation {
    // 必须添加@objc dynamic修饰，否则MapKit无法监听坐标变化
    @objc dynamic var coordinate: CLLocationCoordinate2D
    var vehicleID: String
    
    init(coordinate: CLLocationCoordinate2D, vehicleID: String) {
        self.coordinate = coordinate
        self.vehicleID = vehicleID
        super.init()
    }
}

2. 调整更新逻辑，区分首次加载和增量更新场景，用字典存储已存在的标注避免重复遍历查找：

var existingVehicleAnnotations: [String: BusAnnotation] = [:]
var isFirstLoad = true

func updateVehicleLocations() {
    // 遍历最新车辆数据，已存在的标注更新坐标，不存在的新建添加
    for vehicle in vehicles {
        if let existingAnnotation = existingVehicleAnnotations[vehicle.vehicleID] {
            // 直接修改coordinate即可触发系统自带的平滑移动效果
            existingAnnotation.coordinate = CLLocationCoordinate2D(
                latitude: vehicle.latitude,
                longitude: vehicle.longitude
            )
        } else {
            let newAnnotation = BusAnnotation(
                coordinate: CLLocationCoordinate2D(latitude: vehicle.latitude, longitude: vehicle.longitude),
                vehicleID: vehicle.vehicleID
            )
            newAnnotation.title = vehicle.vehicleID
            existingVehicleAnnotations[vehicle.vehicleID] = newAnnotation
            mapView.addAnnotation(newAnnotation)
        }
    }
    
    // 移除已下线的车辆标注
    let currentVehicleIDs = Set(vehicles.map { $0.vehicleID })
    let removedAnnotationIDs = existingVehicleAnnotations.keys.filter { !currentVehicleIDs.contains($0) }
    for removedID in removedAnnotationIDs {
        if let annotation = existingVehicleAnnotations.removeValue(forKey: removedID) {
            mapView.removeAnnotation(annotation)
        }
    }
    
    // 首次加载时自动适配地图显示范围
    guard isFirstLoad else { return }
    mapView.showAnnotations(mapView.annotations, animated: true)
    isFirstLoad = false
}

3. 如果需要自定义动画时长，不需要额外包裹动画块，在标注视图的代理方法中配置隐式动画参数即可：

func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
    guard let busAnnotation = annotation as? BusAnnotation else { return nil }
    let annotationView = mapView.dequeueReusableAnnotationView(withIdentifier: "BusAnnotation") ?? MKAnnotationView(annotation: busAnnotation, reuseIdentifier: "BusAnnotation")
    annotationView.annotation = busAnnotation
    // 配置标注样式
    annotationView.image = UIImage(named: "vehicle_pin")
    annotationView.canShowCallout = true
    return annotationView
}

注意：更新坐标时不需要移除再重加标注，只要保证自定义标注类的coordinate是可被KVO监听的动态属性，直接修改属性值就会自动获得平滑移动的过渡效果。

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