图层

样式的layers属性列出了该样式中可用的所有图层。图层类型由type属性指定，必须是以下类型之一：background、fill、line、symbol、raster、circle、fill-extrusion、heatmap、hillshade、color-relief。

除了background类型的图层外，每个图层都需要引用一个数据源。图层从数据源获取数据，可选择性地过滤要素，然后定义这些要素的样式。

layers: [
    {
        "id": "coastline",
        "source": "maplibre",
        "source-layer": "countries",
        "type": "line",
        "paint": {
            "line-color": "#0099ff"
        }
    },
    ...
]

图层属性

id

必需的字符串。

图层的唯一标识符。

type

必需的枚举值。可能的值：background、fill、line、symbol、raster、circle、fill-extrusion、heatmap、hillshade、color-relief。

图层的渲染类型。

• background：背景色或图案，不引用源数据
• fill：填充多边形
• line：线条
• symbol：符号标签图标
• raster：栅格瓦片
• circle：填充圆
• fill-extrusion：带有高度的填充多边形
• heatmap：热力图
• hillshade：山体阴影
• color-relief：色彩地形图

metadata

可选的对象。

任意属性，用于应用特定的元数据。属性名称应以命名空间为前缀，以避免冲突，如maplibre:。

source

除background图层外，所有图层都必需的字符串。

数据源的名称，必须与样式的sources中定义的源之一匹配。

source-layer

对矢量瓦片源必需的字符串。

图层的源图层名称，该图层包含要素的几何数据。对于矢量瓦片源，这是矢量瓦片包含的原始图层之一。

minzoom

可选数值。默认为0。

图层可见的最小缩放级别。在低于此缩放级别时，图层将被隐藏。

maxzoom

可选数值。默认为24。

图层可见的最大缩放级别。在高于此缩放级别时，图层将被隐藏。

filter

可选表达式。

一个表达式，指定源要素的条件，满足条件的要素才会在图层中显示。

layout

可选对象。

布局属性。

paint

可选对象。

绘制属性。

背景层

visibility

布局属性。可选枚举值。可能的值：visible、none。默认为"visible"。

此图层是否显示。

• visible：图层显示。
• none：图层不显示。

background-color

绘制属性。可选颜色。默认为"#000000"。支持插值表达式。可过渡。

背景的颜色。

background-pattern

绘制属性。可选字符串。可过渡。

用于绘制背景的图像的名称。为了实现平滑的过渡效果，此参数支持跨缩放级别的插值。

background-opacity

绘制属性。可选范围为[0, 1]的数值。默认为1。支持插值表达式。可过渡。

背景的不透明度。

填充图层

fill-sort-key

布局属性。可选数值。支持数据驱动样式。

用于按升序对要素进行排序的值。要素将按照排序键的值从低到高的顺序绘制。排序键相同的要素将按照它们在数据源中出现的顺序绘制。

visibility

布局属性。可选枚举值。可能的值：visible、none。默认为"visible"。

此图层是否显示。

• visible：图层显示。
• none：图层不显示。

fill-antialias

绘制属性。可选布尔值。默认为true。

是否对填充多边形进行抗锯齿处理。

fill-opacity

绘制属性。可选范围为[0, 1]的数值。默认为1。支持数据驱动样式和插值表达式。可过渡。

填充的不透明度。

fill-color

绘制属性。可选颜色。默认为"#000000"。支持数据驱动样式和插值表达式。可过渡。

填充的颜色。仅当未指定fill-pattern时使用。

fill-outline-color

绘制属性。可选颜色。支持数据驱动样式和插值表达式。可过渡。

填充轮廓的颜色。仅当未指定fill-pattern时使用。

fill-translate

绘制属性。可选以像素为单位的数值数组[x, y]。默认为[0, 0]。支持插值表达式。可过渡。

填充的几何体相对于其原始位置的平移距离。

fill-translate-anchor

