Mapbox Style Specification

https://docs.mapbox.com/style-spec/
Admin
The Mapbox Style Specification defines the JSON document structure that dictates the visual...
Tokens:44,455
Snippets:863
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### Define fog properties

Source: https://docs.mapbox.com/style-spec/reference/fog

Example configuration for the global fog effect.

```json
"fog": {
    "range": [0.8, 8],
    "color": "#dc9f9f",
    "horizon-blend": 0.5,
    "high-color": "#245bde",
    "space-color": "#000000",
    "star-intensity": 0.15
}
```

--------------------------------

### Define a Vector Source

Source: https://docs.mapbox.com/style-spec/reference/sources

Example of a basic vector source configuration using a Mapbox tileset URL.

```json
"mapbox-streets": {
    "type": "vector",
    "url": "mapbox://mapbox.mapbox-streets-v6"
}
```

--------------------------------

### Define a raster-array source

Source: https://docs.mapbox.com/style-spec/reference/sources

Example configuration for a raster-array source using a Mapbox tileset URL.

```json
"gfs-wind": {
    "type": "raster-array",
    "url": "mapbox://mapbox.gfs-winds",
    "tileSize": 512
}
```

--------------------------------

### Install Mapbox Docs MCP Server

Source: https://docs.mapbox.com/style-spec/llms.txt

Command to add the Mapbox Docs MCP server to an AI agent environment for direct documentation access.

```bash
claude mcp add mapbox-docs --transport http https://mcp-docs.mapbox.com/mcp
```

--------------------------------

### Define an image source

Source: https://docs.mapbox.com/style-spec/reference/sources

Example configuration for an image source, specifying the image URL and the four corner coordinates in longitude/latitude pairs.

```json
"image": {
    "type": "image",
    "url": "https://docs.mapbox.com/mapbox-gl-js/assets/radar.gif",
    "coordinates": [
        [-80.425, 46.437],
        [-71.516, 46.437],
        [-71.516, 37.936],
        [-80.425, 37.936]
    ]
}
```

--------------------------------

### Define a raster source

Source: https://docs.mapbox.com/style-spec/reference/sources

Example configuration for a raster source using a Mapbox tileset ID.

```json
"mapbox-satellite": {
    "type": "raster",
    "url": "mapbox://mapbox.satellite",
    "tileSize": 256
}
```

--------------------------------

### Define a Mapbox style JSON structure

Source: https://docs.mapbox.com/style-spec/guides

This example demonstrates the root-level structure of a style document, including camera settings, data sources, and layer definitions.

```json
{
  "name": "some-style",
  "version": 8,

  // default camera position
  "center": [ -74, 40.73 ],
  "zoom": 11.3,
  "bearing": 20.8,
  "pitch": 17.5,

  // sprites and fonts
  "sprite": "mapbox://sprites/mapbox/light-v11",
  "glyphs": "mapbox://fonts/mapbox/{fontstack}/{range}.pbf",

  // spatial data to include, used one-to-many with layers
  "sources": {
    "some-vector-source": {
      "type": "vector",
      "url": "mapbox://mapbox.mapbox-streets-v8"
    },
    "some-raster-source": {
      "type": "raster",
      "url": "mapbox://mapbox.satellite",
      "tileSize": 256
    },
    "some-geojson-source": {
      "type": "geojson",
      "data": "https://path-to-geojson-data"
    },
  },
  // layers define rendering the map, in order; used many-to-one with sources
  "layers": [
    {
      "id": "some-layer",
      "type": "fill",
      "source": "some-vector-source",
      "source-layer": "some-source-layer",
      "layout": {
        "visibility": "visible"
      },
      "paint": {
        "fill-color": "#888888",
        "fill-opacity": 0.5
      }
    },
    {
      "id": "another-layer",
      "type": "circle",
      "source": "some-geojson-source",
      "paint": {
        "circle-radius": 10,
        "circle-color": "#FF0000"
      }
    },
    {
      "id": "some-raster-layer",
      "type": "raster",
      "source": "some-raster-source",
      "minzoom": 0,
      "maxzoom": 22,
      "paint": {
        "raster-opacity": 0.5
      }
    }
  ]
}
```

--------------------------------

### Define directional light source

Source: https://docs.mapbox.com/style-spec/reference/light

Example of specifying the azimuthal and polar angles for the light source.

```json
[
  90,
  40
]
```

--------------------------------

### Define optional sprite properties

Source: https://docs.mapbox.com/style-spec/reference/sprite

