| |
Examples of Aircraft Report Queries:
| Constraint Type |
Parameter(s) |
Allowed Values |
Example(s) |
Description |
| Time Range |
startTime, endTime |
- start and end times in seconds since January 1, 1970
- query based on Aircraft Report obsTime
|
startTime=1283913821&
endTime=1283921021 |
obtain all Aircraft Reports collected between the start and end times |
| Time Range |
startTime, endTime |
- start and end times in ISO8601 date/time format
- query based on Aircraft Report obsTime
|
startTime=
2010-09-08T02:43:41Z&
endTime=
2010-09-08T04:43:41Z |
obtain all Aircraft Reports 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 |
| Time Range |
startTime, endTime |
- start and end times in ISO8601 date/time format
- query based on Aircraft Report obsTime
|
startTime=
2010-09-08T02:43:41+0700
&endTime=
2010-09-08T04:43:41+0700 |
obtain all Aircraft Reports collected between the 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
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 refer to W3C date/time formats. |
| Time Range |
hoursBeforeNow |
- any positive integer or floating point value
- n = number of hours before current time
- query based on Aircraft Report obsTime
|
hoursBeforeNow=1 |
obtain all Aircraft Reports collected in the last hour |
NOTE:The ADDS database retains only three days worth of data.
| Constraint Type |
Parameter(s) |
Allowed Value(s) |
Example(s) |
Description |
| Most Recent |
mostRecent |
- true - get the single most recent Aircraft Report, only one result is returned
- false - don't get the most recent Aircraft Report, equivalent
to omitting mostRecent parameter
- query based on Aircraft Report obsTime
|
hoursBeforeNow=1.5&mostRecent=true&
minLat=30.0&maxLat=35.0&
minLon=-105.1&maxLon=-95.0
|
All Aircraft Reports from the last hour and a half that fall within the min and max lon/lat are found, then out of those, the most recent one is returned. |
NOTE: The mostRecent constraint is applied after all other constraints have been applied to yield only one Aircraft Report.
This single Aircraft Report corresponds to the most recent in the result set defined by the other constraints. The mostRecent constraint MUST be constrained by a time range of either hoursBeforeNow or startTime/endTime. Only one Aircraft Report is returned.
| Constraint Type |
Parameter(s) |
Allowed Values |
Example(s) |
Description |
| LonLatRect |
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 Aircraft Reports collected within the last 3 hours for a rectangular region
(bounding box) defined by the min and max lon and lat |
NOTE:
- 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.
| Constraint Type |
Parameter(s) |
Allowed Values |
Example(s) |
Description |
| Radial Distance |
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
- Please refer to :
latitude and longitude for a refresher on these ranges.
|
radialDistance=70;-104.65,39.83&
hoursBeforeNow=3
|
obtain Aircraft Reports reported within the last 3 hours within 20 statute miles of -104.65,39.83 (KDEN) |
| Constraint Type |
Parameter(s) |
Allowed Values |
Example(s) |
Description |
| AltitudeRange |
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 Aircraft Reports that are greater than/equal to 10000 feet
or less than/equal to 40000 feet within the past two hours. |
| Constraint Type |
Parameter(s) |
Allowed Values |
Example(s) |
Description |
| Flight Path |
flightPath |
- maximum distance in statute miles
- two or more way points
- Way points are selectable by (lon,lat), station name, or a combination of (lon,lat) with 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
|
flightPath=57.5;
-125.27,49.95;
-104.65,39.83
&hoursBeforeNow=3
|
obtain all Aircraft ReportS collected in the past 3 hours
for the flight path from Campbell River, BC to Denver, CO using
a 57.5 statute mile maximum distance
|
Flight Path |
flightPath |
|
flightPath=57.5;
-125.27,49.95;
KDEN
&hoursBeforeNow=3
|
obtain all Aircraft ReportS collected in the past 3 hours
for the flight path from Campbell River, BC to Denver, CO using
a 57.5 statute mile maximum distance and the station name for DEN rather than using the (lon,lat).
|
| Flight Path |
flightPath |
|
flightPath=57.5;
-125.27,49.95;
-104.65,39.83
|
same as above, except using the default time range of hoursBeforeNow=1 |
| Flight Path |
flightPath |
|
flightPath=57.5;
-104.65,39.83;
-97.5,27.77;
-81.33,28.42;
-73.15,44.47
|
A flight path from Denver,Co to Corpus Cristi, Tx to Orlando, Fl to Burlington, Vt using the default
time range and a 57.5 statute mile maximum distance.
|
NOTE:
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.
| Constraint Type |
Parameter(s) |
Allowed Values |
Example(s) |
Description |
Density
| 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. |
flightPath=57.5;
KDEN;
KMCO&
minDegreeDistance=90
|
obtain all Aircraft Reports 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
least dense results.
|
| Density |
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. |
flightPath=57.5;
KDEN;
KMCO&
minDegreeDistance=1
|
obtain all Aircraft Reports 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.
|
For questions and comments regarding the dataserver,
please send email to
ADDS Dataserver
|
| |
