Regional Travel Metrics API Overview
The Altitude Regional Travel Metrics module allows users to understand basic vehicle characteristics and the observed vehicle distance traveled for a geography of interest.
This API uses the queryType parameter to retrieve data. Request information in the API call, such as Demand Generation or Vehicle Distance Traveled, and it returns that specific set of results. Each query type is a distinct request.
Basic Information
| serviceName | “dna-altitude-rtm” |
| functionName | One of “createQueryJob”, “cancelQueryJob”, “getJobStatus”, or “getQueryResults”, as outlined here. |
Error Codes
If the API fails, the possible responses for all queryTypes could be one of the following:
| HTTP Status Code | Response Type | Description |
|---|---|---|
| 400 | JSON | Occurs if your API request is a bad request e.g. invalid JSON, invalid queryType, invalid parameter type (e.g. string instead of integer), etc. |
| 401 | JSON | Occurs for various unauthorized tasks e.g. if you didn’t provide credentials in your parameters. |
| 403 | JSON | Occurs for various forbidden tasks e.g. if you have requested data that you have not purchased. |
| 408 | JSON | Occurs if the API call exceeds 10 minutes and times out. |
| 429 | JSON | Occurs if you have exceeded your rate limit. |
| 500 | JSON | Occurs if an internal server error occurs. Contact altitudesupport@geotab.com if this occurs. |