绘制属性。可选枚举值。可能的值：map、viewport。默认为"map"。

控制fill-translate的参考框架。

• map：填充相对于地图平移。
• viewport：填充相对于视口平移。

fill-pattern

绘制属性。可选字符串。支持数据驱动样式。可过渡。

用于绘制填充的图像的名称。为了实现平滑的过渡效果，此参数支持跨缩放级别和时间的插值。

圆形图层

circle-sort-key

布局属性。可选数值。支持数据驱动样式。

用于按升序对要素进行排序的值。要素将按照排序键的值从低到高的顺序绘制。排序键相同的要素将按照它们在数据源中出现的顺序绘制。

visibility

布局属性。可选枚举值。可能的值：visible、none。默认为"visible"。

此图层是否显示。

• visible：图层显示。
• none：图层不显示。

circle-radius

绘制属性。可选以像素为单位的数值。默认为5。支持数据驱动样式和插值表达式。可过渡。

圆的半径。

circle-color

绘制属性。可选颜色。默认为"#000000"。支持数据驱动样式和插值表达式。可过渡。

圆的填充颜色。

circle-blur

绘制属性。可选数值。默认为0。支持数据驱动样式和插值表达式。可过渡。

模糊应用于圆的量，定义为圆半径的1/4。

circle-opacity

绘制属性。可选范围为[0, 1]的数值。默认为1。支持数据驱动样式和插值表达式。可过渡。

圆的不透明度。

circle-translate

绘制属性。可选以像素为单位的数值数组[x, y]。默认为[0, 0]。支持插值表达式。可过渡。

圆的几何体相对于其原始位置的平移距离。

circle-translate-anchor

绘制属性。可选枚举值。可能的值：map、viewport。默认为"map"。

控制circle-translate的参考框架。

• map：圆相对于地图平移。
• viewport：圆相对于视口平移。

circle-pitch-scale

绘制属性。可选枚举值。可能的值：map、viewport。默认为"map"。

控制圆的缩放行为。

• map：圆将随地图缩放，但在俯仰时保持原始大小。
• viewport：圆将随地图缩放，并随地图俯仰而缩放。

circle-pitch-alignment

绘制属性。可选枚举值。可能的值：map、viewport。默认为"viewport"。

控制圆的轴对齐方式。

• map：圆与地图平面对齐。
• viewport：圆与视口平面对齐。

circle-stroke-width

绘制属性。可选以像素为单位的数值。默认为0。支持数据驱动样式和插值表达式。可过渡。

圆描边的宽度。

circle-stroke-color

绘制属性。可选颜色。默认为"#000000"。支持数据驱动样式和插值表达式。可过渡。

圆描边的颜色。

circle-stroke-opacity

绘制属性。可选范围为[0, 1]的数值。默认为1。支持数据驱动样式和插值表达式。可过渡。

圆描边的不透明度。

热力图

visibility

布局属性。可选枚举值。可能的值：visible、none。默认为"visible"。

此图层是否显示。

• visible：图层显示。
• none：图层不显示。

heatmap-radius

绘制属性。可选以像素为单位的数值。默认为30。支持数据驱动样式和插值表达式。可过渡。

每个热点的影响半径，以像素为单位。值越大，热点之间的平滑度越高。

heatmap-weight

绘制属性。可选数值。默认为1。支持数据驱动样式和插值表达式。

权重衡量每个热点对热图强度的贡献。大于0的值可以用作乘数，值越大影响越大，值为0表示没有贡献。

heatmap-intensity

绘制属性。可选数值。默认为1。支持插值表达式。可过渡。

与热图权重相似，但影响所有像素的热图强度。

heatmap-color

绘制属性。可选颜色。默认为使用["interpolate",["linear"],["heatmap-density"],0,"rgba(0, 0, 255, 0)",0.1,"royalblue",0.3,"cyan",0.5,"lime",0.7,"yellow",1,"red"]表示的颜色梯度。支持插值表达式。

