跳到主要内容
版本：9.3.0

图层（layers）

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

除了background类型的图层外，每一层都必须引用一个源。 图层从数据源中获取数据，过滤特征可选，然后定义这些特征的样式。

下面在样式文件中layers的例子: 

"layers": [
  {
    "id": "water",
    "source": "mapmost-dark",
    "source-layer": "water",
    "type": "fill",
    "paint": {
      "fill-color": "#00ffff"
    }
  }
]

图层属性​

filter​

可选属性。expression

指定源特性条件的表达式。 只显示符合过滤条件的要素。 filter中的层级表达式仅在整数层级上计算。filter表达式不支持["feature-state",…]。符号层的filter表达式只支持["pitch"]和["distance-from-center"]表达式。

id​

必填属性。string

图层唯一名称。

layout​

可选属性。layout

图层的布局属性。

maxzoom​

可选属性。number。取值范围：0~24。

图层的最大层级。 在地图层级等于或大于maxzoom时，图层将被隐藏。

minzoom​

可选属性。number。取值范围：0~24。

该层的最小层级。 在地图层级小于minzoom时，图层将被隐藏。

paint​

可选属性。Paint

此层的默认绘制属性。

source​

可选属性。string

要用于此层的数据源的ID。 除了background类型外，其余图层都需要此属性。

source-layer​

可选属性。string

仅当数据源为矢量瓦片地图时，需要定义为图层名称。

type​

必填属性。enum。"background"、"circle"、"line"、"fill"、"symbol"、 "raster"、 "fill-extrusion"、 "heatmap"、 "hillshade"中的一种。

"background": 地图背景图层

"circle"：点图层

"line"： 线图层

"fill"： 面图层

"symbol"： 符号图层

"raster"： 栅格图层

"fill-extrusion"： 三维拉伸图层

"heatmap"： 热力图图层

"hillshade"： 山体阴影图层

图层子属性​

图层有两个子属性：布局和绘制属性。

  • Layout properties 图层的layout属性。 它们在渲染过程的早期应用，并定义该层的数据如何传递给GPU。 对布局属性的更改需要一个异步“布局”步骤。
  • Paint properties 图层的paint属性。在稍后的渲染过程中应用，绘制属性的更改很简单且同步进行。

背景图层（background）​

background样式图层覆盖整个地图。使用背景样式图层配置颜色或图案以显示在所有其他地图内容下方。如果背景图层是透明的或从样式中省略，则地图视图中未显示其他样式图层的任何部分都是透明的。

background-color​

Paint属性。可选属性，color类型，默认值"#000000"，与background-pattern属性冲突。支持interpolate表达式。表示绘制背景的颜色。Transitionable。

background-opacity​

Paint属性。可选属性，number类型，取值范围：0~1，默认值1。支持interpolate表达式，表示绘制背景的不透明度。Transitionable。

background-pattern​

Paint属性。可选属性，resolvedImage类型。 表示用于绘制图像背景的sprite 中图像的名称。对于无缝图案，图像宽度和高度必须是2的指数倍(2,4,8，… , 512)。请注意，与缩放相关的表达式将只在整数缩放级别上计算。

visibility​

Layout属性。可选属性，enum类型，"visible", "none"中的一种，默认值"visible"。表示是否显示该图层，"visible": 图层显示，"none": 图层隐藏。

点图层（circle）​

圆形样式层在地图上呈现一个或多个填充的圆形。 您可以使用圆形层来配置矢量瓦片中点或点集合特征的视觉外观。 圆层渲染的圆的半径是用屏幕单位测量的。

circle-blur​

Paint属性。可选属性，number。默认值：0。支持feature-state和interpolate表达式。Transitionable。

使圆变得模糊。 取值为1时模糊圆，只有中心点是完全不透明的。

circle-color​

Paint属性。可选属性，color。默认值："#000000"。支持feature-state和interpolate表达式。Transitionable。

设置圆的填充颜色。

circle-opacity​

Paint属性。可选属性，number。取值范围：0~1，默认值：1。支持feature-state和interpolate表达式。Transitionable。

设置圆绘制时的不透明度。

circle-pitch-alignment​

Paint属性。可选属性，enum。"map", "viewport"中的一种。默认值："viewport"。

用于设置地图倾斜时圆的方向。

"map": 圆与地图的平面对齐。

"viewport": 圆与视图的平面对齐。

circle-pitch-scale​

Paint属性。可选属性，enum。"map", "viewport"中的一种。默认值："map"。

控制地图倾斜时圆的缩放方式。

"map": 圆是根据它们到相机的视距离来缩放的。

"viewport": 圆是没有缩放的。

circle-radius​

Paint属性。可选属性，number。取值范围：≥0，单位为像素。默认值：5。支持feature-state和interpolate表达式。Transitionable。

设置圆半径。

circle-sort-key​

Layout属性。可选属性，number

根据此值按升序对特性进行排序。 具有较高排序键的特性将出现在具有较低排序键的特性的上面。

circle-stroke-color​

Paint属性。可选属性，color。默认值"#000000"。支持feature-state和interpolate表达式。Transitionable。

设置圆的描边颜色。

circle-stroke-opacity​

Paint属性。可选属性，number。取值范围：0~1，默认值：1。支持feature-state和interpolate表达式。 Transitionable。

设置圆描边的不透明度。

circle-stroke-width​

