如何在Mapbox iOS SDK中使用lineSortKey？及与LayerPosition的交互

一、lineSortKey的使用详情及示例 #

lineSortKey是Mapbox iOS Maps中LineLayer的属性，用于控制同一图层内多个线条要素的绘制顺序：值越大的线条，会被绘制在值较小的线条上方，从而覆盖下方的线条。

如果测试常量值时表现不符合预期，通常是因为所有线条使用了相同的常量值，此时图层内线条的顺序会由要素添加的先后顺序决定，而非lineSortKey。要实现自定义排序，需要结合要素属性使用表达式绑定，示例代码如下：

import MapboxMaps

// 构建带有排序键属性的线条要素
let lowerLine = LineString([
    CLLocationCoordinate2D(latitude: 39.9042, longitude: 116.4074),
    CLLocationCoordinate2D(latitude: 39.9152, longitude: 116.4074)
])
lowerLine.properties = ["zIndex": 1.0]

let upperLine = LineString([
    CLLocationCoordinate2D(latitude: 39.9092, longitude: 116.4004),
    CLLocationCoordinate2D(latitude: 39.9092, longitude: 116.4144)
])
upperLine.properties = ["zIndex": 2.0]

// 创建数据源并添加要素
let source = GeoJSONSource(id: "cross-lines-source", features: [lowerLine, upperLine])
try? mapView.mapboxMap.addSource(source)

// 创建LineLayer并绑定lineSortKey
let lineLayer = LineLayer(id: "cross-lines-layer", source: source.id)
lineLayer.lineColor = .constant(.blue)
lineLayer.lineWidth = .constant(8.0)
// 通过表达式获取要素的zIndex属性作为排序键
lineLayer.lineSortKey = .expression(.get("zIndex"))

// 将图层添加到地图
mapView.mapboxMap.addLayer(lineLayer)

在这个示例中，upperLine的zIndex值更大，会被绘制在lowerLine上方，交叉位置会覆盖下方线条。如果需要临时调整某类线条的层级，也可以直接设置常量值（比如.constant(3.0)），此时该图层内所有线条都会使用这个值，排序回到要素添加顺序。

二、与LayerPosition的交互逻辑 #

lineSortKey和LayerPosition是两个层级的排序控制逻辑，互不冲突但有明确优先级：

• LayerPosition用于控制不同图层之间的绘制顺序：比如你可以指定某个LineLayer绘制在CircleLayer的上方，或者放在另一个LineLayer的下方，通过addLayer(_:position:)方法的position参数设置。
• lineSortKey用于控制同一LineLayer内部线条要素的绘制顺序：仅对当前图层内的线条生效，不影响其他图层的位置。
• 优先级规则：先由LayerPosition确定不同图层的上下关系，同一图层内部再由lineSortKey决定线条的绘制顺序。例如，LayerA通过LayerPosition设置在LayerB上方，那么LayerA中所有线条无论lineSortKey值多少，都会显示在LayerB的线条上方；而LayerA内部，lineSortKey值大的线条会覆盖本图层内值小的线条。

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