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. Default value: "butt".
The display of lines when joining. Default value: "miter".
Used to automatically convert miter joins to bevel joins for sharp angles. Default value: 2.
Used to automatically convert round joins to miter joins for shallow angles. Default value: 1.05.
Sorts features in ascending order based on this value. Features with a higher sort key will appear above features with a lower sort key.
Vertical offset from ground, in meters. Defaults to 0. Not supported for globe projection at the moment.
Blur applied to the line, in pixels. Default value: 0. Minimum value: 0.
Defines the transition of lineBlur. Default value: 0. Minimum value: 0.
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. Default value: "rgba(0, 0, 0, 0)".
Defines the transition of lineBorderColor. Default value: "rgba(0, 0, 0, 0)".
The width of the line border. A value of zero means no border. Default value: 0. Minimum value: 0.
Defines the transition of lineBorderWidth. Default value: 0. Minimum value: 0.
The color with which the line will be drawn. Default value: "#000000".
Defines the transition of lineColor. Default value: "#000000".
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. Minimum value: 0.
Decrease line layer opacity based on occlusion from 3D objects. Value 0 disables occlusion, value 1 means fully occluded. Default value: 1. Value range: 0, 1
Defines the transition of lineDepthOcclusionFactor. Default value: 1. Value range: 0, 1
Controls the intensity of light emitted on the source features. Default value: 0. Minimum value: 0.
Defines the transition of lineEmissiveStrength. Default value: 0. Minimum value: 0.
Draws a line casing outside of a line's actual path. Value indicates the width of the inner gap. Default value: 0. Minimum value: 0.
Defines the transition of lineGapWidth. Default value: 0. Minimum value: 0.
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.
Opacity multiplier (multiplies line-opacity value) of the line part that is occluded by 3D objects. Value 0 hides occluded part, value 1 means the same opacity as non-occluded part. The property is not supported when line-opacity has data-driven styling. Default value: 0. Value range: 0, 1
Defines the transition of lineOcclusionOpacity. Default value: 0. Value range: 0, 1
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. Default value: 0.
Defines the transition of lineOffset. Default value: 0.
The opacity at which the line will be drawn. Default value: 1. Value range: 0, 1
Defines the transition of lineOpacity. Default value: 1. Value range: 0, 1
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. Default value: 0,0.
Defines the transition of lineTranslate. Default value: 0,0.
Controls the frame of reference for line-translate. Default value: "map".
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. Default value: 0,0. Minimum value: 0,0. Maximum value: 1,1.
Stroke thickness. Default value: 1. Minimum value: 0.
Defines the transition of lineWidth. Default value: 1. Minimum value: 0.
Whether this layer is displayed. Default value: "visible".
The minimum zoom level for the layer. At zoom levels less than the minzoom, the layer will be hidden. Value range: 0, 24
The maximum zoom level for the layer. At zoom levels equal to or greater than the maxzoom, the layer will be hidden. Value range: 0, 24
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.