• HAST 00:20
  • AKDT 02:20
  • PDT 03:20
  • MDT 04:20
  • CDT 05:20
  • EDT 06:20
  • UTC 10:20

TAFs Examples

The examples are organized by constraint type. Select a constraint type from the list below to jump to a particular section.

Station String

Parameter(s) Allowed Values Example(s)
stationString
  • ICAO station ID using the four-letter specification
  • delimited by white spaces and/or commas (,)

Obtain all available TAFs for KDEN, KSEA and PHNL

stationString=KDEN KSEA,PHNL

stationString using partial ICAO ID

Obtain TAFs for KSEA and all ICAO IDs beginning with KDE (i.e. KDEN, KDEH, KDEW, ...etc.)

stationString=KSEA, KDE

stationString using partial ICAO ID and wildcard (*)

Equivalent to above, obtain TAFs for KSEA and all ICAO IDs beginning with KDE

stationString=KSEA KDE*

Time Range

Parameter(s) Allowed Values Example(s)
startTime, endTime, timeType (optional)
  • start and end times in seconds since January 1, 1970 (Unix time)
  • timeType = issue or valid (default)

Obtain all TAFs for KORD for issue times between these start and end times

startTime=1337242856&endTime=1337250056&timeType=issue &stationString=KORD

startTime, endTime, timeType (optional) Same as above

Obtain all TAFs for KORD for valid times between these start and end times

startTime=1337242856&endTime=1337250056&timeType=valid &stationString=KORD

startTime, endTime, timeType (optional)
  • start and end times in ISO8601 date/time format
  • timeType = issue or valid (default)

Obtain all TAFs for KMIA collected for issue times between these start and end times in ISO8601 date/time format using UTC offset: YYYY-MM-DDThh:mm:ssZ. Please refer to W3C date/time formats.

startTime=2012-05-17T08:20:56Z&endTime=2012-05-17T10:20:56Z&timeType=issue&stationString=KMIA

startTime, endTime, timeType (optional) Same as above

Obtain all TAFs for station KORD with valid times between these start and end times in ISO8601 date/time format with UTC time offset: YYYY-MM-DDThh:mm:ssZ. Please refer to W3C date/time formats.

startTime=2012-05-17T08:20:56Z&endTime=2012-05-17T10:20:56Z&timeType=valid&stationString=KORD

startTime, endTime, timeType (optional) Same as above

Obtain all TAFs for KORD with issue times between these start and end times in ISO8601 date/time format using local offset: YYYY-MM-DDThh:mm:ss+hhmm or YYYY-MM-DDThh:mm:ss-hhmm. Please refer to W3C date/time formats.

startTime=2012-05-17T08:20:56+0000&endTime=2012-05-17T10:20:56+0000&timeType=issue&stationString=KORD

Note: Due to differences in character encodings by various web browsers, the + might get encoded to a whitespace. To avoid this from occurring, use %2B in place of the +.

startTime, endTime, timeType (optional) Same as above

Obtain all TAFs for KORD for valid times between these start and end times in ISO8601 date/time format using local offset: YYYY-MM-DDThh:mm:ss+hhmm or YYYY-MM-DDThh:mm:ss-hhmm. Please refer to W3C date/time formats.

startTime=2012-05-17T08:20:56+0000&endTime=2012-05-17T10:20:56+0000&timeType=valid&stationString=KORD

Note: Due to differences in character encodings by various web browsers, the + might get encoded to a whitespace. To avoid this from occurring, use %2B in place of the +.

hoursBeforeNow, timeType (optional)
  • any positive integer or floating point value
  • n = number of hours before current time
  • timeType = issue or valid (default)

Obtain all TAFs in the last three hours based on issue time for KDEN

stationString=KDEN&hoursBeforeNow=3&timeType=issue

hoursBeforeNow, timeType (optional) Same as above

Obtain all TAFs collected in the last 6 hours for KDEN, based on issue time

stationString=KDEN&hoursBeforeNow=6&timeType=issue

Notes
  • The ADDS database retains only three days worth of data.
  • Caution - it is not advisable to use the hoursBeforeNow constraint in conjunction with the validTime time type.

Most Recent

Parameter(s) Allowed Values Example(s)
mostRecent
  • true - get the single most recent TAF, only one result is returned
  • false - don't get the most recent TAF, equivalent to omitting mostRecent parameter
  • the mostRecent constraint MUST be accompanied by a time range in the form of an hoursBeforeNow or startTime/endTime and timeType
  • Query is based on the most recent TAF issueTime within the time range defined by hoursBeforeNow or startTime/endTime

Request the most recent of the two icaoId's KSEA and PHNL from three hours ago, based on issue time. Only one TAF is returned, the most recent of the two from three hours ago.

hoursBeforeNow=3&timeType=issue&mostRecent=true&stationString=PHNL KSEA

Notes
  • The mostRecent constraint is applied after all other constraints have been applied to yield only one TAF. This single TAF corresponds to the most recent in the result set defined by the other constraints.
  • The mostRecent constraint may not be used together with the mostRecentForEachStation constraint
  • The mostRecent constraint must be accompanied by a time range in the form of an hoursBeforeNow or startTime/endTime.

Most Recent for Each Station

Parameter(s) Allowed Values Example(s)
mostRecentForEachStation
  • constraint - request the most recent for each TAF station in the fastest fashion. Not appropriate for historical data retrieval
  • postfilter - post filter results after applying all other constraints
  • true - same as 'postfilter' method
  • false - don't get the most recent for each TAF station, equivalent to omitting this parameter