Example of using content bounds and stretchable zones to control how an image is rendered and resized.

```json
{
    "us-highway-shield": {
        ...
        "content": [14, 10, 40, 28],
        "stretchX": [[14, 22], [33, 40]],
        "stretchY": [[11, 14]]
    }
}
```

--------------------------------

### Define style schema configuration

Source: https://docs.mapbox.com/style-spec/reference/schema

Example of a schema object defining boolean and enumerated options for a Mapbox style.

```json
{
    "schema": {
        "showPointOfInterestLabels": {
            "default": true,
            "type": "boolean"
        },
        "lightPreset": {
            "default": "noon",
            "values": [ "dawn", "noon", "dusk", "night" ]
        }
    }
}
```

--------------------------------

### Define array types

Source: https://docs.mapbox.com/style-spec/reference/types

Examples of using arrays for style properties and within expressions using the literal wrapper.

```json
{
    "line-dasharray": [2, 4]
}

{
    "circle-color": ["in", 1, ["literal", [1, 2, 3]]]
}
```

--------------------------------

### Define a raster-dem source

Source: https://docs.mapbox.com/style-spec/reference/sources

Example configuration for a Mapbox Terrain-DEM source using the required URL format.

```json
"mapbox-terrain-dem-v1": {
    "type": "raster-dem",
    "url": "mapbox://mapbox.mapbox-terrain-dem-v1"
}
```

--------------------------------

### Retrieve property value with get

Source: https://docs.mapbox.com/style-spec/reference/expressions

Retrieves a property value from the current feature or a specified object.

```text
["get", string]: value
```

```text
["get", string, object]: value
```

--------------------------------

### Apply dynamic circle color using feature properties

Source: https://docs.mapbox.com/style-spec/reference/expressions

Uses the get operator to retrieve the temperature property and calculate RGB color components dynamically.

```json
{
    "circle-color": [
        "rgb",
        // red is higher when feature.properties.temperature is higher
        ["get", "temperature"],
        // green is always zero
        0,
        // blue is higher when feature.properties.temperature is lower
        ["-", 100, ["get", "temperature"]]
    ]
}
```

--------------------------------

### Define SVG Color Parameters

Source: https://docs.mapbox.com/style-spec/reference/types

Example of embedding Mapbox-specific metadata in an SVG to enable color parameter replacement.

```xml
<svg xmlns="http://www.w3.org/2000/svg" xmlns:m="https://www.mapbox.com">
  <m:metadata>
    <m:parameters>
      <m:parameter m:name="background" m:type="color" m:value="#ffffff" />
      <m:parameter m:name="main" m:type="color" m:value="#ff0000" />
    </m:parameters>
  </m:metadata>
...
<!-- "background" color usage -->
<rect fill="#ffffff">
    <!-- "main" color usage -->
    <circle fill="#ff0000">
</rect>
</svg>
```

--------------------------------

### Define range array

Source: https://docs.mapbox.com/style-spec/reference/fog

Example of the range property array defining the start and end distance for fog fading.

```json
[
  0.5,
  10
]
```

--------------------------------

### Define a layers object in a Mapbox style

Source: https://docs.mapbox.com/style-spec/reference/layers

Example of a layers array containing a single fill layer referencing a source and source-layer.

```json
"layers": [
  {
    "id": "water",
    "source": "mapbox-streets",
    "source-layer": "water",
    "type": "fill",
    "paint": {
      "fill-color": "#00ffff"
    }
  }
]
```

--------------------------------

### get

Source: https://docs.mapbox.com/style-spec/reference/expressions

Retrieves a property value from the current feature or a specified object.

```APIDOC
## get

### Description
Retrieves a property value from the current feature's properties, or from another object if a second argument is provided. Returns `null` if the requested property is missing.

### Syntax
`["get", string]: value`
`["get", string, object]: value`
```

--------------------------------

### Get length with length

Source: https://docs.mapbox.com/style-spec/reference/expressions

Returns the length of an array or string.

```text
["length", string | array | value]: number
```

--------------------------------

### Define and use a configuration option

Source: https://docs.mapbox.com/style-spec/reference/imports

Define a configuration option in the schema and reference it in a paint property using a config expression.

```json
{
  "schema": {
    "colorLand": {
      "default": "hsl(47, 44%, 86%)",
      "type": "color"
    }
  },
  "layers": [
    {
      "id": "land",
      "type": "background",
      "paint": {
        "background-color": ["config", "colorLand"]
      }
    }
  ]
}
```

