Vector Tiles API v2

Introduction

Vector Tiles API is a service to fetch interactive map-tiles from NextBillion.ai’s vector tile set. 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.

Fetch Vector Tile Rendering Styles

Use this endpoint to fetch style specifications for rendering map tiles using common libraries such as nbmap-gl , maplibre-gl or mapbox-gl-js

GET

https://tileria.nextbillion.io/maps/{map-id}/style.json?key={your_api_key}

Request Parameters

Loading..

Response Schema

The response of this endpoint is a JSON file which follows the standard Maplibre GL style and Mapbox GL style structures. Please refer to the linked sources for more information.

The JSON response is compatible with nbmap-gl, maplibre-gl-js and mapbox-gl-js, also including native Android, iOS Map SDKs by NextBillion.ai.

Sample Query

1
curl --location 'https://tileria.nextbillion.io/maps/v1/style.json?key=<your_api_key>'

Fetch Vector Tile Definitions

The tile definitions are generally automatically loaded by the map libraries. The following endpoint however, is useful in case the definitions need to be fetched exclusively. Upon making a successful request the tile definitions are returned in the response.

GET

https://tileria.nextbillion.io/maps/{map-id}/tiles.json?key={your_api_key}

Request Parameters

Loading..

Response Schema

The response for this endpoint is a JSON file which follows the standard Mapbox Vector Tiles schema. Please refer to the linked sources for more information.

The JSON response is compatible with nbmap-gl, maplibre-gl-js and mapbox-gl-js, also including native Android, iOS Map SDKs by NextBillion.ai.

Sample Query

1
curl --location 'https://tileria.nextbillion.io/maps/v1/tiles.json?key=<your_api_key>'

Fetch Vector Tile information

This endpoint returns the requested tiles data in protobuf format (.pbf). The .pbf response then can be rendered to display the map tile using common map libraries or any GIS software.

GET

https://tileria.nextbillion.io/maps/{map-id}/tiles/{z}/{x}/{y}.pbf?key={your_api_key}

Request Parameters

Loading..

Response Schema

The response from this endpoint follows the protobuf format. Consume the .pbf through common map libraries or a GIS software to display the map tile on any web or mobile application.

Sample Query

1
curl --location 'https://tileria.nextbillion.io/maps/v1/tiles/9/408/264.pbf?key=<your_api_key>'

© 2025 NextBillion.ai all rights reserved.