定义热图的颜色梯度，从低到高的密度。这是一个颜色映射：一组输入密度值 (0-1) 和对应的输出颜色。

heatmap-opacity

绘制属性。可选范围为[0, 1]的数值。默认为1。支持插值表达式。可过渡。

整个热图图层的不透明度。

填充挤出

visibility

布局属性。可选枚举值。可能的值：visible、none。默认为"visible"。

此图层是否显示。

• visible：图层显示。
• none：图层不显示。

fill-extrusion-opacity

绘制属性。可选范围为[0, 1]的数值。默认为1。支持插值表达式。可过渡。

填充挤出的整体不透明度。

fill-extrusion-color

绘制属性。可选颜色。默认为"#000000"。支持数据驱动样式和插值表达式。可过渡。

填充挤出的颜色。仅当未指定fill-extrusion-pattern时使用。

fill-extrusion-translate

绘制属性。可选以像素为单位的数值数组[x, y]。默认为[0, 0]。支持插值表达式。可过渡。

填充挤出的几何体相对于其原始位置的平移距离。

fill-extrusion-translate-anchor

绘制属性。可选枚举值。可能的值：map、viewport。默认为"map"。

控制fill-extrusion-translate的参考框架。

• map：填充挤出相对于地图平移。
• viewport：填充挤出相对于视口平移。

fill-extrusion-pattern

绘制属性。可选字符串。支持数据驱动样式。可过渡。

用于绘制填充挤出的图像的名称。为了实现平滑的过渡效果，此参数支持跨缩放级别和时间的插值。

fill-extrusion-height

绘制属性。可选数值。默认为0。支持数据驱动样式和插值表达式。可过渡。

填充挤出的高度，单位为米。如果省略，或者值为0，则多边形将被渲染为平面多边形。

fill-extrusion-base

绘制属性。可选数值。默认为0。支持数据驱动样式和插值表达式。可过渡。

填充挤出的基础高度，单位为米。与高度属性不同，基础高度定义了挤出的几何体底部的海拔高度，允许填充不从地面开始。

fill-extrusion-vertical-gradient

绘制属性。可选布尔值。默认为true。

是否显示填充挤出的垂直渐变。

线条图层

line-cap

布局属性。可选枚举值。可能的值：butt、round、square。默认为"butt"。

线条末端的显示方式。

• butt：线条末端为平直的，垂直于线条的方向。
• round：线条末端为半圆形。
• square：线条末端为半正方形，长度等于线宽的一半。

line-join

布局属性。可选枚举值。可能的值：bevel、round、miter。默认为"miter"。支持数据驱动样式。

线条连接处的显示方式。

• bevel：连接处为平角。
• round：连接处为圆角。
• miter：连接处为尖角。

line-miter-limit

布局属性。可选数值。默认为2。

尖角（miter）连接的限制比例，用于控制尖角的长度。

line-round-limit

布局属性。可选数值。默认为1.05。

圆角连接的限制比例，用于控制圆角的平滑度。

line-sort-key

布局属性。可选数值。支持数据驱动样式。

用于按升序对要素进行排序的值。要素将按照排序键的值从低到高的顺序绘制。排序键相同的要素将按照它们在数据源中出现的顺序绘制。

visibility

布局属性。可选枚举值。可能的值：visible、none。默认为"visible"。

此图层是否显示。

• visible：图层显示。
• none：图层不显示。

line-opacity

绘制属性。可选范围为[0, 1]的数值。默认为1。支持数据驱动样式和插值表达式。可过渡。

线条的不透明度。

line-color

绘制属性。可选颜色。默认为"#000000"。支持数据驱动样式和插值表达式。可过渡。

线条的颜色。如果指定了line-pattern，则此值将被忽略。

line-translate

绘制属性。可选以像素为单位的数值数组[x, y]。默认为[0, 0]。支持插值表达式。可过渡。

