All docsPlaygroundMapbox GL JS usage playground

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+

Updating from v1.x.x to v2.x.x

The action that triggers a map load changed in Mapbox GL JS v2.0.0. Before updating an existing implementation 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.

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


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.