--------------------------------

### Get type of value expression

Source: https://docs.mapbox.com/style-spec/reference/expressions

Returns a string representation of the type of the provided value.

```text
["typeof", value]: string
```

--------------------------------

### Compound Filter Example

Source: https://docs.mapbox.com/style-spec/reference/other

A complex filter requiring all conditions to be met for feature inclusion.

```json
[
    "all",
    ["==", "class", "street_limited"],
    [">=", "admin_level", 3],
    ["!in", "$type", "Polygon"]
]
```

--------------------------------

### Check script support

Source: https://docs.mapbox.com/style-spec/reference/expressions

Determines if the input string can be rendered legibly.

```text
["is-supported-script", string]: boolean
```

--------------------------------

### Define a video source in Mapbox Style

Source: https://docs.mapbox.com/style-spec/reference/sources

Configures a video source with multiple format URLs and four corner coordinates in clockwise order.

```json
"video": {
    "type": "video",
    "urls": [
        "https://static-assets.mapbox.com/mapbox-gl-js/drone.mp4",
        "https://static-assets.mapbox.com/mapbox-gl-js/drone.webm"
    ],
    "coordinates": [
        [-122.51596391201019, 37.56238816766053],
        [-122.51467645168304, 37.56410183312965],
        [-122.51309394836426, 37.563391708549425],
        [-122.51423120498657, 37.56161849366671]
    ]
}
```

--------------------------------

### Override configuration values at import

Source: https://docs.mapbox.com/style-spec/reference/imports

Provide custom values for configuration options when importing a style to override defaults.

```json
{
  "imports": [
    {
      "id": "basemap",
      "url": "mapbox://styles/mapbox/standard",
      "config": {
        "showPedestrianRoads": false,
        "colorLand": "#f0e8d8"
      }
    }
  ]
}
```

--------------------------------

### Optimize glTF models with gltfpack

Source: https://docs.mapbox.com/style-spec/guides/using-3d-models

Use these flags to perform lossless optimization while preserving the node hierarchy, materials, and custom metadata required for Mapbox features.

```shell
$ gltfpack -i input.glb -o output.glb -kn -km -ke -noq
```

--------------------------------

### Configure light position

Source: https://docs.mapbox.com/style-spec/reference/light

Sets the light source position using radial, azimuthal, and polar coordinates.

```json
[
  1.5,
  90,
  80
]
```

--------------------------------

### Define Tiled Source with WMS Server URL

Source: https://docs.mapbox.com/style-spec/reference/sources

Configure a raster source using a WMS server URL containing the {bbox-epsg-3857} replacement token.

```json
"wms-imagery": {
    "type": "raster",
    "tiles": [
        "http://a.example.com/wms?bbox={bbox-epsg-3857}&format=image/png&service=WMS&version=1.1.1&request=GetMap&srs=EPSG:3857&width=256&height=256&layers=example"
    ],
    "tileSize": 256
}
```

--------------------------------

### Retrieve configuration value with config

Source: https://docs.mapbox.com/style-spec/reference/expressions

Retrieves a configuration value for a given option, returning null if missing.

```text
["config", string]: config
```

```text
["config", string, string]: config
```

--------------------------------

### Measure light property with measure-light

Source: https://docs.mapbox.com/style-spec/reference/expressions

Returns a requested property of the light configuration, such as brightness.

```text
["measure-light", string]: number
```

--------------------------------

### Feature properties expression

Source: https://docs.mapbox.com/style-spec/reference/expressions

Returns the entire feature properties object. Consider using the get expression for individual property access for better efficiency.

```text
["properties"]: object
```

--------------------------------

### Bind variables with let

Source: https://docs.mapbox.com/style-spec/reference/expressions

Binds expressions to named variables for later reference.

```text
["let",
    string (alphanumeric literal), any, string (alphanumeric literal), any, ...,
    OutputType
]: OutputType
```

--------------------------------

### measure-light

Source: https://docs.mapbox.com/style-spec/reference/expressions

Returns a property of the light configuration.

```APIDOC
## measure-light

### Description
Returns a requested property of the light configuration based on the supplied options.

### Syntax
`["measure-light", string]: number`
```

--------------------------------

### Configure Model Source Parameters

Source: https://docs.mapbox.com/style-spec/reference/types

Defines a model source with specific model URIs, orientation settings, and material override placeholders.

