Road Segments API

Introduction

The Road Segments API from NextBillion.ai provides users with detailed information on all road segments within a specified geographic area. The service provides users with a list of all road segments, their shapes, midpoints, and associated driving attributes, including maximum speed and direction of travel. Users can define either a circular or bounding box area by providing simple inputs to receive this information.

Request Parameters

Request Body

Response Schema

Sample Request

1
curl --location 'https://sgpstg.nextbillion.io/map/segments?key=<your_api_key>' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
    "type": "circle",
5
    "circle": {
6
        "center": {
7
            "lat": 1.3132272656379491,
8
            "lon": 103.82278560368337
9
        },
10
        "radius": 100
11
    }
12
}'

Sample Response

1
{
2
   "code": "Ok",  
3
   "message": "",  
4
   "segments": "[...]"  
5
}

API Query Limits

1. The maximum value that can be specified for the radius is 50000m (50 km).
2. The maximum diagonal length of the configured bounding box should be less than 100,000m (100km).
3. 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 [email protected] for more details.

API Error Codes