Paint属性。可选属性，number。取值范围：≥0，单位为像素。默认值：0。支持feature-state和interpolate表达式。Transitionable。

设置圆描边的宽度。 描边放置在circle-radius之外。

circle-translate​

Paint属性。可选属性，array。单位为像素。默认值：[0,0]。支持interpolate表达式。Transitionable.

设置几何偏移量。 值为[x, y]，其中负数分别表示左和上。

circle-translate-anchor​

Paint属性。可选属性，enum。"map", "viewport"中的一种。默认值："map"。需要启用circle-translate。

控制circle-translate的参考框架。

"map": 圆相对地图做了平移。

"viewport": 圆相对视图做了平移。

visibility​

Layout属性。可选属性，enum。"visible", "none"中的一种。默认值"visible"。

是否显示该层。

"visible": 图层显示。

"none": 图层隐藏。

线图层（line）​

线图层样式是在地图上呈现一条或多条折线，可以使用线图层来配置polyline或multipolyline 要素的视觉外观。

line-blur​

Paint属性。可选属性，number类型，取值范围：≥0，单位为像素，默认值0。支持feature-state和interpolate表达式。Transitionable。表示将模糊应用于线。

line-cap​

Layout属性。可选属性，enum类型。是"butt", "round", "square"中的一种，默认值"butt"。 "butt": 带有方形末端的帽子，该帽子被绘制到线条的确切端点。 "round": 圆角帽一种末端为圆形的帽，绘制于线的端点之外，半径为线宽的二分之一，并以线的端点为中心。 "square": 一种末端呈方形的帽，在线的端点之外以线宽度的一半的距离绘制。

line-color​

Paint属性。可选属性，color类型，默认值"#000000"，与line-pattern冲突。支持feature-state和interpolate表达式。Transitionable。表示将用来绘制线条的颜色。

line-dasharray​

Paint属性。可选属性，array类型，取值范围：≥0，单位为行宽，与line-pattern冲突。Transitionable。 指定形成虚线图案的交替虚线和间隙的长度。长度稍后按线宽缩放，若要将虚线长度转换为像素，请将其长度乘以当前行的宽度。注意，指定了lineMetrics: true的GeoJSON源不会按照预期的比例呈现虚线。 还请注意，与缩放相关的表达式将只在整数缩放级别上计算。

line-gap-width​

Paint属性。可选属性，number类型，取值范围：≥0，单位为像素，默认值0。支持feature-state和interpolate表达式。Transitionable。 表示在线的实际路径外绘制线框，Value表示内部间隙的宽度。

line-gradient​

Paint属性。可选属性，color类型，与line-pattern冲突。需求"geojson"格式的数据源，支持interpolate表达式。 定义用于给线条要素上色的渐变。只能用于启用"lineMetrics": true的GeoJSON源。

line-join​

Layout属性。可选属性，enum类型，是"bevel", "round", "miter"中的一种，默认值"miter"。表示连接时显示路段。 "bevel": 一种带有方形末端的连接，该连接线在距离线的一半宽度的距离处绘制到线的端点之外。 "round": 具有圆形末端的连接，它以直线宽度的二分之一半径绘制到直线端点之外，并以直线端点为中心。 "miter"": 有一个尖角的连接点，它与路径端点以外的外侧相交。

line-miter-limit​

Layout属性。可选属性，number类型，默认值2，要求line-join为"miter"。支持插入表达式，表示用于自动将斜接连接转换为斜角连接。

line-offset​

Paint属性。可选属性，number类型，单位为像素,默认值0。支持feature-state和interpolate表达式。Transitionable。 表示线的偏移量。对于线性要素，正值相对于线的方向向右偏移线，负值向左偏移。对于面要素，正值表示内凹，负值表示外凸。

line-opacity​

Paint属性。可选属性，number类型，取值范围：0~1，默认值1。支持feature-state和interpolate表达式。Transitionable。表示线条绘制时的不透明度。

line-pattern​

Paint属性。可选属性，resolvedImage类型。Transitionable。 表示用于绘制图像线的sprite中图像的名称。对于无缝图案，图像宽度必须是2的指数倍(2,4,8，… , 512)。 请注意，与缩放相关的表达式将只在整数缩放级别上计算。

line-round-limit​

Layout属性。可选属性，number类型，默认值1.05。需要line-join为"round"，支持interpolate表达式。表示用于将浅角度的圆形连接自动转换为斜接连接。

line-sort-key​

Layout属性。可选属性，number类型，根据此值按升序对要素进行排序。具有较高排序键的要素将出现在具有较低排序键的要素的上面。

line-translate​

Paint属性。可选属性，array类型，单位为像素，默认值[0,0]。支持interpolate表达式。Transitionable。 表示几何偏移量，值为[x, y]，其中负数分别表示左和上。

line-translate-anchor​

Paint属性。可选属性，enum类型，是"map", "viewport"中的一种，默认值"map"，需要启用line-translate。 "map": 线相对于地图平移，"viewport": 线相对于视图进行平移。

line-width​

Paint属性。可选属性，number类型，取值范围：≥0，单位为像素，默认值1。支持feature-state和interpolate表达式，Transitionable。表示线宽。

visibility​

Layout属性。可选属性，enum类型，是"visible", "none"中的一种，默认值"visible"。 表示是否显示该层，"visible": 图层显示，"none": 图层隐藏。

面图层（fill）​

