queryType: getModeledAADT*

The getModeledAADT queryType is passed to the API to get modeled segment-level market AADT for segments related to the input geospatial zone context.

Parameters

ParameterDescriptionTypeDefined Value SetValue Required
queryTypeMust equal "getModeledAADT".STRING"getModeledAADT"Y
isDirectionalIndicates whether AADT should be returned per direction of a road segment (true) or consolidated for the road segment as a whole (false). The default value is false.BOOLEANtrue or falseY
roadTypesAn array of strings representing the different road types for which you want data. An empty array means all available road types.ARRAY"motorway", "trunk", "primary", "secondary", "tertiary"N
year
The year for which you would like AADT values.
Note:

AADT is available at a segment level for 2022, 2023, 2024, and 2025.

INTEGER[2022:2025]Y
zones

An array of objects representing the zones for which you want information. Each object contains ZoneId, ISO_3166_2, and ZoneType:

  • ZoneId (string) – A custom zone ID, a segment ID, a related road ID or a standard zone ID such as county ID, city ID, etc.

  • ISO_3166_2 (string) – The ISO code of the standard zone. Does not apply to custom zones, segments or related roads and can be set to null.

  • ZoneType (string) – the type of zone.
    Note:

    Restricted to USA zones only.

ARRAYZoneType - "State", "County", "City", "TAZ", "CTR", "ZIP", "FSA", "Segment", "Custom". See Zones for details on how to structure the zone inputs for each zone type.Y

Response Schema

AttributeDescriptionData TypeDefined Value Set
AADTbyVehicleGroup

Array of objects representing the AADT of each vehicle group. Each object contains:

  • VehicleGroup (string) - vehicle group name.

  • AADT (integer) - estimated annual average daily traffic value.

  • PredictionIntervalLower (integer) - the lower bound of the relative prediction interval for the AADT value.

  • PredictionIntervalUpper (integer) - the upper bound of the relative prediction interval for the AADT value.

  • EstimateMethod (string) - indicates whether the value is based on observed ground truth (observed) or projected ground truth (projected).

Note:

The prediction interval defines the range within which the true AADT value falls with 90% confidence. The bounds are relative to the estimated AADT value (% of AADT).

ARRAY

VehicleGroup -

Universal: All Geotab vs. market, including both commercial and non-commercial vehicles.

Heavy: GVWR 6-8 vs. equivalent commercial market.

Medium: GVWR 3-5 vs. equivalent commercial market.

EstimateMethod - "observed", "projected"

CardinalDirectionThe direction of the road segment in terms of "N", "NE", "E", etc.STRING["N", "NE", "E", "SE", "S", "SW", "W", "NW"]
Direction
The direction of travel of the road segment, either 1 or -1.
Note:

For non-directional analysis (isDirectional = FALSE), 0 will be populated for this value.

INTEGER1,-1, or 0
ISO_3166_2The ISO 3166:2 code of the zone.STRING-
RoadTypeThe road type of the returned data as defined by OSM.STRING"motorway", "trunk", "primary", "secondary", "tertiary"
SegmentIdSegment ID (also known as a Geotab edge ID, that results from breaking down OSM ways into smaller road segments) or unique identifier for the segment.STRING-
YearThe year of applicability for the AADT value.INTEGER-
ZoneDescription

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

STRING-
ZoneIdThe zone ID for which the data is returned.STRING-
ZoneTypeThe zone type of the zone.STRING"State", "County", "City", "CTR", "ZIP", "TAZ", "Custom"
Note:

MAPE and RSquared performance metrics are no longer returned in the API response. Customers can request AADT performance metrics for a specific area of interest (AOI) and road type from the Solutions Engineering team.

Sample parameters

{
	"isDirectional": false,
	"queryType": "getModeledAADT",
	"roadTypes": [],
	"year": 2025,
	"zones": [
		{
			"ZoneId": "<ZoneId>",
			"ISO_3166_2": "<ISO_3166_2>",
			"ZoneType": "<ZoneType>"
		}
	]
}