GeoJSON Service Help


Location: /gis/scripts/TafJSON.php

This script will create GeoJSON output using data from the ADDS database. The latest TAF is returned if site has a valid TAF available at the valid time. Here is sample output:

{ "type": "FeatureCollection",
    "features": [
    { "type": "Feature",
	"properties": {
	    "id": "KTUP",
	    "site": "Tupelo Rgnl",
	    "issueTime": "2013-09-24T20:07:00Z",
	    "validTimeFrom": "2013-09-24T20:00:00Z",
	    "validTimeTo": "2013-09-25T18:00:00Z",
	    "validTime": "2013-09-24T21:55:36Z",
	    "timeGroup": "0",
	    "fcstType": "PREVAIL",
	    "wspd": 6,
	    "wdir": 130,
	    "visib": 6.21,
	    "ceil": 8,
	    "cover": "OVC",
	    "fltcat": "IFR",
	    "rawTAF": "KTUP 242007Z 2420/2518 13006KT P6SM OVC008 FM242200 
		16005KT P6SM BKN015 BKN025 FM250200 VRB02KT 5SM BR OVC008 
		FM250600 00000KT 2SM BR OVC002 FM251500 25002KT 5SM BR 
		SCT002 OVC008"
	"geometry": {
	    "type": "Point",
	    "coordinates": [-88.77,34.27]
    { "type": "Feature",
	"properties": {
	    "id": "KTCS",
	    "site": "Truth or Consequence",
	    "issueTime": "2013-09-24T17:46:00Z",

The properties output from the script are:

  • id - Station identifier
  • site - The long name for the site
  • issueTime - ISO 8601 formatted date and time when TAF issued
  • validTimeFrom - ISO 8601 formatted date and time when TAF is first valid
  • validTimeTo - ISO 8601 formatted date and time when TAF is last valid
  • wspd - Wind speed in knots
  • wdir - Wind direction in degrees
  • wgst - Wind gusts in knots
  • visib - Visibility in miles
  • ceil - Cloud ceiling in 100s feet for broken or overcast skies (missing otherwise)
  • cover - Maximum cloud cover
  • fltcat - Flight category, either VFR, MVFR, IFR, LIFR
  • rawTAF - Raw TAF text
  • rawOb - Raw METAR 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.
  • fore=# - This sets the forecast time in hours. This will extract property data such as visib and ceil from future times in the TAF. The default is current.
  • filter=prior - This tells the script to use a priority scheme to filter stations on a priority scheme. It will base what priority to use on the size of the bounding box. The priority is set in the MetarSites table. The default is to only return stations with a priority of 2 or lower.
  • priority=# - This sets the default priority. The default is 2.
  • density=# - This augments the priority setting. This is used with the filter=prior setting to add more or less stations to the output relative to the default priority setting based on the bounding box. A setting of all will bypass the priority and display all stations.
  • metar=xxxx - If set to true or on or 1, this will include the latest METAR in the JSON output.
  • tempo=1 - If set, this will only temporary (TEMPO) conditions at the forecast time. The default is off (prevailing).
  • vdate=yyyymmddhhnn - This sets the valid date for the TAF. The output will be the latest TAF data from the site relative to this date. The default is current time.
  • 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.

Page loaded:  00:22 UTC  |   05:22 PM Pacific  |   06:22 PM Mountain  |   07:22 PM Central  |   08:22 PM Eastern