线条的几何体相对于其原始位置的平移距离。

line-translate-anchor

绘制属性。可选枚举值。可能的值：map、viewport。默认为"map"。

控制line-translate的参考框架。

• map：线条相对于地图平移。
• viewport：线条相对于视口平移。

line-width

绘制属性。可选以像素为单位的数值。默认为1。支持数据驱动样式和插值表达式。可过渡。

线条的宽度。

line-gap-width

绘制属性。可选以像素为单位的数值。默认为0。支持数据驱动样式和插值表达式。可过渡。

线条轮廓之间的间隙宽度。

line-offset

绘制属性。可选以像素为单位的数值。默认为0。支持数据驱动样式和插值表达式。可过渡。

线条相对于其路径的偏移量。正值表示向右偏移，负值表示向左偏移。

line-blur

绘制属性。可选以像素为单位的数值。默认为0。支持数据驱动样式和插值表达式。可过渡。

模糊应用于线条的量。

line-dasharray

绘制属性。可选以像素为单位的数值数组。可过渡。

指定用于创建虚线模式的交替虚线和间隔的长度。数组中的数值被解释为像素长度交替的虚线和间隔。

line-pattern

绘制属性。可选字符串。支持数据驱动样式。可过渡。

用于绘制线条的图像的名称。为了实现平滑的过渡效果，此参数支持跨缩放级别和时间的插值。

line-gradient

绘制属性。可选颜色。支持插值表达式。

线条的颜色渐变。仅适用于line-width大于0且未指定line-pattern的线条。line-gradient不能与使用line-dasharray的线条一起使用。

符号图层

symbol-placement

布局属性。可选枚举值。可能的值：point、line、line-center。默认为"point"。

标签或图标放置的位置。

• point：标签放置在几何体的中心点。
• line：标签沿着线几何体放置。
• line-center：标签放置在线几何体的中心。

symbol-spacing

布局属性。可选以像素为单位的数值。默认为250。支持插值表达式。

两个相邻符号之间的距离。仅适用于symbol-placement为line的符号。

symbol-avoid-edges

布局属性。可选布尔值。默认为false。

如果为true，则符号不会跨越tile边界放置。如果为false，则符号可以跨越tile边界放置。

symbol-sort-key

布局属性。可选数值。支持数据驱动样式。

用于按升序对要素进行排序的值。符号将按照排序键的值从低到高的顺序绘制。排序键相同的符号将按照它们在数据源中出现的顺序绘制。

symbol-z-order

布局属性。可选枚举值。可能的值：auto、viewport-y、source。默认为"auto"。

决定如何根据其他符号排列此图层中的符号。

• auto：当symbol-sort-key不存在或相等时，将按照以下顺序对符号进行排序：1. 如果设置了symbol-sort-key，则按该值升序排序。2. 如果未设置symbol-sort-key或值相等，则y位置从下到上排序。3. 如果y位置相等，则按数据源排序。
• viewport-y：符号按其y位置从下到上排序。
• source：符号按照它们在数据源中出现的顺序排序。

icon-allow-overlap

布局属性。可选布尔值。默认为false。支持插值表达式。

如果为true，即使与先前放置的图标重叠，也会显示图标。

icon-overlap

布局属性。可选枚举值。可能的值：never、always、cooperative。默认为"never"。支持插值表达式。

决定图标之间如何避免碰撞。

• never：不允许图标重叠。与icon-allow-overlap: false的行为相同。
• always：允许图标重叠。与icon-allow-overlap: true的行为相同。
• cooperative：如果与先前放置的相同字段的符号重叠，则防止图标碰撞。但可以与来自不同字段的符号重叠。

icon-ignore-placement

布局属性。可选布尔值。默认为false。支持插值表达式。

如果为true，即使此图标的放置会影响其他符号的放置，也会显示此图标。

icon-optional

布局属性。可选布尔值。默认为false。支持插值表达式。

