Vector Tiles API
Introduction
The Vector Tiles API serves vector tiles from NextBillion.ai’s vector tile sets. A vector tile contains the vector data about the geometries and metadata - like road names, place names etc in the form of points, lines and polygons. These tiles can be used as a source for styling or for creating an interactive map experience for your users.
GET
https://api.nextbillion.io/tiles/{tilesId}/{z}/{x}/{y}.{format}?key={your_api_key}
Request Parameters
Query Parameter
Loading..Sample Request
curl --location 'https://api.nextbillion.io/tiles/v3/12/2929/1898.pbf?key=<your_api_key>'Sample Response
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. |
| 414 | Request is too long | This error occurs when the URI is too long. Maximum allowed length is 8192 bytes. |
| 422 | Could not process the request | The requested tiles were not found. Please check the input request. Reach out to support@nextbillion.ai if the issue persists. |
| 429 | Too many requests | QPM limit or API usage 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. |
