Glossary

Static Images API

The Mapbox Static Images API allows you to generate a standalone, static image of a map generated from a Mapbox GL-based style. This means you can add a map to your website or blog without JavaScript or plugins. Static Images API usage is measured in API requests (one request for each image).

  • For styles that contain vector layers, the returned static map will be a PNG.
  • For styles that contain raster layers, the returned static map will be a JPEG.

A sample Static Images API request looks like:

https://api.mapbox.com/styles/v1/mapbox/streets-v11/static/-122.4241,37.78,14.25,0,60/600x600?access_token=YOUR_MAPBOX_ACCESS_TOKEN

The Static Images API has optional parameters that can be used to refine the results of a request.

Related resources:

Legacy Static Images API

If you're working with classic styles, you are using the Legacy Static Images API. For details, see the documentation for the Legacy Static Images API .

Was this page helpful?