如果为true，则文本可以显示而不必显示其对应的图标，反之亦然。

icon-rotation-alignment

布局属性。可选枚举值。可能的值：map、viewport、auto。默认为"auto"。支持插值表达式。

决定图标的旋转行为。

• map：图标相对于地图的旋转角度。
• viewport：图标相对于视口旋转。
• auto：自动选择对齐方式。当symbol-placement为point时，等同于viewport；当symbol-placement为line时，等同于map。

icon-size

布局属性。可选数值。默认为1。支持数据驱动样式和插值表达式。

调整原始图标大小的比例因子。

icon-text-fit

布局属性。可选枚举值。可能的值：none、width、height、both。默认为"none"。支持插值表达式。

决定图标是否拉伸以适应文本。

• none：图标不会调整大小以适应文本。
• width：图标的宽度调整为文本的宽度。
• height：图标的高度调整为文本的高度。
• both：图标的宽度和高度都调整为文本的尺寸。

icon-text-fit-padding

布局属性。可选以像素为单位的数值数组[x, y]或[top, right, bottom, left]。默认为[0, 0, 0, 0]。支持插值表达式。

调整后的图标与文本之间的内边距。

icon-image

布局属性。可选字符串。支持数据驱动样式和插值表达式。

包含图标图像的精灵表中的图像的名称。

icon-rotate

布局属性。可选以度为单位的数值。默认为0。支持数据驱动样式和插值表达式。

图标的旋转角度，顺时针方向。

icon-padding

布局属性。可选以像素为单位的数值。默认为2。支持插值表达式。

图标的内边距，用于确定图标周围的碰撞检测区域。

icon-keep-upright

布局属性。可选布尔值。默认为false。支持插值表达式。

如果为true，则图标可以上下翻转，以防止它们被渲染为倒置。仅当icon-rotation-alignment设置为map并且symbol-placement设置为line或line-center时适用。

icon-offset

布局属性。可选数值数组[x, y]。默认为[0, 0]。支持数据驱动样式和插值表达式。

图标相对于其原始位置的偏移距离。正x值将图标向右移动，正y值将图标向下移动。

icon-anchor

布局属性。可选枚举值。可能的值：center、left、right、top、bottom、top-left、top-right、bottom-left、bottom-right。默认为"center"。支持数据驱动样式和插值表达式。

图标相对于其位置的锚点部分。

icon-pitch-alignment

布局属性。可选枚举值。可能的值：map、viewport、auto。默认为"auto"。支持插值表达式。

当地图倾斜时，图标的方向。

• map：图标与地图平面对齐。
• viewport：图标与视口平面对齐。
• auto：自动选择对齐方式。当icon-rotation-alignment为map时，等同于map；当icon-rotation-alignment为viewport时，等同于viewport。

text-pitch-alignment

布局属性。可选枚举值。可能的值：map、viewport、auto。默认为"auto"。支持插值表达式。

当地图倾斜时，文本的方向。

• map：文本与地图平面对齐。
• viewport：文本与视口平面对齐。
• auto：自动选择对齐方式。当text-rotation-alignment为map时，等同于map；当text-rotation-alignment为viewport时，等同于viewport。

text-rotation-alignment

布局属性。可选枚举值。可能的值：map、viewport、auto。默认为"auto"。支持插值表达式。

决定文本的旋转行为。

• map：文本相对于地图的旋转角度。
• viewport：文本相对于视口旋转。
• auto：自动选择对齐方式。当symbol-placement为point时，等同于viewport；当symbol-placement为line时，等同于map。

text-field

布局属性。可选格式化文本。默认为""。支持数据驱动样式和插值表达式。

要显示的文本内容。支持文字格式化表达式。

text-font

布局属性。可选字符串数组。默认为["Open Sans Regular", "Arial Unicode MS Regular"]。支持数据驱动样式和插值表达式。

