Date/Time Routing

Date/Time Routing gives the user the ability to specify the time and date of a route, thus compensating for lanes that are HOV at specific times, timed-turned restrictions, and seasonal or specific day of the week closures.

Date/Time Parameters

Name Description
timeType
Integer
Specifies the time type to use. Acceptable values are:
  • 0 - None (No date/time options will be used)
  • 1 - Current (Uses the current date/time when generating a route.)
  • 2 - Start At (May specify a specific date/time or day of the week to use when generating a route.)
Default timeType value is 0.
dateType
Integer
Specifies the date type to use. If timeType is 0 or 1, this option will be ignored. Acceptable values are:
  • 0 - Specific Date & Time
  • 1 - Sunday
  • 2 - Monday
  • 3 - Tuesday
  • 4 - Wednesday
  • 5 - Thursday
  • 6 - Friday
  • 7 - Saturday
Default dateType value is 0.
date The format for date is MM/DD/YYYY. If timeType is 0 or 1, or if dateType is 1-7, this option will be ignored.

If dateType is 0 and isoLocal is null, this parameter must be used. MM specifies the month of year. Acceptable values are:
  • 01 - January
  • 02 - February
  • 03 - March
  • 04 - April
  • 05 - May
  • 06 - June
  • 07 - July
  • 08 - August
  • 09 - September
  • 10 - October
  • 11 - November
  • 12 - December
DD specifies the day of the month. Acceptable values are 01-31.

YYYY specifies the year. Values need to be entered in YYYY format.

Default date value is the current date.

Please note that the user has the choice of entering date/time in the ISO 8601 format YYYY-MM-DDThh:mm or as a calendar date (MM/DD/YYYY) and local time (hh:mm) by using the date and localTime fields, respectively.
localTime
Integer
If timeType is 0 or 1 ,this option will be ignored.

If dateType is 0 and isoLocal is null, this parameter must be used.

If dateType is 1-7, this parameter can be used to set a specific time of day to generate a route.

Values need to be entered in hh:mm format. Default localTime value is the current time.

Please note that the user has the choice of entering date/time in the ISO 8601 format YYYY-MM-DDThh:mm or as a calendar date (MM/DD/YYYY) and local time (hh:mm) by using the date and localTime fields, respectively.
isoLocal If timeType is 0 or 1, or if dateType is 1-7, this option will be ignored.

If dateType is 0, this is an optional parameter.

The user has the choice of entering the date/time in the ISO 8601 format YYYY-MM-DDThh:mm or as individual parameters by using the month, day, year, and localTime fields.

Default isoLocal value is the current date and time.


  © MapQuest, Inc. All rights reserved.    Privacy Policy | Terms of Use