Skip to main content

Static Images API Playground

The Mapbox Static Images API can generate an image of a map zoomed in on a specific location.

For example, a real estate app could use static images generated by this API to show users the immediate area around real estate listings. Since no interactivity is required, a static map is ideal as it loads faster and consumes fewer client and network resources.

These images are displayed as either a PNG or JPEG, allowing for more efficiency on web and mobile apps versus loading an interactive map.

In the playground below, you can experiment with the map center, zoom level, image size, etc. The resulting API call is an image URL which can be used the same way as any hosted image in a web or mobile app.

PLAYGROUND
Location Helper

To experiment with the camera pitch, bearing, tilt, and zoom and get values to use in your code, try our Location Helper tool.

Static Images API Playground
Parameters
from your account page
in pixels
in pixels
zoom level
Optional parameters
rotate map
tilt map
add a marker, path, or GeoJSON
render map at 2x scale
style parameterschange map style at render time
Move and zoom the map to fit it in the frame
Request URL
GET: https://api.mapbox.com/styles/v1/{username}/{style_id}/static/{overlay}/{lon},{lat},{zoom},{bearing},{pitch}|{auto}|{bbox}/{width}x{height}{padding}{@2x}
Was this playground helpful?