用于显示文本的字体堆栈。第一个指定的字体如果可用将被使用，如果不可用，将使用堆栈中的下一个字体，依此类推。

text-size

布局属性。可选以像素为单位的数值。默认为16。支持数据驱动样式和插值表达式。

文本字体的大小。

text-max-width

布局属性。可选以文本的EM为单位的数值。默认为10。支持数据驱动样式和插值表达式。

文本换行的最大行宽。

text-line-height

布局属性。可选以文本的EM为单位的数值。默认为1.2。支持插值表达式。

文本的行高。

text-letter-spacing

布局属性。可选以文本的EM为单位的数值。默认为0。支持数据驱动样式和插值表达式。

文本字母之间的距离。

text-justify

布局属性。可选枚举值。可能的值：auto、left、center、right。默认为"center"。支持数据驱动样式和插值表达式。

文本的对齐方式。

• auto：自动选择对齐方式。在LTR文本中，等同于left；在RTL文本中，等同于right。
• left：文本左对齐。
• center：文本居中对齐。
• right：文本右对齐。

text-radial-offset

布局属性。可选以文本的EM为单位的数值。支持数据驱动样式和插值表达式。

文本相对于其锚点的径向偏移量。正值表示远离锚点，负值表示向锚点靠近。如果与text-variable-anchor结合使用，则值为相对于由文本变量锚点计算得出的最终锚点。

text-variable-anchor

布局属性。可选枚举值数组。可能的值：center、left、right、top、bottom、top-left、top-right、bottom-left、bottom-right。支持插值表达式。

要为文本尝试的锚点位置的顺序。

text-variable-anchor-offset

布局属性。可选数值数组[[x, y], [x, y], ...]。支持数据驱动样式。

与text-variable-anchor锚点对应的偏移量数组。这些偏移量将用于调整基于text-variable-anchor生成的标签位置。如果此数组短于text-variable-anchor数组，则超出的锚点将使用text-offset。

text-anchor

布局属性。可选枚举值。可能的值：center、left、right、top、bottom、top-left、top-right、bottom-left、bottom-right。默认为"center"。支持数据驱动样式和插值表达式。

文本相对于其位置的锚点部分。

text-max-angle

布局属性。可选以度为单位的数值。默认为45。支持插值表达式。

当symbol-placement为line时，确定两个相邻字符之间的最大角度变化。

text-writing-mode

布局属性。可选枚举值数组。可能的值：horizontal、vertical。支持插值表达式。

文本的书写模式。

• horizontal：水平文本。
• vertical：垂直文本。

text-rotate

布局属性。可选以度为单位的数值。默认为0。支持数据驱动样式和插值表达式。

文本的旋转角度，顺时针方向。

text-padding

布局属性。可选以像素为单位的数值。默认为2。支持插值表达式。

文本的内边距，用于确定文本周围的碰撞检测区域。

text-keep-upright

布局属性。可选布尔值。默认为true。支持插值表达式。

如果为true，则文本可以上下翻转，以防止它们被渲染为倒置。仅当text-rotation-alignment设置为map并且symbol-placement设置为line或line-center时适用。

text-transform

布局属性。可选枚举值。可能的值：none、uppercase、lowercase。默认为"none"。支持数据驱动样式和插值表达式。

指定如何大小写文本。

• none：文本不做大小写转换。
• uppercase：文本转为大写。
• lowercase：文本转为小写。

text-offset

布局属性。可选数值数组[x, y]。默认为[0, 0]。支持数据驱动样式和插值表达式。

文本相对于其原始位置的偏移距离。正x值将文本向右移动，正y值将文本向下移动。

text-allow-overlap

布局属性。可选布尔值。默认为false。支持插值表达式。

如果为true，即使与先前放置的文本重叠，也会显示文本。

text-overlap

布局属性。可选枚举值。可能的值：never、always、cooperative。默认为"never"。支持插值表达式。

决定文本之间如何避免碰撞。

