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

AIR/SIGMET Examples

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

Time Range

Parameter(s) Allowed Values Example(s)
startTime, endTime
  • start and end times in seconds since January 1, 1970 (Unix time)
  • Query is based on validTimeFrom and validTimeTo

Obtain all AIRSIGMETs collected between these start and end times

startTime=1337242443&endTime=1337249643

startTime, endTime
  • start and end times in ISO8601 date/time format
  • Query is based on validTimeFrom and validTimeTo

Obtain all AIRSIGMETs collected between the start and end times using ISO8601 date/time format with UTC offset: YYYY-MM-DDThh:mm:ssZ. Please refer to W3C date/time formats.

startTime=2012-05-17T08:14:03Z&endTime=2012-05-17T10:14:03Z

startTime, endTime
  • start and end times in ISO8601 date/time format
  • Query is based on validTimeFrom and validTimeTo

Obtain all AIRSIGMETs collected between the start and end times in ISO8601 date/time format using UTC 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:14:03+0000&endTime=2012-05-17T10:14:03+0000

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
  • any positive integer or floating point value
  • n = number of hours before current time
  • Query is based on validTimeFrom and validTimeTo

Obtain all AIRSIGMETs collected in the last three hours

hoursBeforeNow=3
Notes
The ADDS database retains only three days worth of data.

Most Recent

Parameter(s) Allowed Values Example(s)
mostRecent
  • true - get the single most recent AIRSIGMET, only one result is returned
  • false - don't get the most recent AIRSIGMET, equivalent to omitting mostRecent parameter
  • The mostRecent request MUST be accompanied by a time range in the form of an hoursBeforeNow or startTime/endTime.
  • MostRecent queries are based on receiptTimes, which are not exposed

Only one AIRSIGMET is returned, the most recent of all the AIRSIGMETs in the database from 5 hours ago.

hoursBeforeNow=5&mostRecent=true
Notes
  • The mostRecent constraint is applied after all other constraints have been applied to yield only one AIRSIGMET.
  • This single AIRSIGMET corresponds to the most recent in the result set defined by the other constraints.
  • Only one AIRSIGMET is returned.

Altitude Range

Parameter(s) Allowed Values Example(s)
minAltitudeFt, maxAltitudeFt
  • any integer value (in feet)
  • both a min and max altitude must be indicated
  • min and max can be in any order

Obtain all AIRSIGMETs whose min/max altitude range overlaps at all with the 10000 to 40000 feet range within the past two hours

minAltitudeFt=10000&maxAltitudeFt=40000&hoursBeforeNow=2

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 AIRSIGMETs collected within the last 3 hours for a rectangular region (bounding box) defined by the min and max lon and lat. If any portion of an AIRSIGMET region coincides with this rectangular region, then that AIRSIGMET is returned.

minLat=25&minLon=-130&maxLat=65&maxLon=-40&hoursBeforeNow=3
Notes
  • The LonLatRect constraint for AIRSIGMETS returns a result when the rectangle defined by the lat/lon points intersects with an AIRSIGMET area.
  • The LonLatRect constraint can accomodate situations where the bounding box crosses the International Date Line.
  • The LonLatRect constraint does not support bounding boxes that cross the poles.

Flight Path

Parameter(s) Allowed Values Example(s)
flightPath
  • maximum distance in statute miles
  • two or more way points
  • The way points may be selected by (lon,lat), station names, or a combination of (lon,lat) and station names.
  • 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)

Obtain all AIRSIGMETS collected in the past 3 hours that intersect 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

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

Same as above, except using the default time range of hoursBeforeNow=1 and the station name for Denver.

flightPath=57.5;KDEN;-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 NOT currently sorted from origin to destination. This may be available in a future release.
  • The flight path constraint cannot accommodate the following situations:
    • flight paths that cross the poles
    • flight paths that cross the International Date Line
128.117.200.197 thrust.rap.ucar.edu thrust adds-web1