Drive Time Polygons

The INRIX Drive Time Polygons provides information on the time is takes to travel to or from a particular location based on typical traffic conditions.

Overview

The main usage scenarios for drive time polygons are:

- A potential home buyer can find houses where the typical commute time is less than a certain time to or from their office in the morning or evening. For example, I want to find properties within 15 minutes of my work location arriving at work at 8:00 am. 

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>

Documentation

TRAFFIC