• never：不允许文本重叠。与text-allow-overlap: false的行为相同。
• always：允许文本重叠。与text-allow-overlap: true的行为相同。
• cooperative：如果与先前放置的相同字段的符号重叠，则防止文本碰撞。但可以与来自不同字段的符号重叠。

text-ignore-placement

布局属性。可选布尔值。默认为false。支持插值表达式。

如果为true，即使此文本的放置会影响其他符号的放置，也会显示此文本。

text-optional

布局属性。可选布尔值。默认为false。支持插值表达式。

如果为true，则图标可以显示而不必显示其对应的文本，反之亦然。

icon-opacity

绘制属性。可选范围为[0, 1]的数值。默认为1。支持数据驱动样式和插值表达式。可过渡。

图标的不透明度。

icon-color

绘制属性。可选颜色。默认为"#000000"。支持数据驱动样式和插值表达式。可过渡。

图标的颜色。仅适用于可着色的图标。

icon-halo-color

绘制属性。可选颜色。默认为"rgba(0, 0, 0, 0)"。支持数据驱动样式和插值表达式。可过渡。

图标的光晕颜色。图标光晕只能应用于可着色的图标。

icon-halo-width

绘制属性。可选以像素为单位的数值。默认为0。支持数据驱动样式和插值表达式。可过渡。

图标光晕的宽度。

icon-halo-blur

绘制属性。可选以像素为单位的数值。默认为0。支持数据驱动样式和插值表达式。可过渡。

图标光晕的模糊量。

icon-translate

绘制属性。可选以像素为单位的数值数组[x, y]。默认为[0, 0]。支持插值表达式。可过渡。

图标相对于其原始位置的平移距离。

icon-translate-anchor

绘制属性。可选枚举值。可能的值：map、viewport。默认为"map"。

控制icon-translate的参考框架。

• map：图标相对于地图平移。
• viewport：图标相对于视口平移。

text-opacity

绘制属性。可选范围为[0, 1]的数值。默认为1。支持数据驱动样式和插值表达式。可过渡。

文本的不透明度。

text-color

绘制属性。可选颜色。默认为"#000000"。支持数据驱动样式和插值表达式。可过渡。

文本的颜色。

text-halo-color

绘制属性。可选颜色。默认为"rgba(0, 0, 0, 0)"。支持数据驱动样式和插值表达式。可过渡。

文本的光晕颜色。

text-halo-width

绘制属性。可选以像素为单位的数值。默认为0。支持数据驱动样式和插值表达式。可过渡。

文本光晕的宽度。

text-halo-blur

绘制属性。可选以像素为单位的数值。默认为0。支持数据驱动样式和插值表达式。可过渡。

文本光晕的模糊量。

text-translate

绘制属性。可选以像素为单位的数值数组[x, y]。默认为[0, 0]。支持插值表达式。可过渡。

文本相对于其原始位置的平移距离。

text-translate-anchor

绘制属性。可选枚举值。可能的值：map、viewport。默认为"map"。

控制text-translate的参考框架。

• map：文本相对于地图平移。
• viewport：文本相对于视口平移。

栅格图层

visibility

布局属性。可选枚举值。可能的值: visible, none。默认为 "visible"。

该图层是否显示。

• visible: 图层可见。
• none: 图层不可见。

raster-opacity

绘制属性。可选数值，范围[0, 1]。默认为 1。支持插值表达式。可过渡。

栅格图层的不透明度。

raster-hue-rotate

绘制属性。可选数值，单位为度，默认为 0。支持插值表达式。可过渡。

应用于栅格图层的色相旋转。值以度为单位。

raster-brightness-min

绘制属性。可选数值，范围[0, 1]。默认为 0。支持插值表达式。可过渡。

提高低亮度像素的亮度，而高亮度像素保持不变。

raster-brightness-max

绘制属性。可选数值，范围[0, 1]。默认为 1。支持插值表达式。可过渡。

