INRIX documentation logo

The INRIX Drive Time Polygons provides information on

Overview

The main usage scenarios for drive time polygons are:

- 

Description: Retrieves the polygons that specify how far someone can travel within specified durations on a given day and time. The polygons are based on typical traffic patterns.

/?Action=GetDriveTimePolygons

GET Retrieves the polygons that specify how far someone can travel in specified durations.

Parameters

  = required
Name Located In Type Description
action Query String Use GetDriveTimePolygons
token Query String A valid authorization token returned in response to a GetSecurityToken request.
Center Query String The center of the region in which to get data. This parameter must be specified as a pair of latitude and longitude values separated by a pipe character (|), in the form Center=”latitude|longitude”. Northern latitudes are positive and southern latitudes are negative. Eastern hemisphere longitudes are positive and western hemisphere longitudes are negative. Longitudes in North America are negative. The latitude and longitude values are expressed using the WGS 84 datum.
RangeType Query String Indicates whether the request should return the range of locations that you can Arrive from at the Point at the specified Time, or the range of locations could reach if you Depart at the Point specified. The possible values are A (for Arrival) or D (for Departure). The default is A.
Value Description
A (default) Arrival
D Departure
Duration Query String A comma delimited list of travel durations in minutes for travel times to either commute to or from the Point. For example, a value of 30,60,90 would return polygons which are 30, 60 and 90 minutes away from the Point. The default is 30 minutes. The maximum value for duration is 90 minutes and minimum duration is 5 minutes. No fractional portions of a minute are allowed.
DateTime Query String The date and time that the polygon should be calculated for. If the RangeType is set to Arrival, this is the arrival time and if RangeType is set to Departure, this is the departure time. All times should be in UTC or have the timezone offset as specified in DateTime Values. The date specified indicates the day of the week to specify the polygons for.
Criteria Query String Any avoidance criteria which should be considered in calculating the Range. Possible criteria are Ferries (F), and TollRoads (T), to specify avoidance of ferries and toll roads respectively. Specify the first letter of the criteria or multiples in a comma separated list (F,T). The default is to not avoid ferries and toll roads.

Notes

GetDriveTimePolygons returns polygons based on typical traffic on a given day and time. For scenarios where typical rush hour traffic is desired, it is best to calculate polygons using Tuesday 8:15 AM as the arrival time and Thursday 5:00 PM as the departure time. Also, it is best to use a date that is a couple of weeks out in the future.


Requests

Example GetDriveTimePolygons request
Query
http://{serverPath}?Action=GetDriveTimePolygons&Center=47.64362|-122.205098&RangeType=A&Duration=60,90&DateTime=2013-08-16T18:28:55Z&Token={token}

Responses

200 Success
<Inrix docType="GetDriveTimePolygons" copyright="Copyright INRIX Inc."
    versionNumber="4.6" createdDate="2013-05-24T22:33:12Z"
    statusId="0" statusText="" responseId="bd121f13-1fa5-4ece-a346-6c1ba4eecf4d">
  <Polygons>
    <DriveTime duration="90">
      <Polygon xmlns="http://www.opengis.net/gml">
        <exterior>
          <LinearRing>
            <posList>48.4761643409729 -122.326626777649 48.2925081253052 -122.195541858673 ...</posList>
          </LinearRing>
        </exterior>
      </Polygon>
    </DriveTime>
    <DriveTime duration="60">
      <Polygon xmlns="http://www.opengis.net/gml">
        <exterior>
          <LinearRing>
            <posList>47.9535841941834 -122.264077663422 48.1906700134277 -122.205605506897 ...</posList>
          </LinearRing>
        </exterior>
      </Polygon>
    </DriveTime>
  </Polygons>
</Inrix>