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",
      "id": 27859739, 
      "properties": {
          "data": "AIREP",
          "icaoId": "KWBC", 
          "obsTime": "2019-12-30T18:02:00Z", 
          "airepType": "PIREP", 
          "acType": "LJ45", 
          "cloudCvg1": "BKN", 
          "cloudBas1": "18", 
          "fltlvl": "015", 
          "fltlvlType": "OTHER", 
          "rawOb": "FLL UA /OV 4 WEST/TM 1802/FL015/TP LJ45/SK BKN018"
      "geometry": {
          "type": "Point",
          "coordinates": [-80.166,26.074]
    { "type": "Feature",
      "id": 27859995, 
      "properties": {
          "data": "AIREP",
          "icaoId": "KAWN", 

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 layer 1 coverage: CLR, SCT, BKN, OVC
  • cloudBas1 - Cloud layer 1 base in 100s feet
  • cloudTop1 - Cloud layer 1 top in 100s feet
  • cloudCvg2 - Cloud layer 2 coverage: CLR, SCT, BKN, OVC
  • cloudBas2 - Cloud layer 2 base in 100s feet
  • cloudTop2 - Cloud layer 2 top in 100s feet
  • wxString - Observed weather: -RA, -SN, TS, etc
  • fltlvl - Flight level in 100s of feet
  • fltlvlType - Flight level type: GRND, DURC, DURD, CRUISE, OTHER, UNKN
  • 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
  • brkAction - Braking action: GOOD, GOOD-MED, MED, MED-POOR, POOR, NIL
  • 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.
  • level=### - Specifies altitude in 100s feet (+/-3000 feet) for AIREPs/PIREPs. The default is no level.
  • 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.