get
/api/v2/regional-travel-metrics/vehicle-distance-traveled/{id}Python SDK method:
client.rtm.vdt(id=job_id).results()Get vehicle distance traveled results
Returns paginated vehicle distance traveled rows for a completed VDT job. Each row represents aggregated distance statistics for one zone.
Altitude Help Center — getVehicleDistanceTraveledInput Parameters
| Name | Location | Type | Values | Description | Value Required |
|---|---|---|---|---|---|
id | path | string | - | Unique resource identifier. | Y |
pageToken | query | string | - | Pagination token returned in the Link header of a previous response. Omit to fetch the first page. | N |
Success Responses
200 response: object
Paginated result data. When more pages are available, a Link: rel="next" header and Altitude-* pagination headers are included in the response.
| Name | Type | Description |
|---|---|---|
distance | number (double) | The distance traveled by all the vehicles in the analysis (miles or kilometers). |
distanceByFleetSize | array<object> | Array of objects representing the distance, trip count and vehicle counts for each fleet size bucket. |
distanceByFuelType | array<object> | Array of objects representing the distance, trip count and vehicle counts for each fuel type. |
distanceByIndustry | array<object> | Array of objects representing the distance, trip count and vehicle counts for each NAICS code 1. |
distanceByRoadType | array<object> | Array of objects representing the distance, trip count and vehicle counts for each road type. |
distanceByVehicleClass | array<object> | Array of objects representing the distance, trip count and vehicle counts for each vehicle class. |
distanceByVehicleYear | array<object> | Array of objects representing the distance, trip count and vehicle counts for each vehicle year bucket. |
distanceByVocation | array<object> | Array of objects representing the distance, trip count and vehicle counts for each vocation. |
iso_3166_2 | string | The ISO 3166:2 code of the zone. |
tripCount | integer (int64) | The total number of trips in the zone. |
tripCountTotal | integer (int64) | The total number of trips in the analysis. |
vehicleCount | integer (int64) | The total number of unique vehicles in the analysis. |
vehicleCountTotal | integer (int64) | The total number of unique vehicles in the analysis. |
zoneCode | string | Raw zone code. |
zoneId | string | The zone id for which the data is returned. |
zoneName | string | Description of the zone when available. The value is based on the type of zone: 'State' — state name, 'County' — county name, 'City' — city name, 'CTR' — census tract description, 'Segment' — road name if available, 'Custom' — custom zone name. |
zoneType | string | The zone type of the zone. |
Response Errors
| HTTP Status Code | Reason |
|---|---|
| 400 | The request body or parameters are invalid. |
| 401 | Authentication is required or the provided credentials are invalid. |
| 403 | The authenticated user lacks permission to perform this operation. |
| 404 | The requested resource does not exist. |
| 409 | Result not yet ready. Poll the status monitor. |
| 429 | The request rate limit has been exceeded. |
| 500 | An unexpected server error occurred. |
