|traffic_windows||array 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 .|
|status||string||N||“Ok” indicates success. In other cases, a JSON object will be returned describing the error or inconsistency in the request.|
Note that traffic windows and travel costs are fully explained via an example.
|traffic_window_start_times||Array of strings||N||The 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||N||See above|
|traffic_window_index||int||N||The 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 Window||Start Time||End Time|
|source location_id key||string||N||The top level string corresponds to the location_id passed as input in the request. Here the corresponding location is the source.|
|destination location_id key||array of objects||N||Each 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.