Response

KeyTypeOptionalDescription
traffic_windowsarray of traffic_window objects
N
Represents the traffic windows. A separate travel time estimate is provided for each traffic window.
travel_costs
travel_costs object
N
Represents the travel distance (in meters) and costs (in seconds) of traveling from one location to another.
locations
Array of objects (location_id, time zone)
N
Each entry gives a (location_id, time zone) pair with time zone names from https://www.iana.org/time-zones .
statusstring
N
“Ok” indicates success. In other cases, a JSON object will be returned describing the error or inconsistency in the request.

traffic_window

Note that traffic windows and travel costs are fully explained via an example.

KeyTypeOptionalDescription
traffic_window_start_times
Array of strings
NThe start local times of this traffic window in “HH:MM:SS” format. Note that if our algorithms determine that traffic is roughly equivalent in two disjoint time intervals, we use a single traffic window with multiple start and end times to represent this.
traffic_window_end_times
Array of strings
NSee above
traffic_window_indexintNThe index of the traffic window.

Traffic Window Reference

This table lists all traffic windows currently in use in North America. Note that traffic window 0 corresponds to two time segments: very early in the morning and very late in the evening. These are times when MARE expects abnormal traffic. These traffic windows are subject to change as more historical traffic data becomes available, and they may differ by region.

Traffic WindowStart TimeEnd Time
000:00:00
19:00:00
06:30:00
00:00:00
106:30:0007:30:00
207:30:0008:30:00
308:30:0009:30:00
409:30:0016:00:00
516:00:00
17:00:00
617:00:0018:00:00
718:00:0019:00:00

travel_costs

ValueTypeOptionalDescription
source location_id keystringNThe top level string corresponds to the location_id passed as input in the request. Here the corresponding location is the source.
destination location_id keyarray of objects
NEach entry in the array corresponds to a destination location and the travel costs from the source location to this destination. Each destination object has an array containing the following information by position (starting from 0):

0: The distance in meters from the source to this destination.

1: The travel time in seconds from the source to this destination. This corresponds to the travel time in traffic window 0.

2: The travel time in seconds from the source to this destination. This corresponds to the travel time in traffic window 1.



k: The travel time in seconds from the sources to this destination. This corresponds to the travel time in traffic window k-1.