Time Range

Parameter(s)	Allowed Values	Example(s)	Description
startTime, endTime	start and end times in seconds since January 1, 1970 (Unix time) Query is based on validTimeFrom and validTimeTo	startTime=1716149106& endTime=1716156306	obtain all AIRSIGMETs collected between these start and end times
startTime, endTime	start and end times in ISO 8601 date/time format Query is based on validTimeFrom and validTimeTo	startTime= 2024-05-19T20:05:06Z &endTime= 2024-05-19T20:05:06Z	obtain all AIRSIGMETs collected between these start and end times in ISO 8601 date/time format with UTC offset: YYYY-MM-DDThh:mm:ssZ. Please see W3C date/time formats.
startTime, endTime	start and end times in ISO 8601 date/time format Query is based on validTimeFrom and validTimeTo	startTime= 2024-05-19T13:05:06+0700 &endTime= 2024-05-19T13:05:06+0700	obtain all AIRSIGMETs collected between these start and end times in ISO 8601 date/time format with UTC offset: YYYY-MM-DDThh:mm:ss +hhmm OR YYYY-MM-DDThh:mm:ss -hhmm 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 +. Please see W3C date/time formats.
hoursBeforeNow	any positive integer or floating point value n = number of hours before current time Query is based on validTimeFrom and validTimeTo	hoursBeforeNow=3	obtain all AIRSIGMETs collected in the last three hours

NOTE:The ADDS database retains only three days worth of data.

 

Most Recent

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

NOTE: 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 Value(s)	Example(s)	Description
minAltitudeFt, maxAltitudeFt	any integer value (in feet) both a min and max altitude must be indicated min and max can be in any order	minAltitudeFt=10000& maxAltitudeFt=40000& hoursBeforeNow=2	obtain all AIRSIGMETs whose min/max altitude range overlaps at all with the 10000 to 40000 feet range within the past two hours

 

Lon-Lat Rectangle

Parameter(s)	Allowed Values	Example(s)	Description
minLat, minLon, maxLat, maxLon	longitude and latititude in decimal degrees -180<= lon <=180 -90<= lat <=90 Please refer to : latitude and longitude for a refresher on these ranges. parameters can be listed in any order	minLat=25&minLon=-130& maxLat=65&maxLon=-40& hoursBeforeNow=3	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.

NOTE:

• 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)	Description
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)	flightPath=57.5; -104.65,39.83; -94.75,39.3 &hoursBeforeNow=3	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		flightPath=57.5; -104.65,39.83; -94.75,39.3	same as above, except using the default time range of hoursBeforeNow=1
flightPath		flightPath=57.5; KDEN; -94.75,39.3	same as above, except using the default time range of hoursBeforeNow=1 and the station name for Denver.
flightPath		flightPath=57.5; -104.65,39.83; -97.5,27.77; -81.33,28.42	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.

NOTE:
Flight path results are NOT currently sorted from origin to destination. This may be available in a future release.
The flight path constraint cannot accomodate the following situations:

• flight paths that cross the poles


• flight paths that cross the International Date Line.