填充样式层在地图上呈现一个或多个填充(可选描边)的面要素。您可以使用填充层来配置面或多面要素的视觉外观。

fill-antialias​

Paint属性。可选属性，boolean类型，默认值true。表示填充是否应该抗锯齿。

fill-color​

Paint属性。可选属性，color类型，默认值"#000000"。与fill-pattern和fill-waterflow-normal冲突，支持feature-state和interpolate表达式。Transitionable。 表示图层填充部分的颜色，这个颜色可以用alpha组件指定为rgba，如果被启用，颜色的不透明度并不会影响1px描边的不透明度。

fill-opacity​

Paint属性。可选属性，包含在0~1的number。支持feature-state和interpolate表达式。Transitionable。 表示整个填充层的不透明度，与填充颜色相反，如果描边被使用，这个值将影响填充周围1px的描边。

fill-outline-color​

Paint属性。可选属性，color类型，与fill-pattern冲突，需要fill-antialias为true。支持feature-state和interpolate表达式。Transitionable。 表示填充的轮廓色，如果未指定，则匹配填充颜色的值。

fill-pattern​

Paint属性。可选属性，resolvedImage类型。Transitionable。 表示在精灵图中用于绘制图像背景的图像名称。对于无缝图案，图像宽度和高度必须是2的指数倍(2,4,8，… , 512)。请注意，与缩放相关的表达式将只在整数缩放级别上计算。

fill-pattern-density​

Paint属性。可选属性，number类型。默认值1。支持stops表达式。

贴图重复次数。重复次数n表示按照1/n的尺寸对贴图进行渲染。值越大，贴图渲染越密集。建议数值为2的幂次方。

fill-sort-key​

Layout属性。可选属性，number类型，根据此值按升序对要素进行排序，具有较高排序键的要素将出现在具有较低排序键的要素的上面。

fill-translate​

Paint属性。可选属性，array类型，单位为像素。默认值[0,0]，支持interpolate表达式。Transitionable。 表示几何偏移量，值为[x, y]，其中负数分别表示左和上。

fill-translate-anchor​

Paint属性。可选属性，enum类型，是"map", "viewport"中的一种，默认值"map"。需要启用fill-translate。 "map": 填充是相对于地图进行转换的，"viewport": 填充相对于视图进行了转换。

fill-waterflow-normal​

Paint属性。可选属性，string类型。与fill-water-noise结合使用，开启动态水面效果。

动态水面法线贴图。可以是sprite中存在的图像资源名称，或通过addImages添加的图像资源名称。

fill-waterflow-noise​

Paint属性。可选属性，string类型。与fill-waterflow-normal结合使用，开启动态水面效果。

动态水面噪声贴图。可以是sprite中存在的图像资源名称，或通过addImages添加的图像资源名称。

fill-waterflow-speed​

Paint属性。可选属性，number类型。默认值1。

动态水面水流速度。值越大速度越快，可以为负值。

fill-waterflow-time​

Paint属性。可选属性，string类型。默认值为系统当前北京时间。格式为：“yyyy-mm-dd hh-mm-ss”，示例：“2023-08-01 12:00:00”。

动态水面时间。用于计算太阳光线角度。

fill-waterflow-reflect-sun​

Paint属性。可选属性，boolean类型。默认值true。

是否反射太阳光。

fill-waterflow-color​

Paint属性。可选属性，color类型。

动态水面颜色。缺省时水面颜色为内置颜色，即从fill-waterflow-noise这张贴图中提取的颜色。

fill-waterflow-reflect-color​

Paint属性。可选属性，color类型。默认值"#ffffff"，只有设置了fill-waterflow-color属性才生效。

动态水面反射颜色。

fill-waterflow-reflect​

Paint属性。可选属性，boolean类型。默认值true。

是否开启水面倒影。

fill-waterflow-reflect-wave-u​

Paint属性。可选属性，number类型。默认值0.1。

反射边缘模糊系数-水平方向。数值越大倒影越模糊。

fill-waterflow-reflect-wave-v​

Paint属性。可选属性，number类型。默认值0.1。

反射边缘模糊系数-竖直方向。数值越大倒影越模糊。

visibility​

Layout属性。可选属性，enum类型。是"visible", "none"中的一种，默认值"visible"。表示是否显示该图层，"visible": 图层显示，"none": 图层隐藏。

符号图层（symbol）​

符号图层用于在地图上的点或线上呈现图标和文本标签。 你可以使用符号图册层来配置矢量瓦片中特征标签的视觉外观。

icon-allow-overlap​

Layout属性。可选属性，boolean。默认值false。 需要启用icon-image。

如果为true，即使它与其他先前绘制的符号碰撞，该图标也会可见。

icon-anchor​

Layout属性。可选属性，enum。"center", "left", "right", "top", "bottom", "top-left", "top-right", "bottom-left", "bottom-right"中的一种。默认值"center"。 需要启用icon-image。

靠近锚点的部分图标。

"center": 图标的中心位置离锚点最近。

"left": 图标的左边最靠近锚点。

"right": 图标的右边最靠近锚点。

"top": 图标的顶端最靠近锚点。

"bottom": 图标的底部最靠近锚点。

"top-left": 图标的左上角离锚点最近。

"top-right": 图标的右上角离锚点最近。

"bottom-left": 图标的左下角离锚点最近。

"bottom-right": 图标的右下角离锚点最近。

icon-color​

