Line
A stroked line.
See also
Parameters
the source that drives this layer.
the ID of the layer, by default, a random id will be generated with UUID.
The display of line endings.
The display of lines when joining.
Used to automatically convert miter joins to bevel joins for sharp angles.
Used to automatically convert round joins to miter joins for shallow angles.
Sorts features in ascending order based on this value. Features with a higher sort key will appear above features with a lower sort key.
Blur applied to the line, in pixels.
Defines the transition of lineBlur.
The color of the line border. If line-border-width is greater than zero and the alpha value of this color is 0 (default), the color for the border will be selected automatically based on the line color.
Defines the transition of lineBorderColor.
The width of the line border. A value of zero means no border.
Defines the transition of lineBorderWidth.
The color with which the line will be drawn.
Defines the transition of lineColor.
Specifies the lengths of the alternating dashes and gaps that form the dash pattern. The lengths are later scaled by the line width. To convert a dash length to pixels, multiply the length by the current line width. Note that GeoJSON sources with lineMetrics: true specified won't render dashed lines to the expected scale. Also note that zoom-dependent expressions will be evaluated only at integer zoom levels.
Decrease line layer opacity based on occlusion from 3D objects. Value 0 disables occlusion, value 1 means fully occluded.
Defines the transition of lineDepthOcclusionFactor.
Controls the intensity of light emitted on the source features.
Defines the transition of lineEmissiveStrength.
Draws a line casing outside of a line's actual path. Value indicates the width of the inner gap.
Defines the transition of lineGapWidth.
A gradient used to color a line feature at various distances along its length. Defined using a step or interpolate expression which outputs a color for each corresponding line-progress input value. line-progress is a percentage of the line feature's total length as measured on the webmercator projected coordinate plane (a number between 0 and 1). Can only be used with GeoJSON sources that specify "lineMetrics": true.
The line's offset. For linear features, a positive value offsets the line to the right, relative to the direction of the line, and a negative value to the left. For polygon features, a positive value results in an inset, and a negative value results in an outset.
Defines the transition of lineOffset.
The opacity at which the line will be drawn.
Defines the transition of lineOpacity.
Name of image in sprite to use for drawing image lines. For seamless patterns, image width must be a factor of two (2, 4, 8, ..., 512). Note that zoom-dependent expressions will be evaluated only at integer zoom levels.
The geometry's offset. Values are x, y where negatives indicate left and up, respectively.
Defines the transition of lineTranslate.
Controls the frame of reference for line-translate.
The line part between trim-start, trim-end will be marked as transparent to make a route vanishing effect. The line trim-off offset is based on the whole line range 0.0, 1.0.
Stroke thickness.
Defines the transition of lineWidth.
Whether this layer is displayed.
The minimum zoom level for the layer. At zoom levels less than the minzoom, the layer will be hidden.
The maximum zoom level for the layer. At zoom levels equal to or greater than the maxzoom, the layer will be hidden.
Layer to use from a vector tile source. Required for vector tile sources; prohibited for all other source types, including GeoJSON sources.
An expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The ["feature-state", ...] expression is not supported in filter expressions. The ["pitch"] and ["distance-from-center"] expressions are supported only for filter expressions on the symbol layer.