Mapbox GL JS usage playground
Interact with the map below to understand these three different usage units:
Mapbox GL JS v1.0.0+
The action that triggers a map load changed in Mapbox GL JS v2.0.0. Before updating an existing implemenation from v1.x.x to v2.x.x, please review our pricing documentation to estimate expected costs.
A map load occurs whenever a Mapbox GL JS
Map object is initialized. 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.
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 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.