```json
{
    "sources" : {
        "3d-model-source": {
            "type": "model",
            "models": {
                "car-model-1": {
                    "uri": "/assets/car1.glb",
                    "orientation": [0, 45, 0],
                    "materialOverrides": {
                        "car_body_paint" : {
                            // ....
                        }
                    }
                    // ...
                },
                "car-model-2": {
                    "uri": "/assets/car2.glb",
                    // ...
                }
            }
        }
    }
}
```

--------------------------------

### config

Source: https://docs.mapbox.com/style-spec/reference/expressions

Retrieves the configuration value for a given option.

```APIDOC
## config

### Description
Retrieves the configuration value for the given option. Returns null if the requested option is missing.

### Syntax
`["config", string]: config`
`["config", string, string]: config`
```

--------------------------------

### Configure PromoteId

Source: https://docs.mapbox.com/style-spec/reference/types

Specify a property to use as a feature ID, either globally or per source layer.

```json
{
    "promoteId": "some_property"
}

{
    "promoteId: {
        "sourceLayer": "layer_name",
        "id": "some_property"
    }
}
```

--------------------------------

### Select Nodes and Materials for Override

Source: https://docs.mapbox.com/style-spec/guides/using-3d-models

Use materialOverrideNames and nodeOverrideNames in the model source to enable paint property overrides for specific parts.

```json
// ...
  "sources": {
    "3d-model-source": {
        "type": "model",
        "models": {
            "car": {
                "uri": "/mapbox-gl-js/assets/ego_car.glb",
                "position": [-74.0135, 40.7153],
                "orientation": [0, 0, 0],
                // List of material names to be overridden in paint properties.
                "materialOverrideNames": [
                    "body",
                    "lights_brakes",
                ],
                // List of node names to be overridden in paint properties.
                "nodeOverrideNames": [
                    "doors_front-left",
                    "doors_front-right",
                    "hood",
                    "trunk"
                ]
            }
        }
    }
 }
// ...
```

--------------------------------

### Define Global Transition

Source: https://docs.mapbox.com/style-spec/reference/root

Sets default duration and delay for property transitions.

```json
{
  "duration": 300,
  "delay": 0
}
```

--------------------------------

### Configure parallels for conic projections

Source: https://docs.mapbox.com/style-spec/reference/projection

Sets the standard parallels to define the latitude range with minimal distortion for conic projections.

```json
[
  29.5,
  45.5
]
```

--------------------------------

### Define Style Models

Source: https://docs.mapbox.com/style-spec/reference/root

Maps model identifiers to their respective asset URLs.

```json
{
  "spruce1-lod0": "asset://spruce1-lod0.glb",
  "spruce1-lod1": "asset://spruce1-lod1.glb",
  "spruce1-lod2": "asset://spruce1-lod2.glb"
}
```

--------------------------------

### Define an imported style

Source: https://docs.mapbox.com/style-spec/reference/imports

Use the imports property to reference an external style URL and provide initial configuration values.

```json
{
    ...
    "imports": [
        {
            "id": "basemap",
            "url": "mapbox://styles/mapbox/standard",
            "config": {
                "lightPreset": "dusk",
                "showPointOfInterestLabels": false
            }
        }
    ]
    ...
}
```

--------------------------------

### step

Source: https://docs.mapbox.com/style-spec/reference/expressions

Produces discrete, stepped results by evaluating a piecewise-constant function.

```APIDOC
## step

### Description
Produces discrete, stepped results by evaluating a piecewise-constant function defined by pairs of input and output values. Returns the output value of the stop just less than the input, or the first output if the input is less than the first stop.

### Syntax
["step",
    input: number,
    stop_output_0: OutputType,
    stop_input_1: number, stop_output_1: OutputType,
    stop_input_n: number, stop_output_n: OutputType, ...
]: OutputType
```

--------------------------------

### Define Tiled Source with TileJSON Properties

Source: https://docs.mapbox.com/style-spec/reference/sources

Directly specify TileJSON properties like tiles, minzoom, and maxzoom within the source definition.

```json
"mapbox-streets": {
    "type": "vector",
    "tiles": [
        "http://a.example.com/tiles/{z}/{x}/{y}.pbf",
        "http://b.example.com/tiles/{z}/{x}/{y}.pbf"
    ],
    "maxzoom": 14
}
```

--------------------------------

### Define Tiled Source with TileJSON URL

Source: https://docs.mapbox.com/style-spec/reference/sources

Reference an external TileJSON resource using a URL property.

```json
"mapbox-streets": {
    "type": "vector",
    "url": "http://api.example.com/tilejson.json"
}
```