Paint 属性。可选属性，color。默认值："#000000"。需要启用 icon-image。支持 feature-state 和 interpolate 表达式。Transitionable.

图标的颜色。 只能与SDF icons一起使用。

icon-halo-blur​

Paint属性。可选属性，number。取值范围：≥ 0，单位为像素。默认值：0。需要启用 icon-image。支持 feature-state 和 interpolate 表达式。Transitionable。

向外逐渐淡出光环。

icon-halo-color​

Paint属性。可选属性，color。默认值："rgba(0, 0, 0, 0)"。需要启用icon-image。支持feature-state和interpolate表达式。Transitionable。

图标光环的颜色。 图标光晕只能与SDF icons一起使用。

icon-halo-width​

Paint属性。可选属性，number。取值范围：≥0，单位为像素。默认值 0。需要启用icon-image。支持feature-state和interpolate表达式。Transitionable。

光晕到图标轮廓的距离。

icon-ignore-placement​

Layout属性。可选属性，boolean。默认值 false。 需要启用 icon-image。

如果为true，其他符号即使与图标发生碰撞也可以可见。

icon-image​

Layout属性。可选属性，resolvedImage

在精灵图中用于绘制图像背景的图像名称。

icon-keep-upright​

Layout 属性。可选属性，boolean。默认值 false。需要启用 icon-image、icon-rotation-alignment为"map"、symbol-placement为"line"或"line-center"。

如果为true，图标可能会翻转，以防止其呈现颠倒。

icon-offset​

Layout 属性。可选属性，array。默认值：[0,0]。需要启用 icon-image。 支持 interpolate 表达式。

图标与其锚点的偏移距离。 正值表示右和下，负值表示左和上。 将每个组件乘以icon-size的值，以获得以像素为单位的最终偏移量。 当与icon-rotatez相结合时，偏移量将如同旋转方向为上。

icon-opacity​

Paint属性。可选属性，number。取值范围：0~1，默认值1。需要启用icon-image。支持feature-state和interpolate表达式。Transitionable.

用于设置图标绘制时的不透明度。

icon-optional​

Layout 属性。可选属性，boolean。默认值：false。 需要启用 icon-image 、text-field。

如果为true，当图标与其他符号碰撞而文本不碰撞时，文本将不显示相应的图标。

icon-padding​

Layout 属性。可选属性，number。取值范围：≥0，单位为像素。默认值：2。需要启用icon-image。支持 interpolate 表达式。

用于检测符号碰撞的图标包围框周围的附加区域的大小。

icon-pitch-alignment​

Layout属性。可选属性，enum。"map", "viewport", "auto"中的一种。默认值："auto"。需要启用 icon-image。

用于设置地图倾斜时图标的方向。

"map": 图标与地图的平面对齐。

"viewport": 图标与视图的平面对齐。

"auto": 自动匹配 icon-rotation-alignment 的值。

icon-rotate​

Layout 属性。可选属性，number。单位为度。默认值：0。需要启用 icon-image。支持interpolate 表达式。

用于设置图标顺时针旋转的角度。

icon-rotation-alignment​

Layout属性。可选属性，enum。"map", "viewport", "auto"中的一种。默认值："auto"。需要启用 icon-image。

结合 symbol-placement ，决定了图标的旋转方式。

"map"：当 symbol-placement 设置为 point 时，将图标东西向对齐。 当 symbol-placement 设置为 line 或 line-center 时，将图标的 x 轴与直线对齐。

"viewport": 生成其 x 轴与视图 x 轴对齐的图标，而不考虑 symbol-placement 的值。

"auto": 当symbol-placement设置为point时，这相当于viewport。 当symbol-placement设置为 line 或 line-center 时，这相当于 "map"。

icon-size​

Layout 属性。可选属性，number。取值范围：≥0，单位为要素的原始图标大小。默认值：1。需要启用 icon-image 。支持 interpolate 表达式。

根据所提供的因子缩放图标的原始大小。 图像的新像素大小将是原始像素大小乘以图标大小。 1为原尺寸; 3是图像大小的三倍。

icon-text-fit​

Layout属性。可选属性，enum。"none", "width", "height", "both"中的一种。默认值"none"。需要启用icon-image、text-field。

用于缩放图标以适应相关文本。

"none": 图标以其固有的宽高比显示。

"width": 图标在x轴上缩放以适应文本的宽度。

"height": 图标在y轴上缩放以适应文本的高度。

"both": 图标在x和y轴上缩放。

icon-text-fit-padding​

Layout属性。可选属性，array。单位为像素。默认值：[0,0,0,0]。 需要启用icon-image、text-field、icon-text-fit为"both"或"width"或"height"。支持interpolate表达式。

添加到尺寸上的附加区域的大小由图标文本大小决定，按顺时针顺序:上、右、下、左。

icon-translate​

Paint属性。可选属性，array。默认值像素。默认值：[0,0]。需要启用icon-image。支持interpolate表达式。Transitionable.

用于设置图标的锚点从其原来位置移动的距离。 正值表示右和下，负值表示左和上。

icon-translate-anchor​

Paint属性。可选属性，enum。"map", "viewport"中的一种。默认值："map"。需要启用icon-image、icon-translate。

控制icon-translate的参考框架。

"map": 图标是相对于地图平移的。

"viewport": 图标相对于视图进行平移。

symbol-avoid-edges​

Layout属性。可选属性，boolean。默认值：false。

