Static Images API
The Static Images API serves standalone, static map images generated from NextBillion.ai styles. These images can be displayed on web and mobile devices without the aid of a mapping library or API. They look like an embedded map, but do not have interactivity or controls.
Center-based image
1https:/maps/{mapId}/static/{lat},{lon},{zoom}/{width}x{height}{scale}.{format}
Generates a raster image based on the specified center and zoom level.
Path Parameters
Loading...Query Parameters
Loading...API Error Codes
Loading...Example
1https:/maps/hybrid/static/33.93,-118.12,9/512x512.png?key=Your_API_Key
Sample Image

Bounds-based image
Generates a raster image based on the given bounds.
1https:/maps/{mapId}/static/{miny},{minx},{maxy},{maxx}/{width}x{height}{scale}.{format}
Path Parameters
Loading...Query Parameters
Loading...API Error Codes
Loading...Example
1https:/maps/hybrid/static/-11.54,34.1,23.6,52.96/512x512.png?key=Your_API_Key
Sample Image

Auto-fitted image
Generates a raster image based on the given features. The area is calculated so that all the paths and markers given in query are visible.
1https:/maps/{mapId}/static/auto/{width}x{height}{scale}.{format}
Path Parameters
Loading...Query Parameters
Loading...API Error Codes
Loading...Example
https:/maps/streets/static/auto/512x512.png?path=stroke:green|width:3|fill:none|5.9,45.8|5.9,47.8|10.5,47.8|10.5,45.8|5.9,45.8&key=Your_API_Key
Sample Image

Vector tiles