--------------------------------

### <=

Source: https://docs.mapbox.com/style-spec/reference/expressions

Returns true if the first input is less than or equal to the second, false otherwise.

```APIDOC
## <=

### Description
Returns true if the first input is less than or equal to the second, false otherwise. Arguments must be both strings or both numbers.

### Syntax
["<=", value, value]: boolean
["<=", value, value, collator]: boolean
```

--------------------------------

### Set Style Name

Source: https://docs.mapbox.com/style-spec/reference/root

Provides a human-readable name for the style.

```json
"Bright"
```

--------------------------------

### Define global light properties

Source: https://docs.mapbox.com/style-spec/reference/light

Configures the anchor, color, and intensity of the global light source.

```json
"light": {
  "anchor": "viewport",
  "color": "white",
  "intensity": 0.4
}
```

--------------------------------

### Use config expression for visibility

Source: https://docs.mapbox.com/style-spec/reference/imports

Reference a configuration option within a layer's layout property to control visibility dynamically.

```json
{
  "id": "road-pedestrian",
  "type": "line",
  "layout": {
    "visibility": [
      "case",
      ["config", "showPedestrianRoads"],
      "visible",
      "none"
    ]
  }
}
```

--------------------------------

### index-of

Source: https://docs.mapbox.com/style-spec/reference/expressions

Returns the first position of an item or substring.

```APIDOC
## index-of

### Description
Returns the first position at which an item can be found in an array or a substring can be found in a string, or `-1` if the input cannot be found.

### Syntax
`["index-of", value, value]: number`
`["index-of", value, value, number]: number`
```

--------------------------------

### Step Expression Syntax

Source: https://docs.mapbox.com/style-spec/reference/expressions

Defines the structure for generating discrete, stepped results based on input values.

```text
["step",
    input: number,
    stop_output_0: OutputType,
    stop_input_1: number, stop_output_1: OutputType,
    stop_input_n: number, stop_output_n: OutputType, ...
]: OutputType
```

--------------------------------

### Define a model source

Source: https://docs.mapbox.com/style-spec/reference/sources

Basic structure for a model source referencing 3D models.

```json
"gltf-models": {
    "type": "model",
   ....
}
```

--------------------------------

### All Logical Expression Syntax

Source: https://docs.mapbox.com/style-spec/reference/expressions

Syntax for the all operator, which performs short-circuiting logical AND evaluation.

```text
[ "all", boolean, boolean]: boolean
```

```text
[ "all", boolean, boolean, ...]: boolean
```

--------------------------------

### Define layer appearances

Source: https://docs.mapbox.com/style-spec/reference/types

Objects defining paint and layout properties based on specific conditions like feature states.

```json
  {
    "name": "selected",
    "condition": ["feature-state", "select"],
    "properties": {
      "icon-image": ["image", "poi", {"params": {"fill": "red"}}],
      "icon-size": 1.3
    }
  }

  {
      "name": "highlighted",
      "condition": ["feature-state", "highlighted"],
      "properties": {
        "icon-rotate": 90
      }
    }
```

--------------------------------

### ==

Source: https://docs.mapbox.com/style-spec/reference/expressions

Returns true if the input values are equal, false otherwise.

```APIDOC
## ==

### Description
Returns true if the input values are equal, false otherwise. The comparison is strictly typed.

### Syntax
["==", value, value]: boolean
["==", value, value, collator]: boolean
```

--------------------------------

### at

Source: https://docs.mapbox.com/style-spec/reference/expressions

Retrieves an item from an array at a specified index.

```APIDOC
## at

### Description
Retrieves an item from an array.

### Syntax
`["at", number, array]: ItemType`
```

--------------------------------

### Validate style JSON via CLI

Source: https://docs.mapbox.com/style-spec/guides

Use the gl-style-validate tool to check a style document against the specification.

```bash
$ gl-style-validate path/to/style.json
```

--------------------------------

### Apply Paint Property Overrides with Expressions

Source: https://docs.mapbox.com/style-spec/guides/using-3d-models

Use paint properties with expressions to dynamically control model materials and node rotations based on feature state.