如果为true，符号将不会交叉瓦片边缘，以避免相互碰撞。 推荐在没有足够填充矢量瓦片以防止碰撞的图层中使用，或者是将它放置在线符号层之后的点符号层。 当使用支持全局冲突检测的客户端，如Mapmost SDK for WebGL版本0.42.0或更高版本时，不需要启用此属性，以防止在tile边界剪切标签。

symbol-placement​

Layout属性。可选属性，enum。"point", "line", "line-center"中的一种。默认值："point"。

标签相对于它的几何形状进行放置。

"point": 标签放置在几何图形所在的位置。

"line": 标签沿着几何图形的直线放置。 只能用于LineString和Polygon几何图形。

"line-center": 标签放置在几何图形的直线中心。 只能用于LineString和Polygon几何图形。 请注意，矢量瓦片中的单个特征可能包含多个直线几何图形。

symbol-sort-key​

Layout属性。可选属性，number

根据此值按升序对特性进行排序。 具有较低排序键的特征被绘制并放在首位。 当icon-allow-overlap或text-allow-overlap为false时，具有较低排序键的特性在放置时将具有优先级。 当icon-allow-overlap或text-allow-overlap设置为true时，排序键高的特性会重叠排序键低的特性。

symbol-spacing​

Layout属性。可选属性，number。取值范围：≥1，单位为像素。默认值：250。 需要启用symbol-placement为"line"。支持interpolate表达式。

用于设置两个符号锚之间的距离。

symbol-z-order​

Layout属性。可选属性，enum。"auto", "viewport-y", "source"中的一种。默认值"auto"。

确定同一层中的重叠符号是按它们在数据源中出现的顺序呈现，还是按它们相对于视图的y轴位置呈现。 为了控制符号的顺序和优先级，可以使用symbol-sort-key。

"auto": 如果设置了，则按symbol-sort-key对符号进行排序。 否则，如果icon-allow-overlap或text-allow-overlap设置为true或icon-ignore-placement或text-ignore-placement设置为false，则根据符号相对于视图的y位置对其进行排序。

"viewport-y": 如果icon-allow-overlap或text-allow-overlap设置为true或icon-ignore-placement或text-ignore-placement设置为false，则根据符号相对于视图的y位置对其进行排序。

"source": 如果设置了，则按symbol-sort-key对符号进行排序。 否则，不应用排序; 符号按照与源数据相同的顺序呈现。

text-allow-overlap​

Layout属性。可选属性，boolean。默认值：false。需要启用text-field。

如果为true，即使文本与其他先前绘制的符号发生冲突，文本也将可见。

text-anchor​

Layout属性。可选属性，enum。"center", "left", "right", "top", "bottom", "top-left", "top-right", "bottom-left", "bottom-right"中的一种。默认值"center"。需要启用text-field。禁用text-variable-anchor。

放置在最靠近锚点的部分文本。

"center": 文本的中心位置最靠近锚点。

"left": 文本的左侧最靠近锚点。

"right": 文本的右侧最靠近锚点。

"top": 文本的顶部离锚点最近。

"bottom": 文本的底部最靠近锚点。

"top-left": 文本的左上角离锚点最近。

"top-right": 文本的右上角离锚点最近。

"bottom-left": 文本的左下角离锚点最近。

"bottom-right": 文本的右上下角离锚点最近。

text-color​

Paint属性。可选属性，color。默认值："#000000"。需要启用text-field。支持feature-state和interpolate表达式。Transitionable.

用来绘制文本的颜色。

text-field​

Layout属性。可选属性，formatted。默认值：""。

值要用于文本标签。 如果提供了一个普通字符串，它将被视为一个带有默认/继承格式选项的格式化字符串。 格式化文本不支持SDF图像。

text-font​

Layout属性。可选属性，array。默认值：["Open Sans Regular","Arial Unicode MS Regular"]。需要启用text-field。

用于显示文本的字体类型。

text-halo-blur​

Paint属性。可选属性，number。取值范围：≥0，单位为像素。默认值：0。需要启用text-field。支持feature-state和interpolate表达式。Transitionable。

用于设置光晕向外逐渐消失的距离。

text-halo-color​

Paint属性。可选属性，color。默认值："rgba(0, 0, 0, 0)"。需要启用text-field。支持feature-state和interpolate表达式。Transitionable。

用于设置文字晕轮的颜色，以便于与背景有所区别。

text-halo-width​

Paint属性。可选属性，number。取值范围：≥0，单位为像素。默认值：0。需要启用text-field。支持feature-state和interpolate表达式。Transitionable。

用于设置光晕到字体轮廓的距离。 最大文本晕轮宽度是字体大小的1/4。

text-ignore-placement​

Layout属性。可选属性，boolean。默认值false。需要启用text-field。

如果为true，其他符号即使与文本发生碰撞也可以可见。

text-justify​

Layout属性。可选属性，enum。"auto", "left", "center", "right"中的一种。默认值："center"。需要启用text-field。

用于设置文本对齐选项。

"auto": 文本对齐到锚定位置。

"left": 文本向左对齐。

"center": 文本居中。

"right": 文本向右对齐。

text-keep-upright​

Layout属性。可选属性，boolean。默认值：true。需要启用text-field、text-rotation-alignment为"map"、symbol-placement为"line"或"line-center"。

如果为true，则文本可以垂直翻转，以防止呈现颠倒。

