Satellite Image Tiles API

The Maps Raster Satellite Tile API delivers satellite map data in square, gridded sections known as tiles, each measuring 256 x 256 pixels. These tiles are available across 20 distinct zoom levels, from 0 to 19. At zoom level 0, the entire Earth is displayed on a single tile, whereas at zoom level 19, the world is divided into 238 tiles.

To get the Satellite tiles use the following endpoint:

GET

https://api.nextbillion.io/tt/map/{versionNumber}/tile/{layer}/{style}/{z}/{x}/{y}.{format}?key={Your_API_Key}

Path Parameters

Name	Required	Format & Usage	Description
version_number	Yes	Type: integer Allowed Values: `1`	Specify the version of the API service to be called. Current value is 1.
layer	Yes	Type: string Allowed Values: `sat`	Layer of the tile to be rendered.
style	Yes	Type: string Allowed Values: `main`	Style of the tile to be rendered.
z	Yes	Type: integer Minimum Value: 0 Maximum Value: 19	Zoom level of the tile to be rendered. The values should be in the range of [0,19].
x	Yes	Type: integer Maximum Value: 2^z-1	Specify the x-coordinate of the tile or the tile’s column on the zoom grid `z`. The maximum value should be less than 2^z.
y	Yes	Type: integer Maximum Value: 2^z-1	Specify the y-coordinate of the tile or the tile’s row on the zoom grid `z`. The maximum value should be less than 2^z.
format	Yes	Type: string Allowed Values: `jpg`	The format of the response.

Request Parameters

Name	Required	Format & Usage	Description
key	Yes	Type: string Format: 32 character alphanumeric string Example: key=API_KEY	A key is a unique identifier that is required to authenticate a request to the API.

Sample Request

1
curl --location 'https://api.nextbillion.io/tt/map/1/tile/sat/main/12/2929/1898.jpg?key=your_api_key'

API Query Limits

NextBillion.ai allows a maximum rate limit of 6000 queries per minute or 100 queries/second for continuous requests.
Note: We can increase the quota if needed, on request. Contact support@nextbillion.ai for more details.

API Error Codes

Response code	Description	Additional notes
200	Normal success case.	Normal success case.
400	Input validation failed.	There is a missing or an invalid parameter or a parameter with an invalid value type is added to the request.
401	APIKEY not supplied or invalid	This error occurs when the wrong API key is passed in the request or the key is missing altogether.
403	APIKEY is valid but does not have access to requested resources	You might be querying for a geographical region which is not valid for your account or requesting a service which is not enabled for you.
404	Requested host/path not found	This error occurs when a malformed hostname is used.
422	Could not process the request	A feasible solution could not be generated for the given set of locations or parameter configuration.
429	Too many requests	QPM reached or API request count quota reached.
500	Internal Service error.	There was an internal issue with NextBillion.ai services. You can reach out to support@nextbillion.ai for an explanation.