Style Specification

Examples

Add a generated icon to the map Add an icon to the map Display a map with a custom style Display a satellite map Change a map's style Display a map

Display buildings in 3D 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 Create and style clusters Change a layer's color with buttons Add a custom style layer Style circles with a data-driven property Style lines with a data-driven property Display and style rich text labels Add a new layer below labels Add a GeoJSON line Draw GeoJSON points Add a GeoJSON polygon Create a heatmap layer Add hillshading Create a gradient line using an expression Add multiple geometries from one GeoJSON source Style ocean depth data Show and hide layers Change worldview of administrative boundaries Update a choropleth layer by zoom level Visualize population density

Join local JSON data with vector tile geometries Add an image 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 Add live realtime data

User interaction (20)

Animate 3D buildings based on ambient sounds Disable map rotation Create a draggable Marker Create a draggable point Filter features within map view Filter symbols by text input Filter symbols by toggling a list Create a hover effect Display a non-interactive map 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 Change a map's language

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 Limit geocoder results to a named region Supplement geocoding search results from another data source Place the geocoder input outside the map Bias geocoder results around the map view 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

Locate the user

Geolocate the user and then track their current location on the map using the GeolocateControl.

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>Locate the user</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.53.0/mapbox-gl.js'></script>
<link href='https://api.tiles.mapbox.com/mapbox-gl-js/v0.53.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 = new mapboxgl.Map({
container: 'map', // container id
style: 'mapbox://styles/mapbox/streets-v9',
center: [-96, 37.8], // starting position
zoom: 3 // starting zoom
});
 
// Add geolocate control to the map.
map.addControl(new mapboxgl.GeolocateControl({
positionOptions: {
enableHighAccuracy: true
},
trackUserLocation: true
}));
</script>
 
</body>
</html>