地图样式与数据驱动表达式

使用 paint、layout 和 Mapbox 表达式,让颜色、大小和显隐随属性或缩放级别变化。

🎯 引言

学完本文,你能根据 Feature 的状态、等级和数值设置样式,并让图层随缩放级别呈现合适细节。


🧱 paint 与 layout 的分工

paint 控制颜色、透明度、线宽和圆半径等绘制效果;layout 控制显隐、文字内容、图标和符号排列等布局规则。

map.addLayer({
    id: 'places',
    type: 'circle',
    source: 'places',
    layout: { visibility: 'visible' },
    paint: {
        'circle-color': '#2563eb',
        'circle-radius': 7,
        'circle-opacity': 0.8,
    },
})

每种 Layer 支持的属性不同,不能把 line-width 写给 Circle Layer。


🎨 从 Feature 属性计算样式

同一个 Circle Layer 默认会把所有点画成相同颜色和大小。如果数据中的每个点具有不同状态和数值,就可以使用表达式读取这些字段,让 Mapbox 分别计算每个点的样式。

例如,下面三个 Feature 的 status 和 score 不同:

const places = {
    type: 'FeatureCollection',
    features: [
        {
            type: 'Feature',
            properties: { name: '位置 A', status: 'online', score: 20 },
            geometry: { type: 'Point', coordinates: [116.35, 39.91] },
        },
        {
            type: 'Feature',
            properties: { name: '位置 B', status: 'warning', score: 55 },
            geometry: { type: 'Point', coordinates: [116.40, 39.92] },
        },
        {
            type: 'Feature',
            properties: { name: '位置 C', status: 'offline', score: 90 },
            geometry: { type: 'Point', coordinates: [116.45, 39.89] },
        },
    ],
}

我们希望状态决定颜色,分数决定圆的大小。可以把表达式直接写进 paint:

map.addLayer({
    id: 'places',
    type: 'circle',
    source: 'places',
    paint: {
        'circle-color': [
            'match',
            ['get', 'status'],
            'online', '#16a34a',
            'warning', '#f59e0b',
            'offline', '#9ca3af',
            '#2563eb',
        ],
        'circle-radius': [
            'interpolate',
            ['linear'],
            ['get', 'score'],
            0, 7,
            100, 18,
        ],
    },
})

Mapbox 会为每个 Feature 单独执行表达式:

Feature读取到的属性计算结果
位置 Aonline、20绿色、较小的圆
位置 Bwarning、55橙色、中等大小的圆
位置 Coffline、90灰色、较大的圆

这里的 ['get', 'status'] 表示读取当前 Feature 的 properties.status。match 再把不同状态映射为颜色;['get', 'score'] 读取分数,interpolate 根据分数在半径 7 到 18 之间计算连续结果。

这样做的作用是:一份数据只需要一个 Layer,就能让不同 Feature 呈现不同样式,不必按状态拆成多个 Source,也不必在 JavaScript 中逐个修改圆点。

下面是这段表达式的真实地图效果,标签中的数字就是 score:


🧰 五个常用表达式怎么选

表达式解决的问题示例
get读取当前 Feature 的属性读取 status
match把有限类别映射为不同结果在线为绿色,离线为灰色
case按真假条件选择结果选中时显示描边
step按数值阈值分段数量达到 10、100 时增大圆点
interpolate让样式随数值连续变化分数越高,圆点逐渐变大

下面分别展示 case 和 step 的写法:

// selected 为 true 时显示 3 像素描边,否则不显示描边
'circle-stroke-width': [
    'case',
    ['==', ['get', 'selected'], true], 3,
    0,
]

// count 小于 10 时半径为 5,达到 10 时为 8,达到 100 时为 12
'circle-radius': [
    'step', ['get', 'count'],
    5,
    10, 8,
    100, 12,
]

字段可能缺失时,可用 coalesce 提供默认值,例如 ['coalesce', ['get', 'score'], 0]。这样没有 score 的 Feature 会按 0 参与计算,不会把 null 交给数值表达式。


🔍 让样式随 zoom 变化

zoom 表示地图缩放级别。缩放级别较小时,用户看到的是大范围地图,道路和边界线应该更细;放大到街区范围后,线可以变粗,避免在更详细的底图上看不清。