降低高亮度像素的亮度，而低亮度像素保持不变。

raster-saturation

绘制属性。可选数值，范围[-1, 1]。默认为 0。支持插值表达式。可过渡。

调整栅格图层的饱和度。

raster-contrast

绘制属性。可选数值，范围[-1, 1]。默认为 0。支持插值表达式。可过渡。

调整栅格图层的对比度。

raster-resampling

绘制属性。可选枚举值。可能的值: linear, nearest。默认为 "linear"。

栅格重采样模式。

• linear: (线性) 创建平滑外观的图像。
• nearest: (最近邻) 创建像素化外观的图像。

raster-fade-duration

绘制属性。可选数值，单位为毫秒，默认为 300。

淡入新加载栅格瓦片的持续时间。

山体阴影图层

visibility

布局属性。可选枚举值。可能的值: visible, none。默认为 "visible"。

该图层是否显示。

• visible: 图层可见。
• none: 图层不可见。

hillshade-illumination-direction

绘制属性。可选数值，范围[0, 359]，默认为 335。支持插值表达式。可过渡。

光源的方向，以从北方顺时针的角度表示。

hillshade-illumination-altitude

绘制属性。可选数值，范围[0, 90]，默认为 35。支持插值表达式。可过渡。

光源的高度，以从地平线上方的度数表示。

hillshade-illumination-anchor

绘制属性。可选枚举值。可能的值: map, viewport。默认为 "viewport"。

地图旋转时光源的方向。

• map: 山体阴影照明相对于北方方向。
• viewport: 山体阴影照明相对于视口顶部。

hillshade-exaggeration

绘制属性。可选数值，范围[0, 1]。默认为 0.5。支持插值表达式。可过渡。

山体阴影的强度。

hillshade-shadow-color

绘制属性。可选颜色数组。默认为 "#000000"。支持插值表达式。可过渡。

背向光源的区域的阴影颜色。只有当hillshade-method设置为multidirectional时，才能指定多个光源。

hillshade-highlight-color

绘制属性。可选颜色数组。默认为 "#FFFFFF"。支持插值表达式。可过渡。

朝向光源的区域的高亮颜色。只有当hillshade-method设置为multidirectional时，才能指定多个光源。

hillshade-accent-color

绘制属性。可选颜色。默认为 "#000000"。支持插值表达式。可过渡。

用于强调崎岖地形（如陡峭悬崖和峡谷）的阴影颜色。

hillshade-method

绘制属性。可选枚举值。可能的值: standard, basic, combined, igor, multidirectional。默认为 "standard"。

要使用的山体阴影算法，可以是standard、basic、combined、igor或multidirectional之一。

• standard: 传统的山体阴影方法。
• basic: 基本山体阴影。使用简单的物理模型，其中反射光强度与入射光与表面法线之间角度的余弦成正比。类似于GDAL的gdaldem默认算法。
• combined: 强度随斜度变化的山体阴影算法。类似于GDAL的带-combined选项的gdaldem。
• igor: 尝试最小化对下方其他地图要素影响的山体阴影算法。类似于GDAL的带-igor选项的gdaldem。
• multidirectional: 具有多个照明方向的山体阴影。使用具有多个独立光源的基本山体阴影模型。

色彩浮雕图层

visibility

布局属性。可选枚举值。可能的值: visible, none。默认为 "visible"。

该图层是否显示。

• visible: 图层可见。
• none: 图层不可见。

color-relief-opacity

绘制属性。可选数值，范围[0, 1]。默认为 1。支持插值表达式。可过渡。

色彩浮雕将被绘制的不透明度。

color-relief-color

绘制属性。可选颜色。支持插值表达式。

根据像素的海拔高度定义每个像素的颜色。应该是一个使用["elevation"]作为输入的表达式。

color-relief-color: [
    "interpolate",
    ["linear"],
    ["elevation"],
    0,
    "black",
    8849,
    "white"
]