text-letter-spacing​

Layout属性。可选属性，number。单位为ems。默认值：0。需要启用text-field。支持interpolate表达式。

设置文本中字母之间的间距。

text-line-height​

Layout属性。可选属性，number。单位为ems。默认值：1.2。需要启用text-field。支持interpolate表达式。

用于设置多行文本之间的行高。

text-max-angle​

Layout属性。可选属性，number。单位为度。默认值：45。需要启用text-field、symbol-placement为"line"或"line-center"。支持interpolate表达式。

用于设置相邻字符之间的最大角度变化。

text-max-width​

Layout属性。可选属性，number。取值范围：≥0，单位为ems。默认值：10。需要启用text-field、symbol-placement为"point"。支持interpolate表达式。

用于设置文本换行时的最大行宽。

text-offset​

Layout属性。可选属性，array。单位为ems。默认值：[0,0]。需要启用text-field。禁用text-radial-offset。支持interpolate表达式。

用于设置文本与其锚的偏移距离。 正值表示右和下，负值表示左和上。 如果与文本变量锚一起使用，输入值将被视为绝对值。 沿着x轴和y轴的偏移量将根据锚定位置自动应用。

text-opacity​

Paint属性。可选属性，number。取值范围：0~1，默认值1。需要启用text-field。支持feature-state和interpolate表达式。Transitionable。

用于设置文本绘制时的不透明度。

text-optional​

Layout属性。可选属性，boolean。默认值false。需要启用text-field、icon-image。

如果为true，当文本与其他符号碰撞而图标不碰撞时，图标将不显示相应的文本。

text-padding​

Layout属性。可选属性，number。取值范围：≥0，单位为像素。默认值：2。需要启用text-field。支持interpolate表达式。

用于检测符号碰撞的文本包围框周围的附加区域的大小。

text-pitch-alignment​

Layout属性。可选属性，enum。"map", "viewport", "auto"中的一种。默认值："auto"。需要启用text-field。

用于设置地图倾斜时文本的方向。

"map": 文本与地图的平面对齐。

"viewport": 文本与视图的平面对齐。

"auto": 自动匹配text-rotation-alignment的值。

text-radial-offset​

Layout属性。可选属性，number。单位为ems。默认值：0。需要启用text-field。支持interpolate表达式。

用于设置文本在符号锚点方向上的径向偏移量。 与text-variable-anchor组合使用很有用，如果存在，默认使用二维文本偏移。

text-rotate​

Layout属性。可选属性，number。单位为度。默认值：0。需要启用text-field。支持interpolate表达式。

用于设置文本顺时针旋转的角度。

text-rotation-alignment​

Layout属性。可选属性，enum。"map", "viewport", "auto"中的一种。默认值： "auto"。需要启用text-field。

结合symbol-placement，决定了构成文本的单个符号的旋转方式。

"map": 当symbol-placement设置为point时，将文本东西对齐。 当symbol-placement设置为line或line-center时，将文本的x轴与行对齐。

"viewport": 生成其x轴与视图x轴对齐的符号，而不管symbol-placement的值如何。

"auto": 当symbol-placement设置为point时，这相当于viewport。 当symbol-placement设置为line或line-center时，这相当于map。

text-size​

Layout属性。可选属性，number。取值范围：≥0，单位为像素。默认值：16。需要启用text-field。支持interpolate表达式。

用于设置字体大小。

text-transform​

Layout属性。可选属性，enum。"none", "uppercase", "lowercase"中的一种。默认值："none"。需要启用text-field。

指定如何将文本大写，类似于CSS text-transform属性。

"none": 文本无改动。

"uppercase": 强制所有字母以大写显示。

"lowercase": 强制所有字母以小写显示。

text-translate​

Paint属性。可选属性，array。单位为像素。默认值[0,0]。需要启用text-field。支持interpolate表达式。Transitionable.

文本锚点从其初始位置移动的距离。 正值表示右和下，负值表示左和上。

text-translate-anchor​

Paint属性。可选属性，enum。"map", "viewport"中的一种。默认值"map"。需要启用text-field、text-translate。

控制text-translate的参考框架。

"map": 文本是根据地图平移的。

"viewport"： 文本相对于视图进行平移。

text-variable-anchor​

Layout属性。可选属性，array。"center", "left", "right", "top", "bottom", "top-left", "top-right", "bottom-left", "bottom-right"中的一种。需要启用text-field、text-translate为"point"。

为了增加在地图上放置高优先级标签的机会，你可以提供一个文本锚位置数组:呈现器将尝试在每个位置放置标签，在移动到下一个标签之前，按顺序。 使用text-justify: auto根据锚点位置选择对齐方式。 若要应用偏移量，请使用text-radial-offset或二维text-offset。

"center": 文本的中心位置最靠近锚点。

"left": 文本的左侧最靠近锚点。

"right": 文本的右侧最靠近锚点。

"top": 文本的顶端最靠近锚点。

"bottom": 文本的底部最靠近锚点。

"top-left": 文本的左上角离锚点最近。

"top-right": 文本的右上角离锚点最近。

"bottom-left": 文本的左下角离锚点最近。

"bottom-right": 文本的右下角离锚点最近。

text-writing-mode​

Layout属性。可选属性，array。"horizontal", "vertical"中的一种。需要启用text-field。

