Mapbox V10无法移动AnnotationView 动态更新标注位置问题咨询

v10版本把数据层和渲染层做了拆分，和v6的引用式Annotation设计逻辑不一样，不用反复删加标注，按下面的方案实现就能满足高频位置更新的性能要求。

方案一：优先选（性能最高，适合多用户高频位置更新场景） #

如果你的位置标注不需要复杂的原生UI交互、动画，只是展示用户位置图标/简单文字，不要用ViewAnnotation，用PointAnnotationManager做批量更新，性能是删加方案的10倍以上，上百个点位同时更新也不会掉帧。
核心逻辑：提前缓存每个设备对应的标注实例，更新时只修改坐标，一次性同步给标注管理器，不需要任何新增/删除操作。

// 页面持有标注管理器和标注缓存，避免每次更新重复创建
private var userAnnotationManager: PointAnnotationManager!
private var userAnnotationCache: [String: PointAnnotation] = [:] // key为设备ID

// 地图加载完成后初始化一次标注管理器
func initUserAnnotationManager() {
    userAnnotationManager = mapView.annotations.makePointAnnotationManager()
    // 提前配置标注的全局样式，后续更新位置不需要重复设置
    userAnnotationManager.iconAllowOverlap = true
    userAnnotationManager.iconImage = UIImage(named: "user_marker")
    userAnnotationManager.iconAnchor = .center
    userAnnotationManager.textAllowOverlap = true
}

// 收到用户位置更新时直接调用这个方法
func refreshUserLocation(deviceId: String, coordinate: CLLocationCoordinate2D) {
    if var annotation = userAnnotationCache[deviceId] {
        // 已存在的标注直接修改坐标
        annotation.point = Point(coordinate)
        userAnnotationCache[deviceId] = annotation
    } else {
        // 首次出现的用户新建标注，绑定设备ID存入缓存
        var newAnnotation = PointAnnotation(point: Point(coordinate))
        newAnnotation.id = deviceId
        userAnnotationCache[deviceId] = newAnnotation
    }
    // 批量同步所有标注状态给管理器，底层一次性渲染完成
    userAnnotationManager.annotations = Array(userAnnotationCache.values)
}

方案二：必须用自定义UIView标注的场景 #

如果你的标注需要复杂UI、点击交互、自定义动画，必须用ViewAnnotation的话，核心是只在首次出现用户时创建添加视图，后续更新只改坐标，绝对不要反复删建视图。
你之前遇到update不生效、重复标注的问题，本质是没有缓存已添加的视图实例，每次触发更新都重复走新增逻辑，加上异步渲染的时序差就会生成重复标注。
正确实现代码：

// 持有自定义视图缓存
private var userMarkerViewCache: [String: UIView] = [:]

func updateUserMarker(device: String, location: CLLocation) {
    guard let mapView = mapView else { return }
    
    if let existedMarker = userMarkerViewCache[device] {
        // 已存在的标注只更新坐标，不需要传宽高、锚点等固定参数
        let updateOptions = ViewAnnotationOptions(geometry: Point(location.coordinate))
        try? mapView.viewAnnotations.update(existedMarker, options: updateOptions)
        return
    }
    
    // 首次出现该用户时才创建、添加视图，只执行一次
    let newMarker = createSampleView(withText: "Hello world!")
    let addOptions = ViewAnnotationOptions(
        geometry: Point(location.coordinate),
        width: 100,
        height: 40,
        associatedFeatureId: device,
        allowOverlap: true, // 实时位置场景必须开，否则点位靠近时会被自动隐藏
        anchor: .center
    )
    try? mapView.viewAnnotations.add(newMarker, options: addOptions)
    userMarkerViewCache[device] = newMarker
}

之前踩坑的核心原因 #

• PointAnnotation是值类型，之前觉得不能直接改坐标，是因为没有持有修改后的标注实例，也没有批量同步给管理器，不是SDK不支持直接更新位置
• 反复remove/add标注会触发地图UI层级刷新、视图销毁重建，高频调用下不仅卡顿，还会因为渲染时序问题出现重复标注、位置漂移
• 最初的update逻辑不生效，是因为没有缓存已添加的视图，每次调用都拿不到已存在的标注实例，重复触发新增逻辑。

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