queryType: getRouteAnalysis*

The getRouteAnalysis queryType is passed to the API to generate popular route(s) for origin-destination pair(s) that were generated by the getOriginDestinationMatrix API.

Note:

See Special Case APIs for more information. This API is subject to tighter rate limit restrictions.

Note that the sample response below contains just one record/one popular route, but your response will contain all the routes observed between the origin / destination pair that meet privacy requirements. All returned metrics shown in the sample response below will be provided for each route returned.

Parameters

These parameters should be passed to the functionParameters object regardless of which method you choose to make an API request.

Note:

For this API request to work, you must run the getOriginDestinationMatrix API request first.


Parameter	Description	Type	Defined Value Set	Value Req'd
queryType	Must equal `getRouteAnalysis`.	STRING	"`getRouteAnalysis`"	Y
excludeServiceRoads	True to exclude service roads, false to include them. Defaults to true.	BOOLEAN	-	N
isMetric	True if you want the data returned to be metric, false if you want imperial.	BOOLEAN	true or false	Y
analysisJobId	When you generate an origin destination matrix from the `getOriginDestinationMatrix` API request, it returns a analysisJobId string in the results, which is passed here.	STRING	-	Y
routeGroupingThreshold	The percent similarity threshold for grouping sub-routes under a main route. e.g., 0.9 means that routes that are 90% similar will be grouped together. (defaults to 0.9 if not provided).	FLOAT	-	Y
zonePairIds	When you generate an origin destination matrix from the `getOriginDestinationMatrix` API request, it returns a ZonePairId string for each origin-destination pair. You can pass an array of ZonePairIds to see the popular routes for each pair.	ARRAY	-	Y

Responses


Code	Type	Description
200	JSON	The requested data.
401	JSON	Occurs for various unauthorized tasks, such as not providing credentials in your parameters.
500	JSON	Occurs if an internal server error occurs. Contact altitudesupport@geotab.com if this occurs.

Response Schema