属性允许控制符号的方向。 请注意，属性值起到了提示的作用，因此，如果一个符号的语言不支持所提供的方向，那么它将按照其自然方向进行布局。 例如:英文点符号将水平呈现，即使数组值包含单个'vertical'枚举值。 对于采用点布局的符号，数组中元素的顺序定义了定向变量的布局优先顺序。 对于带有行布局的符号，默认的文本书写模式是['horizontal', 'vertical']或['vertical', 'horizontal']，顺序不影响布局。

"horizontal": 如果文本的语言支持水平书写模式，符号就会水平排列。

"vertical": 如果文本语言支持垂直书写模式，那么符号就会垂直排列。

visibility​

Layout属性。可选属性，enum。"visible", "none"中的一种。默认值"visible"。

是否显示该层。

"visible": 图层显示。

"none": 图层隐藏。

栅格图层（raster）​

栅格样式层在地图上渲染栅格瓦片。 您可以使用栅格图层来配置栅格瓦片的颜色参数。

raster-brightness-max​

Paint属性。可选属性，number。取值范围：0~1，默认值：1。支持interpolate表达式。Transitionable。

增加或减少图像的亮度。 该值为最大亮度。

raster-brightness-min​

Paint属性。可选属性，number。取值范围：0~1，默认值：0。支持interpolate表达式。Transitionable。

增加或减少图像的亮度。 该值为最小亮度。

raster-contrast​

Paint属性。可选属性，number。取值范围：-1~1，默认值：0。支持interpolate表达式。Transitionable。

增加或减少图像的对比度。

raster-fade-duration​

Paint属性。可选属性，number。取值范围：≥0，单位为毫秒。默认值：300。支持interpolate表达式。

当一个新的瓦片被加载时，淡出持续时间。

raster-hue-rotate​

Paint属性。可选属性，number。单位为度。默认值：0。支持interpolate表达式。Transitionable。

围绕色轮旋转色调。

raster-opacity​

Paint属性。可选属性，number。取值范围：0~1，默认值：1。支持interpolate表达式。Transitionable。

图像绘制时的不透明度。

raster-resampling​

Paint属性。可选属性，enum。"linear", "nearest"中的一种。默认值："linear"。

重采样/插值方法用于超尺度处理，也称为纹理放大滤波器。

"linear": (Bi)线性滤波使用四个最接近的原始源像素的加权平均插值像素值，在过度缩放时创建一个平滑但模糊的外观。

"nearest": 最近邻过滤使用最接近的原始源像素插值像素值，在过度缩放时创建一个尖锐但像素化的外观。

raster-saturation​

Paint属性。可选属性，number。取值范围：-1~1，默认值：0。支持interpolate表达式。Transitionable。

增加或减少图像的饱和度。

visibility​

Layout属性。可选属性，enum。"visible", "none"中的一种。默认值："visible"。

是否显示该层。

"visible": 图层显示。

"none": 图层隐藏。

三维拉伸图层（fill-extrusion）​

fill-extrusion用来在地图上渲染一个或多个填充(支持描边)挤压(3D)多边形。 您可以使用此图层来配置polygon或multipolygon的外观。

fill-extrusion-base​

Paint属性。可选，格式为number。取值范围：≥0，单位为米。默认值0。需要启用fill-extrusion-height。支持feature-state和interpolate表达式。

图层基底的高度值。 必须小于或等于fill-extrusion-height。

fill-extrusion-color​

Paint属性。可选，格式为color。默认值"#000000"。若启用fill-extrusion-pattern或fill-extrusion-color-side，该属性无效。支持feature-state和interpolate表达式。

拉伸多边形基底的颜色。 拉伸的表面将根据这种颜色和光源设置进行不同的阴影处理。 如果这个颜色被指定为带有alpha形式的rgba, alpha值将被忽略; 使用fill-extrusion-opacity设置图层透明度。

fill-extrusion-color-side​

Paint属性。可选，格式为color。必须为interpolate表达式。 示例：

"paint": {
        "fill-extrusion-color-side":[
                "interpolate",
                ["linear"],
                ["fill-extrusion-progress"],
                0, "rgba(76, 153, 221, 0.0)",
                1, "rgba(76, 153, 221, 1.0)",
        ]
}

拉伸体侧边颜色。 表达式输入值表示距离拉伸体底面的高度比值，范围为0-1，输出为颜色值。

fill-extrusion-color-top​

Paint属性。可选，格式为color。默认与拉伸体侧面颜色一致，即为fill-extrusion-color值或fill-extrusion-color-side最后一个颜色值。支持interpolate表达式。

拉伸体顶面颜色。

fill-extrusion-height​

Paint属性。可选，格式为number。取值范围：≥0，单位为米。默认值0。支持feature-state和interpolate表达式。

拉伸此图层的高度。

fill-extrusion-opacity​

Paint属性。可选，格式为number。取值范围：0~1，默认值1。支持interpolate表达式。

整个拉伸层的透明度。 该特性表现在整个图层上，而不是图层各个feature上，并且不支持数据驱动样式

fill-extrusion-pattern​

Paint属性。可选，格式为resolvedImage。若启用fill-extrusion-pattern-side或fill-extrusion-pattern-top，该属性无效。

在精灵图中用于在拉伸图层上绘制图像的图像名称。 对于无缝图案，图像宽度和高度必须是2的指数(2,4,8，… , 512)。 请注意，与缩放相关的表达式将只在整数缩放级别上计算。

