Traffic Incidents API
Introduction
NextBillion.ai’s Traffic Incidents API provides users with detailed information about the traffic related incidents within a specified geographic area. The service provides users with a list of all incidents/road closures and their associated properties like - cause of incident, impacted roads, severity and probability of incident, start-end times for scheduled or planned closures and the impact on travel time or delays caused by a given incident. The service allows users to search for incidents in a given bounding box area along with other classifying inputs like - specific incident types or timings to receive all desired incident details.
GET
Request Parameters
Loading..Response Schema
Loading..Sample Request
Sample Response
API Query Limits
- The maximum area of
bboxthat can be specified is 50000m (50 km²). - The maximum number of IDs that can be provided for the
idinput list is 5. - 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. |