Skip to main content

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-v12/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:

Was this page helpful?