在MapBox表达式中正确传递null值的方法（iOS SDK适配问题）

我有部分属性含Null值的矢量瓦片数据，需要给带Null值的要素设置差异化样式/颜色，同时支持用户基于该属性过滤要素（必须在表达式中显式处理Null值）。

Mapbox GL JS 中的实现参考 #

在Web端处理逻辑很直观：

1. 设置样式

paint: {
  'line-color': ['case',
                  ['==',['get','ratio'],null],'#cccccc',
                  '#ffffb2'
                ]
}

2. 设置过滤器

const filter_set = ["any",["==",["get","ratio"],null]];
mapRef.current.setFilter('road',filter_set);

3. 清除过滤器

mapRef.current.setFilter('road',null);

iOS SDK 遇到的问题 #

由于Swift没有和JavaScript一致的Null类型，直接照搬Web端逻辑会出现各种问题：

1. 样式匹配失效与类型警告 #

• 直接匹配字符串"null"无法命中属性为Null的要素：

Exp(.eq) {
    Exp(.get) { "ratio" }
    "null"
}
"#cccccc"

• 改用toString转换后虽能实现样式，但会触发控制台类型警告：{}[Style]: The expression ["get","ratio"] evaluated to null but was expected to be of type number.

Exp(.eq) {
    Exp(.toString) { Exp(.get) { "ratio" } }
    ""
}
"#cccccc"

2. 过滤器与图层属性解码冲突 #

用[Any]手动构造过滤器能部分实现功能，但更新过滤器后，调用layer(withId:)获取图层可见性时会抛出解码错误：

// 设置过滤器
let filter: [Any] = ["any",
        ["==", ["get", "ratio"], NSNull()]
    ]

try? mapView.mapboxMap.setLayerProperty(for: "road", property: "filter", value: filter)


// 清除过滤器
try? mapView.mapboxMap.setLayerProperty(for: "road", property: "filter", value: NSNull())

错误信息：

Error getting current layer visibility: dataCorrupted(Swift.DecodingError.Context(codingPath: [RootCodingKeys(stringValue: "filter", intValue: nil), _CodingKey(stringValue: "Index 1", intValue: 1)], debugDescription: "Failed to decode ExpressionArgument", underlyingError: nil))

解决方案 #

1. 样式设置：使用is-null表达式 #

直接用Mapbox iOS SDK提供的isNil表达式匹配Null属性，避免类型转换和警告：

Exp(.case) {
    Exp(.isNil) { Exp(.get) { "ratio" } }
    "#cccccc"
    "#ffffb2"
}

2. 过滤器设置：用类型安全API替代手动构造 #

不要用[Any]拼接过滤器，改用SDK提供的类型安全表达式API，从根源避免解码错误：

// 设置过滤器：匹配ratio为Null的要素
let filter = Exp(.any) {
    Exp(.isNil) { Exp(.get) { "ratio" } }
}
try? mapView.mapboxMap.setFilter(for: "road", filter: filter)

// 清除过滤器
try? mapView.mapboxMap.setFilter(for: "road", filter: nil)

3. 安全获取图层可见性 #

改用类型安全的方式获取属性，或者直接通过图层对象读取：

// 方式1：直接读取属性值
if let visibility = try? mapView.mapboxMap.layerProperty(for: "road", property: "visibility") as? String {
    // 处理可见性，如"visible"或"none"
}

// 方式2：通过图层对象读取（需确保图层类型正确）
if let lineLayer = mapView.mapboxMap.style.layer(withId: "road") as? LineLayer {
    let currentVisibility = lineLayer.visibility
}

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