```json
{
    "layers" : [
    {
        "id": "3d-model-layer",
        "type": "model",
        "source": "3d-model-source",
        "paint": {
            "model-scale": [10, 10, 10],
            "model-type": "location-indicator",
            // The following properties target materials, 'part' therefore is matched with material names listed in overrideMaterialNames
            "model-color": [
                "match",
                ["get", "part"],
                "lights_brakes",
                ["feature-state", "brake-light-color"],
                "rgba(225, 0, 0, 1)" // fallback
            ],
            "model-color-mix-intensity": [
                "match",
                ["get", "part"],
                "body",
                1.0,
                0.0
            ],

            // Control rotation of model and model nodes.
            // Node names listed in overrideNodeNames are matched using ["get","part"] expression.
            // Rotation value is obtained from feature state.
            "model-rotation": [
                "match",
                ["get", "part"],
                "doors_front-left",
                ["feature-state", "doors-front-left"],
                // ....
                "trunk",
                ["feature-state", "trunk"],
                [0.0, 0.0, 0.0]
            ]
        }}
    ]
}
```

--------------------------------

### !

Source: https://docs.mapbox.com/style-spec/reference/expressions

Logical negation. Returns true if the input is false, and false if the input is true.

```APIDOC
## !

### Description
Logical negation. Returns true if the input is false, and false if the input is true.

### Syntax
["!", boolean]: boolean
```

--------------------------------

### Camera expression syntax forms

Source: https://docs.mapbox.com/style-spec/reference/expressions

Valid structures for using camera expressions within layout or paint properties.

```json
[ "interpolate", interpolation, ["zoom"], ... ]
```

```json
[ "step", ["zoom"], ... ]
```

```json
[
    "let",
    ... variable bindings...,
    [ "interpolate", interpolation, ["zoom"], ... ]
]
```

```json
[
    "let",
    ... variable bindings...,
    [ "step", ["zoom"], ... ]
]
```

--------------------------------

### Reference bound variables with var

Source: https://docs.mapbox.com/style-spec/reference/expressions

Retrieves the value of a previously bound variable.

```text
["var", previously bound variable name]: the type of the bound expression
```

--------------------------------

### raster-array Source Configuration

Source: https://docs.mapbox.com/style-spec/reference/sources

Defines the configuration schema for a raster-array source, including properties for attribution, bounds, zoom levels, and tile source definitions.

```APIDOC
## raster-array Source

### Description
A raster-array tile source used for rendering raster data tiles. This source type is experimental and intended for use with Mapbox Tiling Service (MTS) tilesets.

### Configuration Properties
- **type** (string) - Required - Must be "raster-array".
- **url** (string) - Optional - A URL to a TileJSON resource. Required if `tiles` is not provided.
- **tiles** (array of strings) - Optional - An array of one or more tile source URLs. Required if `url` is not provided.
- **tileSize** (number) - Optional - The minimum visual size to display tiles in pixels. Defaults to 512.
- **attribution** (string) - Optional - Attribution text to be displayed when the map is shown.
- **bounds** (array of numbers) - Optional - The bounding box of the source in [sw.lng, sw.lat, ne.lng, ne.lat] format. Defaults to [-180,-85.051129,180,85.051129].
- **extra_bounds** (array of arrays) - Optional - Additional discrete geographic regions where tiles are available.
- **minzoom** (number) - Optional - Minimum zoom level. Defaults to 0.
- **maxzoom** (number) - Optional - Maximum zoom level. Defaults to 22.
- **rasterLayers** (object) - Optional - Description of the raster data layers and bands.
- **volatile** (boolean) - Optional - Determines if tiles are cached locally. Defaults to false.

### Example
```json
"gfs-wind": {
    "type": "raster-array",
    "url": "mapbox://mapbox.gfs-winds",
    "tileSize": 512
}
```
```

--------------------------------

### Math Expressions

Source: https://docs.mapbox.com/style-spec/reference/expressions

A collection of mathematical operators and functions for Mapbox style expressions.