Obtain the most recent TAF for each station that was reported in the past two hours from stations starting with KDE.

mostRecentForEachStation=constraint&hoursBeforeNow=2&stationString=KDE

Note: This is not appropriate for historical data retrieval.

mostRecentForEachStation Same as above

Obtain the most recent TAF reported for KORD, PHKO, KSEA and KSFO from the past three hours. The 'constraint' type should not be used for historical data retrieval. Should return four results unless one of these stations has not reported in the last 3 hours

stationString=KORD, PHKO, KSEA, KSFO&hoursBeforeNow=3&mostRecentForEachStation=constraint

mostRecentForEachStation Same as above

Use the postfilter method to obtain the TAFS for KORD, PHKO, KSEA and KSFO from the indicated start and end times. From those results, return only the most recent for each of these stations. Four results should be returned with each result corresponding to the most recent for KORD, PHKO, KSEA and KSFO within the specified time range.

startTime=1337242856&endTime=1337250056&stationString=KORD, PHKO, KSEA, KSFO&mostRecentForEachStation=postfilter

mostRecentForEachStation Same as above

Same as above, defaulting to the postfilter method. Obtain the TAFS for KORD, PHKO, KSEA and KSFO from the indicated start and end times. From those results, return only the most recent for each of these stations. Four results should be returned, each corresponding to the most recent for KORD, PHKO, KSEA and KSFO within the specified time range.

startTime=1337242856&endTime=1337250056&stationString=KORD, PHKO, KSEA, KSFO&mostRecentForEachStation=true

Notes
  • See version 1.2 release notes for further details on the different types.
  • This constraint may not be used with the mostRecent constraint.

Lon-Lat Rectangle

Parameter(s) Allowed Values Example(s)
minLat, minLon, maxLat, maxLon
  • longitude and latititude in decimal degrees
  • -180<= lon <=180
  • -90<= lat <=90
  • parameters can be listed in any order

Obtain TAFs collected within the last 3 hours for a rectangular region (bounding box) defined by the min and max lon and lat

minLat=25&minLon=-130&maxLat=65&maxLon=-40&hoursBeforeNow=3

Notes
  • The LonLatRect constraint can accommodate situations where the bounding box crosses the International Date Line
  • The LonLatRect constraint does not support bounding boxes that cross the poles.

Radial Distance

Parameter(s) Allowed Values Example(s)
radialDistance
  • a radius (statute miles) around a point (longitude and latitude in decimal degrees)
  • -180<= lon <=180
  • -90<= lat <=90
  • 0< radius <=500
  • Radius and origin are separated by a semicolon(;)
  • Described area may not cross the international dateline or either pole

Obtain TAFs valid within the last 3 hours for all the stations within 20 statute miles of -104.65,39.83 (KDEN)

radialDistance=20;-104.65,39.83&hoursBeforeNow=3

Flight Path

Parameter(s) Allowed Values Example(s)
flightPath
  • maximum distance in statute miles
  • two or more way points
  • Way points are indicated by (lon,lat), station names or a combination of (lon,lat) and station name
  • lon, lat are delimited by a comma (,)
  • maximum distance MUST precede the way points
  • maximium distance and way points are delimited by a semicolon(;)
  • time range:
    • use start, end times
    • use hoursBeforeNow
    • default: (hoursBeforeNow=1)
  • the ordering of way points is significant: always start with origin, end with destination

Obtain all TAFS collected in the past 3 hours for the flight path from Denver, CO to Kansas City, MO using a 57.5 statute mile maximum distance

flightPath=57.5;-104.65,39.83;-94.75,39.3&hoursBeforeNow=3

flightPath Same as above

Obtain all TAFS collected in the past 3 hours for the flight path from Denver, CO to Kansas City, MO using a 57.5 statute mile maximum distance and the station name for Denver, rather than the (lon,lat).

flightPath=57.5;KDEN;-94.75,39.3&hoursBeforeNow=3

flightPath Same as above

Same as above, except using the default time range of hoursBeforeNow=1

flightPath=57.5;-104.65,39.83;-94.75,39.3

flightPath Same as above

A flight path from Denver, CO to Corpus Cristi, TX to Orlando, FL using the default time range and a 57.5 statute mile maximum distance.

flightPath=57.5;-104.65,39.83;-97.5,27.77;-81.33,28.42

Notes
  • Flight path results are sorted by distance along the flight path, from origin to destination.
  • The flight path constraint cannot accommodate the following situations:
    • flight paths that cross the poles
    • flight paths that cross the International Date Line

Density

Parameter(s) Allowed Values Example(s)
minDegreeDistance
  • 0 < any value <=90
  • The degree distance is the distance (based on longitude and latitude) between stations. The larger the value of minDegreeDistance, the less dense the results.
  • Duplicate stations are filtered and the most recent of duplicate stations is reported.

Obtain all TAFs collected in the past 3 hours for the flight path from Denver, CO to Orlando, FL using a 57.5 statute mile maximum distance and requesting the lowest density of results.

flightPath=57.5;KDEN;KMCO&minDegreeDistance=90

minDegreeDistance Same as above

Obtain all TAFs collected in the past 3 hours for the flight path from Denver, CO to Orlando, FL using a 57.5 statute mile maximum distance and requesting a high density of results.

flightPath=57.5;KDEN;KMCO&minDegreeDistance=1

128.117.200.194 strut.rap.ucar.edu strut adds-web2