下面的表达式规定了两个关键值:

  • zoom 为 9 时,线宽是 2px。
  • zoom 为 14 时,线宽是 8px。
  • zoom 在 9 到 14 之间时,Mapbox 自动计算中间线宽。例如 zoom 为 11.5 时,线宽约为 5px。
'line-width': [
    'interpolate', ['linear'], ['zoom'],
    9, 2,
    14, 8,
]

它的作用不是修改路线数据,而是保证路线在不同地图尺度下都容易辨认。所有 Feature 在同一个缩放级别使用相同线宽,因此这类读取 zoom 的写法叫相机表达式。

下面两张地图使用同一条路线和同一个表达式,只改变缩放级别。左侧是远景细线,右侧是近景粗线:

zoom 9:线宽 2px
zoom 14:线宽 8px

读取 properties 的属性表达式会让不同 Feature 使用不同样式;读取 zoom 的相机表达式会让整个 Layer 随地图缩放一起变化。


💡 三类常见专题图

专题图是突出显示某一个业务字段的地图。它不是更换底图,而是把状态、等级或数值转换为颜色和大小,让用户不用逐个打开详情就能看出数据差异。

想回答的问题数据字段示例地图如何显示适合的表达式
哪些位置在线、离线或告警?status: 'online'每种状态使用固定颜色match
哪些区域属于低、中、高等级?risk: 72先按阈值分级,再为每级设置颜色step
哪些位置的数值更大?count: 86数值越大,圆点越大interpolate

状态颜色

状态是有限类别,不存在“在线和离线之间”的中间值。用 match 可以明确指定:在线为绿色、离线为灰色、告警为橙色。前面的表达式地图已经展示了这种效果。

等级颜色

风险分数是连续数字,但业务上只关心低、中、高三个等级,可以用 step 按阈值分段:

'fill-color': [
    'step', ['get', 'risk'],
    '#bbf7d0',
    40, '#fde68a',
    70, '#fca5a5',
]

risk 小于 40 时使用绿色,达到 40 后使用黄色,达到 70 后使用红色。

数值大小

当用户需要比较数量,而不是查看固定等级时,可以让圆点随数值连续变大:

'circle-radius': [
    'interpolate', ['linear'], ['get', 'count'],
    0, 6,
    100, 18,
]

count 为 0 时半径为 6px,为 100 时半径为 18px,中间数值由 Mapbox 自动计算。圆点大小必须设置上下限,避免小值看不见或大值遮住整张地图。

下面三张地图使用同一组数据,分别回答三个问题:对象是什么状态、数值属于哪个等级、数值之间相差多少。对比后可以直接看出 match、step 和 interpolate 的用途差异。

状态颜色:match
等级颜色:step
数值大小:interpolate

表达式超过两三层时,先在脚本中定义常量并写清业务含义:

const statusColor = [
    'match', ['get', 'status'],
    'online', '#16a34a',
    'offline', '#9ca3af',
    '#f59e0b',
]

map.setPaintProperty('places', 'circle-color', statusColor)

这样能避免把大段嵌套数组直接塞进 Layer 配置。


🧾 小节总结

  • paint 控制绘制效果,layout 控制布局和显隐。
  • get 读取 Feature 属性。
  • match 映射类别,case 判断条件。
  • step 适合分段,interpolate 适合连续变化。
  • zoom 相机表达式让样式随缩放级别变化。
  • 复杂表达式应提取为有业务名称的常量。

❓ 知识问答

Q1:step 的第一个结果为什么写在阈值前?

它是低于第一个阈值时的默认结果,后面按“阈值、结果”成对排列。

Q2:表达式能直接读取 Vue 的 ref 吗?

不能。表达式在 Mapbox 样式系统中执行,动态业务值需要通过 setPaintProperty、setFilter 或更新数据传入。

Q3:专题图颜色越多越好吗?

不是。分类应与业务含义一致,并保持图例容易辨认。


🧪 小练习

  1. 用 match 为三种状态设置颜色,并提供未知状态的兜底颜色。
  2. 用 interpolate 让点半径在缩放级别 8 到 14 之间从 4 变为 10。
// 请在这里编写代码

🎉 恭喜你已经掌握数据驱动样式啦!