地图样式与数据驱动表达式
🎯 引言
学完本文,你能根据 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 | 读取到的属性 | 计算结果 |
|---|---|---|
| 位置 A | online、20 | 绿色、较小的圆 |
| 位置 B | warning、55 | 橙色、中等大小的圆 |
| 位置 C | offline、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 的写法叫相机表达式。
下面两张地图使用同一条路线和同一个表达式,只改变缩放级别。左侧是远景细线,右侧是近景粗线:
读取 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 的用途差异。
表达式超过两三层时,先在脚本中定义常量并写清业务含义:
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:专题图颜色越多越好吗?
不是。分类应与业务含义一致,并保持图例容易辨认。
🧪 小练习
- 用
match为三种状态设置颜色,并提供未知状态的兜底颜色。 - 用
interpolate让点半径在缩放级别 8 到 14 之间从 4 变为 10。
// 请在这里编写代码
🎉 恭喜你已经掌握数据驱动样式啦!