fill-extrusion-pattern-density​

Paint属性。可选，格式为number。默认值为1。支持stops表达式。

贴图重复次数。重复次数n表示按照1/n的尺寸对贴图进行渲染。值越大，贴图渲染越密集。建议数值为2的幂次方。

fill-extrusion-pattern-side​

Paint属性。可选，格式为resolvedImage。与fill-extrusion-pattern-top同时设置才生效。

拉伸体侧面贴图。可以是sprite中存在的图像资源名称，或通过addImages添加的图像资源名称。

fill-extrusion-pattern-top​

Paint属性。可选，格式为resolvedImage。与fill-extrusion-pattern-side同时设置才生效。

拉伸体顶面贴图。可以是sprite中存在的图像资源名称，或通过addImages添加的图像资源名称。

fill-extrusion-pattern-side-spread-h​

Paint属性。可选，格式为boolean。默认值true。

拉伸体侧面贴图水平方向是否拉伸。为true时侧面贴图在水平方向拉伸至边缘，铺满平面，为false时按贴图实际尺寸在水平方向平铺。

fill-extrusion-pattern-side-spread-v​

Paint属性。可选，格式为boolean。默认值true。

拉伸体侧面贴图垂直方向是否拉伸。为true时侧面贴图在垂直方向拉伸至边缘，铺满平面，为false时按贴图实际尺寸在垂直方向平铺。

fill-extrusion-translate​

Paint属性。可选，格式为array。单位为像素。默认值[0,0]。支持interpolate表达式。

图层的几何偏移量。 其值为[x, y]，其中负数表示左和上(在平面上)。

fill-extrusion-translate-anchor​

Paint属性。可选，格式为枚举类型。是"map", "viewport"中的一种。默认值"map"。需要启用fill-extrusion-translate。

fill-extrusion-translate属性的参考锚点。

"map": 拉伸图层相对于地图平移。

"viewport": 拉伸图层相对于视图平移。

fill-extrusion-vertical-gradient​

Paint属性。可选，格式为boolean。默认值true。

是否对拉伸图层的两侧施加垂直梯度。 如果是true，两边的阴影会稍微深一些。

visibility​

Layout属性。可选，格式为枚举类型。是enum。"visible", "none"中的一种。默认值"visible"。

是否显示该层。

"visible": 图层显示。

"none": 图层隐藏。

热力图图层（heatmap）​

一个热力图样式层渲染一系列颜色来表示一个区域内点的密度。

heatmap-color​

Paint属性。可选，格式是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"]。支持interpolate表达式。

根据热力图中每个像素的密度值定义其颜色。 应使用["heatmap-density"]的表达式作为输入。

heatmap-intensity​

Paint属性。可选，格式是number。取值范围：≥0，默认值1。支持interpolate表达式。

类似于heatmap-weight，但控制全局热力图的强度。 主要用于根据缩放级别调整热力图。

heatmap-opacity​

Paint属性。可选，格式是number。取值范围：0~1，默认值1。支持interpolate表达式。

绘制热力图层时的全局透明度。

heatmap-radius​

Paint属性。可选，格式是number。取值范围：≥1，单位为像素。默认值30。支持feature-state和interpolate表达式。

以像素为单位的热力图点的影响半径。 增加这个值会使热力图更平滑，但不那么细节。 在热力图层上的queryRenderedFeatures将返回这个半径范围内的点。

heatmap-weight​

Paint属性。可选，格式是number。取值范围：≥0，默认值1。支持feature-state和interpolate表达式。

一种衡量单个点对热力图贡献度的指标。 10相当于在同一个位置上有10个权重为1的点。 与聚合结合使用时尤其有用。

visibility​

Layout属性。可选，格式是枚举。是enum。"visible", "none"中的一种。默认值"visible"。

是否显示该层。

"visible": 图层显示。

"none": 图层隐藏。

山体阴影图层（hillshade）​

山丘阴影样式层在客户端渲染数字高程模型(DEM)数据。

hillshade-accent-color​

Paint属性。可选，格式是color。默认值"#000000"。支持interpolate表达式。

用于突出陡峭的悬崖和峡谷等崎岖地形的阴影颜色。

hillshade-exaggeration​

Paint属性。可选，格式是number。取值范围：0~1，默认值0.5。支持interpolate表达式。

阴影的强度。

hillshade-highlight-color​

Paint属性。可选，格式是color。默认值"#FFFFFF"。支持interpolate表达式。

背向光源区域的底色。

hillshade-illumination-anchor​

Paint属性。可选，格式是枚举，是enum。"map", "viewport"中的一种。默认值"viewport"。

地图旋转时光源的方向。

"map": 山体阴影照明相对于北方向。

"viewport"：山体阴影照明相对于视图的顶部。

hillshade-illumination-direction​

Paint属性。可选，格式是number。取值范围：0~359，默认值335。支持interpolate表达式。

如果hillshade-illumination-anchor设置为viewport，则光源的方向为视图顶部，如果hillshade-illumination-anchor设置为map，则光源的方向为正北。

hillshade-shadow-color​

Paint属性。可选，格式是color。默认值"#000000"。支持interpolate表达式。

背向光源的区域的阴影色。

visibility​

Layout属性。可选，格式是枚举，是enum。"visible", "none"中的一种。默认值"visible"。

是否显示该层。

"visible": 图层显示。

"none": 图层隐藏。