Analysis Partial Trips Result

Important Note
Explore ready-to-use traffic reports and data visualizations immediately by signing up for a 30-day free trial on the MOVE Portal. Once registered, you'll receive an API key to start using the Traffic Analytics APIs right away. Alternatively, you may contact our Sales team for a tailored solution.

Purpose

Get a partial trips result by sending a POST request.

Request data

HTTPS Method: POST

For ease of viewing and identification:

• Constants and parameters enclosed in curly brackets { } must be replaced with their values.
• Please see the following Request parameters section with the required and optional parameters tables for their values. The generic request format is as follows.

Format

https://{baseURL}/origindestination/{versionNumber}/analysis/flowmatrix/{id}/result/partial/trips?key={Your_API_Key}&dateRange={dateRange}&timeRange={timeRange}

Example

https://api.tomtom.com/origindestination/1/analysis/flowmatrix/123/result/partial/trips?key={Your_API_Key}&dateRange=0&timeRange=0

Required parameters

Required POST headers

Request POST body example

1{
2  "origins": [0, 1, 2, 3],
3  "destinations": [4, 5, 6, 7, 8],
4  "vias": [10]
5}

Request POST body stucture

Response data

This response will return information about the number of trips which started at a given origin, went through given vias, and ended in given origins. The following table describes all of the fields that can appear in a response. External region is indexed as the last one and is equal to the number of defined regions (there is no External region for the passMatrix enabled option)

Response example

1{
2  "links": [[0,0,0,100], [0,1,1,200], ...]
3}

The result contains a list of 'links'. Each link contains information about trips between regions and looks like this:
[0,0,0,100] - [Origin region index (number), Destination region index (number), Via region index (number), Amount of trips (number)]

Response structure

Errors

If there is an error in the supplied parameters or any other internal problem, an error response is generated in the requested format.

Response codes