AsOfDate	The date for which OSM base map version to use. The value is provided in YYYY-MM-DD string format and reflects the first day of the applicable month.	DATE	-
DailyJourneyCountAvg	The average daily number of journeys for the route.	FLOAT	-
DestinationZoneDescription	Description of the origin zone when available. The 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 For all other zones, this attribute is null.	STRING	-
Destination_ISO_3166_2	Unique ISO 3166-2 identifier representing the state/provincial code of the Destination.	STRING	-
DestinationPassThrough	Indicates the passthrough value applied to the destination.	STRING	“true”, “false” or “only”
DestinationZoneType	Zone Type of the Destination.	STRING	-
DestinationZoneId	A unique identifier for the Destination zone.	STRING	-
DurationAtDestinationAvg	The average stop duration at the destination before the next journey (minutes).	FLOAT	-
DurationAtDestinationMed	The median stop duration at the destination before the next journey (minutes).	FLOAT	-
DurationAtDestinationStdev	The standard deviation of the stop duration at the destination before the next journey (minutes).	FLOAT	-
Geography	A GeoJSON string representing the geography of the route.	STRING	-
IdleDurationAvg	The average of the total mid-journey idle duration (minutes). The mid-journey idle duration is calculated as a sum of the mid-trip idle duration of all trips that comprise the journey.	FLOAT	-
IdleDurationMed	The median of the total mid-journey idle duration (minutes). The mid-journey idle duration is calculated as a sum of the mid-trip idle duration of all trips that comprise the journey.	FLOAT	-
IdleDurationStdev	The standard deviation of the total mid-journey idle duration (minutes). The mid-journey idle duration is calculated as a sum of the mid-trip idle duration of all trips that comprise the journey.	FLOAT	-
InterTripStopDurationAvg	The average of the total stop duration that occurs during the journey. The stop duration during a journey is calculated as the sum of all stop durations between trips that comprise a journey.	FLOAT	-
InterTripStopDurationMed	The median of the total stop duration that occurs during the journey. The stop duration during a journey is calculated as the sum of all stop durations between trips that comprise a journey.	FLOAT	-
InterTripStopDurationStdev	The standard deviation of the total stop duration that occurs during the journey. The stop duration during a journey is calculated as the sum of all stop durations between trips that comprise a journey.	FLOAT	-
JourneyCountTotal	Total number of journeys for the O/D pair across all routes.	INTEGER	-
JourneyCount	The number of journeys observed on the route.	INTEGER	-
JourneyCountByIndustry	Array of objects representing journey count metrics for each NAICS code 1. Each object contains: NAICS_Code_1 (integer) — NAICS code 1. JourneyCount (integer) — number of journeys.	ARRAY	-
JourneyCountByVehicleClass	Array of objects representing journey count metrics for each vehicle class. Each object contains: SchemeId (integer) — vehicle class scheme identifier. CategoryIndex (integer) — vehicle class category identifier. VehicleClassIndex (integer) — vehicle class identifier. VehicleClass (string) — vehicle class name. JourneyCount (integer) — number of journeys.	ARRAY	-
JourneyCountByVocation	Array of objects representing journey counts for each vocation. Each object contains: VocationId (integer) — unique identifier for the vocation. Vocation (string) — vocation name. JourneyCount (integer) — number of journeys.	ARRAY	-
JourneyCountPctOfTotal	The percentage of journeys that the route represents as a product of all journeys for the O/D pair.	INTEGER	-
JourneyDistanceAvg	The average distance traveled between an O/D pair (kilometers or miles).	FLOAT	-
JourneyDistanceMed	The median distance traveled between an O/D pair (kilometers or miles).	FLOAT	-
JourneyDistanceStdev	The standard deviation of the distance traveled between the O/D pair (kilometers or miles).	FLOAT	-
JourneyDurationAvg	The average journey duration (minutes) between the O/D pair (in minutes).	FLOAT	-
JourneyDurationMed	The median journey duration (minutes) between the O/D pair (in minutes).	FLOAT	-
JourneyDurationStdev	The standard deviation of the journey duration (minutes) between the O/D pair (in minutes).	FLOAT	-
JourneyTripCountAvg	The average number of trips per journey. If no trip chaining is applied i.e. tripChainDuration is 0, this value will also be 1.	FLOAT	-
JourneyTripCountMed	The median number of trips per journey. If no trip chaining is applied i.e. tripChainDuration is 0, this value will also be 1.	FLOAT	-
JourneyTripCountStdev	The standard deviation of the number of trips per journey.	FLOAT	-
OriginZoneDescription	Description of the origin zone when available. The 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 For all other zones, this attribute is null.	STRING	-
Origin_ISO_3166_2	Unique ISO 3166-2 identifier representing the state/provincial code of the Origin.	STRING	-
OriginPassThrough	Indicates the passthrough value applied to the origin.	STRING	“true”, “false” or “only”
OriginZoneType	Zone type of the Origin.	STRING	-
OriginZoneId	A unique identifier for the Origin zone.	STRING	-
RouteId	Internally generated unique reference ID for the sequence of segments traversed to form the route.	STRING	-
RoadNameSequence	String of all the sequential list of road names corresponding to the ordering of segments in the route. Format “<road name>, <road name>, <roadname>.…”.	STRING	-
RunningSpeedAvg	The average running speed (km/h or mph) for journeys. Running speed is calculated using only the time a vehicle is moving (excluding any time stopped).	FLOAT	-
RunningSpeedMed	The median running speed (km/h or mph) for journeys. Running speed is calculated using only the time a vehicle is moving (excluding any time stopped).	FLOAT	-
RunningSpeedStdev	The standard deviation of running speed (km/h or mph) for journeys. Running speed is calculated using only the time a vehicle is moving (excluding any time stopped).	FLOAT	-
SegmentSequence	String of the sequential segment IDs corresponding to the ordering of segments in the route. Format “<segment ID>, <segment ID>, <segment ID>…”	STRING	-
TravelSpeedAvg	The average travel speed (km/h or mph) for journeys. Travel speed is calculated as the total distance divided by the journey duration.	FLOAT	-
TravelSpeedMed	The median travel speed (km/h or mph) for journeys. Travel speed is calculated as the total distance divided by the journey duration.	FLOAT	-
TravelSpeedStdev	The standard deviation of travel speed (km/h or mph) for journeys. Travel speed is calculated as the total distance divided by the journey duration.	FLOAT	-
Variants	Array of objects representing the variations of the route that are determined to be within the routeGroupingThreshold. Each object contains: VariantId (string) — unique identifier for the variant. RoadNameSequence (string) — string of all the sequential list of road names corresponding to the ordering of segments in the route. Format “<road name>, <road name>, <roadname>…” SegmentSequence (string) — string of the sequential segment IDs corresponding to the ordering of segments in the route. Format “<segment ID>, <segment ID>, <segment ID>…” JourneyCount (integer) — number of journeys observed on the variant FirstSegmentId (string) — the first segmentId in the variant LastSegmentId (string) — the last segmentId in the variant Geography (string) — a GeoJSON string representing the geography of the variant.	ARRAY	-
ZonePairId	Unique identifier representing the O/D pair.	STRING	-

Sample parameters

{
"queryType": "getRouteAnalysis",
"excludeServiceRoads": true,
"isMetric": true,
"analysisJobId": "<analysisJobId from response of getOriginDestinationMatrix API call>",
"routeGroupingThreshold": 0.9,
"zonePairIds": [<ZonePairIdentification value(s) from response of getOriginDestinationMatrix API call>]
}

Altitude

Learn Altitude

Support

queryType: getRouteAnalysis*

Parameters

Responses

Response Schema

Sample parameters

On this page