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://api.nextbillion.io/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

Query Parameters

API Error Codes

Example

1https://api.nextbillion.io/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://api.nextbillion.io/maps/{mapId}/static/{miny},{minx},{maxy},{maxx}/{width}x{height}{scale}.{format}

Path Parameters

Query Parameters

API Error Codes

Example

1https://api.nextbillion.io/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://api.nextbillion.io/maps/{mapId}/static/auto/{width}x{height}{scale}.{format}

Path Parameters

Query Parameters

API Error Codes

Example

https://api.nextbillion.io/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