Style Specification

Examples

Add an animated icon to the map Add a generated icon to the map Generate and add a missing icon to the map Add an icon to the map Display a map with a custom style Display a satellite map Display a map Change a map's style

Display buildings in 3D Add a 3D model Extrude polygons for 3D indoor mapping Adjust a layer's opacity Animate a line Animate a series of images Animate a point Change building color based on zoom level Change the case of labels Display HTML clusters with custom properties Create and style clusters Change a layer's color with buttons Add a custom style layer Style lines with a data-driven property Style circles with a data-driven property Display and style rich text labels Add a pattern to a polygon Add a new layer below labels Add a GeoJSON line Draw GeoJSON points Add a GeoJSON polygon Create a heatmap layer Create a gradient line using an expression Add multiple geometries from one GeoJSON source Style ocean depth data Show and hide layers Update a choropleth layer by zoom level Change worldview of administrative boundaries Variable label placement Visualize population density Add hillshading

Join local JSON data with vector tile geometries Add an image Add live realtime data Update a feature in realtime Add a raster tile source Add a third party vector tile source Add a vector tile source Add a video Add a WMS source

User interaction (20)

Animate 3D buildings based on ambient sounds Disable map rotation Create a draggable Marker Create a draggable point Filter symbols by text input Filter features within map view Filter symbols by toggling a list Display a non-interactive map Change a map's language Measure distances Get coordinates of the mouse pointer Highlight features containing similar data Select features around a clicked point Get features under the mouse pointer Restrict map panning to an area Create a time slider Toggle interactions Highlight features within a bounding box Fit to the bounds of a LineString Create a hover effect

Animate map camera around a point Animate a point along a route Center the map on a clicked symbol Fit a map to a bounding box Slowly fly to a location Fly to a location Navigate the map with game-like controls Jump to a series of locations Play map locations as a slideshow Fly to a location based on scroll position Set pitch and bearing

Controls and overlays (17)

Animate a marker Change the default position for attribution Add custom icons with Markers Disable scroll zoom View a fullscreen map Locate the user Swipe between maps Display driving directions Show drawn polygon area Add a geocoder Add a marker using a place name Display map navigation controls Show polygon information on click Display a popup on click Display a popup on hover Display a popup Attach a popup to a marker instance

Supplement forward geocoding search results from another data source Accept coordinates as input to a geocoder Use a custom render function with a geocoder Limit geocoder results to a named region Place the geocoder input outside the map Use a custom camera animation with a geocoder Localize the geocoder to a given language Set a point after Geocoder result

Browser support (1)

Check for browser support

Internationalization support (2)

Use locally generated ideographs Add support for right-to-left scripts

Create a gradient line using an expression

Use the line-gradient paint property and an expression to visualize distance from the starting point of a line.

Mapbox GL unsupported

Mapbox GL requires WebGL support. Please check that you are using a supported browser and that WebGL is enabled.

<!DOCTYPE html>
<html>
<head>
<meta charset='utf-8' />
<title>Create a gradient line using an expression</title>
<meta name='viewport' content='initial-scale=1,maximum-scale=1,user-scalable=no' />
<script src='https://api.tiles.mapbox.com/mapbox-gl-js/v0.54.0/mapbox-gl.js'></script>
<link href='https://api.tiles.mapbox.com/mapbox-gl-js/v0.54.0/mapbox-gl.css' rel='stylesheet' />
<style>
body { margin:0; padding:0; }
#map { position:absolute; top:0; bottom:0; width:100%; }
</style>
</head>
<body>
 
<div id='map'></div>
 
<script>
mapboxgl.accessToken = '<your access token here>';
 
var map = window.map = new mapboxgl.Map({
container: 'map',
style: 'mapbox://styles/mapbox/light-v10',
center: [-77.035, 38.875],
zoom: 12,
});
 
var geojson = {
"type": "FeatureCollection",
"features": [{
"type": "Feature",
"properties": {},
"geometry": {
"coordinates": [
[-77.044211, 38.852924 ],
[-77.045659, 38.860158 ],
[-77.044232, 38.862326 ],
[-77.040879, 38.865454 ],
[-77.039936, 38.867698 ],
[-77.040338, 38.86943 ],
[-77.04264, 38.872528 ],
[-77.03696, 38.878424 ],
[-77.032309, 38.87937 ],
[-77.030056, 38.880945 ],
[-77.027645, 38.881779 ],
[-77.026946, 38.882645 ],
[-77.026942, 38.885502 ],
[-77.028054, 38.887449 ],
[-77.02806, 38.892088 ],
[-77.03364, 38.892108 ],
[-77.033643, 38.899926 ]
],
"type": "LineString"
}
}]
};
 
map.on('load', function () {
// 'line-gradient' can only be used with GeoJSON sources
// and the source must have the 'lineMetrics' option set to true
map.addSource('line', {
type: 'geojson',
lineMetrics: true,
data: geojson
});
 
// the layer must be of type 'line'
map.addLayer({
type: 'line',
source: 'line',
id: 'line',
paint: {
'line-color': 'red',
'line-width': 14,
// 'line-gradient' must be specified using an expression
// with the special 'line-progress' property
'line-gradient': [
'interpolate',
['linear'],
['line-progress'],
0, "blue",
0.1, "royalblue",
0.3, "cyan",
0.5, "lime",
0.7, "yellow",
1, "red"
]
},
layout: {
'line-cap': 'round',
'line-join': 'round'
}
});
});
 
</script>
 
</body>
</html>