Isochrone API
Introduction
An isochrone is a line that connects points of equal travel time or distance around a given location. The NextBillion.ai Isochrone API computes areas that are reachable within a specified amount of time from a location, and returns the reachable regions as contours of polygons or lines that you can display on a map. This API also supports contours based on distance.
With the Isochrone API, you can:
- Calculate isochrones up to 40 minutes or 60km with our 4w driving mode.
- Define serviceable or delivery zones based on travel times from a starting location.
Parameters
Loading...Response Schema
Loading...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 sup[email protected] for more details.
Examples
Sample API Request
https://api.nextbillion.io/isochrone/json?mode=4w&coordinates=1.29363713,103.8383112&denoise=1&generalize=250&contours_colors=ff4d4f&contours_meters=5000&key=<Your_API_Key>
Sample API Response
1{
2 "features": [
3 {
4 "properties": {
5 "fill": "#ff4d4f",
6 "fillOpacity": 0.33,
7 "fillColor": "#ff4d4f",
8 "color": "#ff4d4f",
9 "contour": 5,
10 "opacity": 0.33,
11 "metric": "distance"
12 },
13 "geometry": {
14 "coordinates": [
15 [103.850311, 1.325869],
16 [103.839311, 1.320282],
17 [103.83517, 1.323778],
18 [103.835311, 1.318229],
19 [103.826534, 1.32086],
20 [103.826311, 1.323716],
21 [103.822284, 1.321664],
22 [103.823769, 1.317179],
23 [103.814311, 1.313211],
24 [103.815413, 1.306637],
25 [103.810311, 1.30875],
26 [103.807269, 1.304679],
27 [103.811639, 1.298309],
28 [103.802102, 1.298637],
29 [103.804577, 1.293903],
30 [103.801, 1.291637],
31 [103.802311, 1.284798],
32 [103.80687, 1.286196],
33 [103.811285, 1.280637],
34 [103.816634, 1.27996],
35 [103.811779, 1.275637],
36 [103.814311, 1.273519],
37 [103.817711, 1.277037],
38 [103.824311, 1.265183],
39 [103.835311, 1.272225],
40 [103.863311, 1.27038],
41 [103.871311, 1.278514],
42 [103.869311, 1.282673],
43 [103.859928, 1.278637],
44 [103.866622, 1.294637],
45 [103.862766, 1.297637],
46 [103.870779, 1.305637],
47 [103.869261, 1.305688],
48 [103.867311, 1.303957],
49 [103.866509, 1.304637],
50 [103.870223, 1.310637],
51 [103.859311, 1.31374],
52 [103.858311, 1.320365],
53 [103.854536, 1.318862],
54 [103.859227, 1.324637],
55 [103.858311, 1.325078],
56 [103.855311, 1.322137],
57 [103.850311, 1.325869]
58 ],
59 "type": "LineString"
60 },
61 "type": "Feature"
62 }
63 ],
64 "type": "FeatureCollection"
65}
Sample Image
https://api.nextbillion.io/isochrone/json?mode=4w&coordinates=1.29363713,103.8383112&denoise=1&generalize=250&contours_colors=ff4d4f&contours_meters=5000&key=<Your_API_Key>

https://nbval-demo.nextbillion.io/isochrone/json?mode=4w&coordinates=1.29578235,103.81968594&denoise=1&generalize=250&contours_colors=ad6800&contours_minutes=30&key=YOUR_API_KEY

API Error Codes
Response Code | Description | Additional Notes |
---|---|---|
200 | Normal success case. | Normal success case. |
400 | Input validation failed. | Such as missing parameter or parameter with invalid value type (for example value cannot be parsed into number). |
401 | APIKEY not supplied or invalid. | - |
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 there is a malformed host name used. |
422 | Could not process the request. | There is an underlying map issue which prevents the processing of the request. |
429 | Too many requests. | QPM reached or something like distance matrix size quota reached. |
500 | Internal Service error. | There was an internal issue with Nextbillion.ai services. You can reach out to [email protected] for an explanation. |