```APIDOC
## Math Expressions

### - (Subtraction)
Returns the result of subtracting the second input from the first, or negates a single input.
Syntax: `["-", number, number]: number` or `["-", number]: number`

### * (Multiplication)
Returns the product of the inputs.
Syntax: `["*", number, number, ...]: number`

### / (Division)
Returns the result of floating point division of the first input by the second.
Syntax: `["/", number, number]: number`

### % (Remainder)
Returns the remainder after integer division of the first input by the second.
Syntax: `["%", number, number]: number`

### ^ (Exponentiation)
Returns the result of raising the first input to the power specified by the second.
Syntax: `["^", number, number]: number`

### + (Addition)
Returns the sum of the inputs.
Syntax: `["+", number, number, ...]: number`

### abs
Returns the absolute value of the input.
Syntax: `["abs", number]: number`

### acos
Returns the arccosine of the input, in radians between −π/2 and π/2.
Syntax: `["acos", number]: number`

### asin
Returns the arcsine of the input, in radians between −π/2 and π/2.
Syntax: `["asin", number]: number`

### atan
Returns the arctangent of the input, in radians between −π/2 and π/2.
Syntax: `["atan", number]: number`

### ceil
Returns the smallest integer that is greater than or equal to the input.
Syntax: `["ceil", number]: number`

### cos
Returns the cosine of the input, interpreted as radians.
Syntax: `["cos", number]: number`

### distance
Returns the shortest distance in meters between the evaluated feature and the input geometry.
Syntax: `["distance", object]: number`

### e
Returns the mathematical constant e.
Syntax: `["e"]: number`

### floor
Returns the largest integer that is less than or equal to the input.
Syntax: `["floor", number]: number`

### ln
Returns the natural logarithm of the input.
Syntax: `["ln", number]: number`
```

--------------------------------

### Format expression syntax

Source: https://docs.mapbox.com/style-spec/reference/expressions

Syntax for creating a formatted string with optional style overrides for text fields.

```text
["format",
    input_1: string | image, options_1: { "font-scale": number, "text-font": array<string>, "text-color": color },
    ...,
    input_n: string | image, options_n: { "font-scale": number, "text-font": array<string>, "text-color": color }
]: formatted
```

--------------------------------

### Define layer appearances

Source: https://docs.mapbox.com/style-spec/reference/appearances

Configures a layer with multiple appearance states triggered by feature-state conditions.

```json
{
  "id": "some-layer",
  "type": "symbol",
  ...
  "appearances": [
    {
      "name": "selected",
      "condition": ["feature-state", "select"],
      "properties": {
        "icon-image": ["image", "poi", {"params": {"fill": "red"}}],
        "icon-size": 1.3,
        "text-color": "#ff0000",
        "text-halo-color": "#c0caff",
      }
    },
    {
      "name": "highlighted",
      "condition": ["feature-state", "highlighted"],
      "properties": {
        "icon-size": 2,
        "text-color": "#4264fb",
        "text-halo-color": "#c0caff",
      }
    }
  ]
}
```

--------------------------------

### Any Logical Expression Syntax

Source: https://docs.mapbox.com/style-spec/reference/expressions

Syntax for the any operator, which performs short-circuiting logical OR evaluation.

```text
[ "any", boolean, boolean]: boolean
```

```text
[ "any", boolean, boolean, ...]: boolean
```

--------------------------------

### Match expression syntax

Source: https://docs.mapbox.com/style-spec/reference/expressions

Defines the structure for the match expression, which selects an output based on input value matching.

```text
["match",
    input: InputType (number or string),
    label: InputType | [InputType, InputType, ...], output: OutputType,
    label: InputType | [InputType, InputType, ...], output: OutputType,
    ...,
    fallback: OutputType
]: OutputType
```

--------------------------------

### Define a Boolean property

Source: https://docs.mapbox.com/style-spec/reference/types

Use true or false to enable or disable style features.

```json
{
    "fill-enabled": true
}
```

--------------------------------

### Configure ImageOptions

Source: https://docs.mapbox.com/style-spec/reference/types

Usage of the ImageOptions object within an image expression to define parameters and iconsets.

```json
"icon-image": [
    "image",
    "oval",
    // ImageOptions object
    {
        "params": {
            "background": "#000000",
            "main": ["get", "main_color"]
            ...
        },
        "iconset": {
            "id": "some-iconset"
        }   
    }
]
```

--------------------------------

### Less than or equal expression syntax

Source: https://docs.mapbox.com/style-spec/reference/expressions

Defines the syntax for less than or equal comparison, optionally using a collator.

```text
["<=", value, value]: boolean
```

```text
["<=", value, value, collator]: boolean
```

--------------------------------

### Addition Expression

Source: https://docs.mapbox.com/style-spec/reference/expressions

Returns the sum of the provided inputs.

```text
["+", number, number, ...]: number
```

--------------------------------

### !=

Source: https://docs.mapbox.com/style-spec/reference/expressions

Returns true if the input values are not equal, false otherwise.

```APIDOC
## !=

### Description
Returns true if the input values are not equal, false otherwise. The comparison is strictly typed.

### Syntax
["!=", value, value]: boolean
["!=", value, value, collator]: boolean
```

--------------------------------

### Heatmap density syntax

