GeoJSON Service Help


Location: /cgi-bin/json/AirepJSON.php

This script will create GeoJSON output using data from the ADDS database. The latest set of PIREPs and AIREPs is returned. Here is sample output:

{ "type": "FeatureCollection",
    "features": [
    { "type": "Feature",
	"properties": {
	    "icaoId": "KAWN",
	    "obsTime": "2013-09-24T20:55:00Z",
	    "acType": "C25B",
	    "fltlvl": "240",
	    "tbInt1": "MOD",
	    "tbType1": "CHOP",
	    "icgInt1": "NEG",
	    "rawOb": "BOI UA /OV BOI200025/TM 2055/FL240/TP C25B/TB MOD
	"geometry": {
	    "type": "Point",
	    "coordinates": [-116.42,43.17]
    { "type": "Feature",
	"properties": {
	    "icaoId": "KAWN",
	    "obsTime": "2013-09-24T20:57:00Z",
	    "acType": "UAL1226",
	    "temp": "-36",
	    "wdir": "269",
	    "wspd": "37",
	    "fltlvl": "320",
	    "rawOb": "ARP UAL1226 3108N 12333W 2057 F320 M36 269/037"
	"geometry": {
	    "type": "Point",
	    "coordinates": [-123.55,31.13]

The properties output from the script are:

  • icaoId - ICAO ID that entered the AIREP/PIREP
  • obsTime - ISO 8601 formatted date and time when AIREP/PIREP issued
  • acType - Aircraft type or flight number
  • temp - Temperature in Celsius
  • wdir - Wind direction in degrees
  • wspd - Wind speed in knots
  • cloudCvg1 - Cloud coverage: CLR, SCT, BKN, OVC
  • cloudBas1 - Cloud base in 100s feet
  • cloudTop1 - Cloud top in 100s feet
  • fltlvl - Visibility in miles
  • tbInt1 - Turbulence intensity: NEG, SMTH-LGT, LGT, LGT-MOD, MOD, MOD-SEV, SEV, SEV-EXTM, EXTM
  • tbType1 - Turbulence type: CAT, CHOP, LLWS, MWAVE
  • tbFreq1 - Turbulence frequency: ISOL, OCNL, CONT
  • icgInt1 - Icing intensity: NEG, NEGclr, TRC, TRC-LGT, LGT, LGT-MOD, MOD, MOD-SEV, HVY, SEV
  • icgType1 - Icing type: RIME, CLEAR, MIXED
  • rawOb - Raw AIREP/PIREP text

The script can be passed parameters via command line or through CGI REQUEST. The parameters to the script include:

  • bbox=minlon,minlat,maxlon,maxlat - This is the bounding box for area of interest. This limits the stations output in GeoJSON to those within that lat/lon range. The default is -130,20,-60,60.
  • type=turb|icing|wx|all - Only output AIREPs/PIREPs with a certain hazard. The default is all.
  • top=### - Specifies top altitude in 100s feet for returned AIREPs/PIREPs. The default is no top.
  • bottom=### - Specifies bottom altitude in 100s feet for returned AIREPs/PIREPs. The default is no top.
  • date=yyyymmddhhnn - This sets the date for the AIREP/PIREP reports. This combined with the age returns all reports within that time range. The default is current time.
  • age=### - Sets time range/age in hours for returned AIREPs/PIREPs. The default is no 1.5 hours.
  • jsonp=callback - This sets the callback function to be used in a JSONP call. This is just when the script is called on another server. The default is null which outputs straight JSON.