TDS: G-AIRMET Examples
Time Range
Most Recent
Altitude Range
Lon-Lat Rectangle
Flight Path
 

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=1679526839& endTime=1679537639 obtain all GAIRMETs 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=
2023-03-22T23:13:59Z
&endTime=
2023-03-23T02:13:59Z 		obtain all GAIRMETs 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=
2023-03-22T16:13:59+0700
&endTime=
2023-03-22T19:13:59+0700 		obtain all GAIRMETs 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 GAIRMETs collected in the last three hours

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

 

Most Recent

Top ▲
Parameter(s) Allowed Values Example(s) Description
mostRecent
  • true - get the single most recent GAIRMET, 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 GAIRMET, equivalent to omitting mostRecent parameter

  • MostRecent queries are based on receiptTimes, which are not exposed
 hoursBeforeNow=5
&mostRecent=true 		only one GAIRMET is returned, the most recent of all the GAIRMETs in the database from 5 hours ago.

NOTE: The mostRecent constraint is applied after all other constraints have been applied to yield only one GAIRMET. This single GAIRMET corresponds to the most recent in the result set defined by the other constraints. Only one GAIRMET is returned.

 

Altitude Range

Top ▲
Parameter(s) Allowed Values 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 GAIRMETs whose min/max altitude range overlaps at all with the 10000 to 40000 feet range within the past two hours

 

Lon-Lat Rectangle

Top ▲
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 GAIRMETs 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 GAIRMET region coincides with this rectangular region, then that GAIRMET is returned.

NOTE:

  • The LonLatRect constraint for GAIRMETS returns a result when the rectangle defined by the lat/lon points intersects with an GAIRMET 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

Top ▲
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 GAIRMETS 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.


Page loaded:  02:13 UTC  |   07:13 PM Pacific  |   08:13 PM Mountain  |   09:13 PM Central  |   10:13 PM Eastern

 

ADVISORIES

FORECASTS

FORECASTS

OBSERVATIONS

USER TOOLS

ABOUT US