Source: https://docs.mapbox.com/style-spec/reference/expressions

Defines the return type for the heatmap-density expression.

```text
["heatmap-density"]: number
```

--------------------------------

### raster-dem Source Configuration

Source: https://docs.mapbox.com/style-spec/reference/sources

Configuration properties for a raster-dem source, which provides elevation data for terrain rendering.

```APIDOC
## raster-dem Source

### Description
A raster-dem source provides elevation data. It is primarily used with Mapbox Terrain-DEM.

### Properties
- **type** (string) - Required - Must be "raster-dem".
- **url** (string) - Optional - A URL to a TileJSON resource. Required if `tiles` is not provided.
- **tiles** (array) - Optional - An array of one or more tile source URLs. Required if `url` is not provided.
- **attribution** (string) - Optional - Attribution text to be displayed.
- **bounds** (array) - Optional - The bounding box of the source in [sw.lng, sw.lat, ne.lng, ne.lat] format.
- **encoding** (enum) - Optional - The encoding used: "terrarium" or "mapbox". Defaults to "mapbox".
- **extra_bounds** (array) - Optional - Additional discrete geographic regions where tiles are available.
- **maxzoom** (number) - Optional - Maximum zoom level. Defaults to 22.
- **minzoom** (number) - Optional - Minimum zoom level. Defaults to 0.
- **tileSize** (number) - Optional - Minimum visual size to display tiles in pixels. Defaults to 512.
- **volatile** (boolean) - Optional - Whether tiles are cached locally. Defaults to false.
```

--------------------------------

### <

Source: https://docs.mapbox.com/style-spec/reference/expressions

Returns true if the first input is strictly less than the second, false otherwise.

```APIDOC
## <

### Description
Returns true if the first input is strictly less than the second, false otherwise. Arguments must be both strings or both numbers.

### Syntax
["<", value, value]: boolean
["<", value, value, collator]: boolean
```

--------------------------------

### Set light anchor

Source: https://docs.mapbox.com/style-spec/reference/light

Specifies whether the light source is relative to the map or the viewport.

```json
"map"
```

--------------------------------

### Retrieve array item with at

Source: https://docs.mapbox.com/style-spec/reference/expressions

Retrieves an item from an array using a numeric index.

```text
["at", number, array]: ItemType
```

--------------------------------

### Determine existence with in

Source: https://docs.mapbox.com/style-spec/reference/expressions

Determines if an item exists in an array or a substring exists in a string.

```text
["in", value, value]: boolean
```

--------------------------------

### Worldview expression syntax

Source: https://docs.mapbox.com/style-spec/reference/expressions

Defines the syntax for retrieving the current worldview.

```text
["worldview"]: string
```

--------------------------------

### ["pitch"]

Source: https://docs.mapbox.com/style-spec/reference/expressions

Returns the current pitch of the map in degrees.

```APIDOC
## ["pitch"]

### Description
Returns the current pitch in degrees. This expression may only be used in the `filter` expression for a `symbol` layer.

### Syntax
`["pitch"]: number`
```

--------------------------------

### Define Model Source Overrides

Source: https://docs.mapbox.com/style-spec/guides/using-3d-models

Specify material and node orientation overrides directly within the model source configuration.

```json
{
  ....
  "materialOverrides": {
      "body": {
          "model-color": [1.0, 0, 0],
          "model-color-mix-intensity": 1.0
      },
      "lights_brakes": {
          "model-color": [0.88, 0.0, 0.0],
          "model-color-mix-intensity": 0.4,
          "model-emissive-strength": 0.8
      }
  },
  "nodeOverrides": {
      "doors_front-left": {
          "orientation": [0.0, -35.0, 0.0]
      },
      "trunk": {
          "orientation": [ -45, 0.0, 0.0 ]
      }
  }
  ....
}
```

--------------------------------

### Define an Enum value

Source: https://docs.mapbox.com/style-spec/reference/types

Demonstrates setting a property to one of a fixed set of allowed values.

```json
{
    "line-cap": "round"
}
```

--------------------------------

### Define Model Light Overrides

Source: https://docs.mapbox.com/style-spec/reference/types

Configures ambient and directional light properties for a 3D model.

```json
{
    "lightOverrides": {
        "light-ambient-color": "rgb(255, 255, 255)",
        "light-ambient-intensity": 0.5,
        "light-directional-color": "rgb(255, 255, 255)",
        "light-directional-intensity": 0.5
    }
}
```
Tokens:
Raw