Interactive tools

Mapbox GL JS usage playground

Interact with the map below to understand these three different usage units:

Map loads

Mapbox GL JS v1.0.0+

A map load occurs whenever a Mapbox GL JS Map object is initialized on a webpage and you request a Mapbox-hosted map tile. Additional user interactions, such as panning and zooming, do not incur additional map loads. This means that people who are using your web map can toggle additional sources on and off, interact with the map, and toggle between styles without affecting your usage.

The maximum session length for a map load is 12 hours, meaning a user can have a browser open with continuous map interactions that all count towards the same map load during a consecutive 12 hour window. After 12 hours of continuous map interactions, a new map load is triggered.

Vector Tiles API requests

Mapbox GL JS < v1.0.0

The Mapbox Vector Tiles API serves vector tiles. Each API request results in a single tile from a vector tileset. Vector Tiles API requests are typically made as a series of requests used to render a map using a Mapbox GL map library.

Map views

Deprecated

Map views are a deprecated usage unit that used to be used to track map usage for Mapbox products. For maps using Mapbox GL JS, a map view was equal to four Vector Tiles API tile requests.

Map loads:
1
Vector Tiles API requests:
0
from initial style: 0
from added source: 0
Map views:
0
from initial style: 0
from added source: 0
Options