Mapbox中如何为Point Annotation指定高程以控制显示层级？

要让特定Point Annotation始终显示在其他注释上方，有两种可行方案，均基于Mapbox底层Symbol图层的渲染逻辑实现：

方案一：使用多个PointAnnotationManager分层 #

Mapbox中每个PointAnnotationManager对应一个独立的Symbol图层，图层的绘制顺序由创建顺序决定——后创建的Manager对应的图层会渲染在上方。

你可以把需要优先显示的注释放到晚创建的Manager中：

// 先创建低优先级注释管理器，对应底层图层
val lowPriorityManager = mapView.annotations.createPointAnnotationManager()
// 后创建高优先级注释管理器，对应顶层图层
val highPriorityManager = mapView.annotations.createPointAnnotationManager()

// 添加低优先级注释
val lowAnnotation = lowPriorityManager.create(
    PointAnnotationsOptions()
        .withPoint(low_point)
        .withIconImage(low_bitmap)
)

// 添加高优先级注释（始终显示在低优先级注释上方）
val highAnnotation = highPriorityManager.create(
    PointAnnotationsOptions()
        .withPoint(high_point)
        .withIconImage(high_bitmap)
)

方案二：设置Symbol Sort Key控制单Manager内注释层级 #

Point Annotation底层依赖Symbol图层，你可以通过withSymbolSortKey()方法为每个注释指定排序权重，数值越大的注释会渲染在更上层。

修改你的创建代码：

pointAnnotationManager = mapView.annotations.createPointAnnotationManager()
pointAnnotationManager.apply {
    annotationPosition = create(
        PointAnnotationsOptions()
            .withPoint(some_point)
            .withIconImage(some_bitmap)
            .withSymbolSortKey(10.0) // 高优先级设较大值，比如10；低优先级设1这类小值
    )
}

如果需要动态调整层级，更新注释时也可以修改该属性：

annotationPosition.point = new_point
annotationPosition.symbolSortKey = 20.0 // 动态提升该注释的显示层级
pointAnnotationManager.update(annotationPosition)

两种方案各有适用场景：如果注释类型区分明确，用多Manager更清晰；如果需要灵活调整单个注释的层级，用Sort Key更方便。

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