Aviation Weather Center · Schema

AviationWeather Terminal Aerodrome Forecast (TAF)

Decoded TAF as returned by GET /api/data/taf?format=json.

AviationWeatherGovernmentNOAANWSMETARTAFPIREPSIGMETAIRMETOpen DataPublic APIs

Properties

Name Type Description
icaoId string ICAO identifier of the forecast site.
dbPopTime string Time product was received.
bulletinTime string Official bulletin time.
issueTime string Time the TAF was issued.
validTimeFrom integer Start of validity period (UNIX epoch seconds).
validTimeTo integer End of validity period (UNIX epoch seconds).
rawTAF string Raw TAF text.
mostRecent integer 1 if most recent TAF for the site.
remarks stringnull Additional remarks.
lat number Latitude (decimal degrees).
lon number Longitude (decimal degrees).
elev integer Elevation (meters).
prior integer Site priority for progressive disclosure.
name string Full name of the site.
fcsts array Individual forecast periods within the TAF.
View JSON Schema on GitHub

JSON Schema

aviationweather-taf-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api-evangelist.github.io/aviationweather/json-schema/aviationweather-taf-schema.json",
  "title": "AviationWeather Terminal Aerodrome Forecast (TAF)",
  "description": "Decoded TAF as returned by GET /api/data/taf?format=json.",
  "type": "object",
  "required": ["icaoId", "rawTAF", "validTimeFrom", "validTimeTo"],
  "properties": {
    "icaoId":         { "type": "string", "description": "ICAO identifier of the forecast site." },
    "dbPopTime":      { "type": "string", "description": "Time product was received." },
    "bulletinTime":   { "type": "string", "description": "Official bulletin time." },
    "issueTime":      { "type": "string", "description": "Time the TAF was issued." },
    "validTimeFrom":  { "type": "integer", "description": "Start of validity period (UNIX epoch seconds)." },
    "validTimeTo":    { "type": "integer", "description": "End of validity period (UNIX epoch seconds)." },
    "rawTAF":         { "type": "string", "description": "Raw TAF text." },
    "mostRecent":     { "type": "integer", "enum": [0,1], "description": "1 if most recent TAF for the site." },
    "remarks":        { "type": ["string","null"], "description": "Additional remarks." },
    "lat":            { "type": "number", "description": "Latitude (decimal degrees)." },
    "lon":            { "type": "number", "description": "Longitude (decimal degrees)." },
    "elev":           { "type": "integer", "description": "Elevation (meters)." },
    "prior":          { "type": "integer", "minimum": 0, "maximum": 9, "description": "Site priority for progressive disclosure." },
    "name":           { "type": "string", "description": "Full name of the site." },
    "fcsts": {
      "type": "array",
      "description": "Individual forecast periods within the TAF.",
      "items": {
        "type": "object",
        "properties": {
          "timeFrom":     { "type": "integer", "description": "Forecast validity start (UNIX epoch)." },
          "timeTo":       { "type": "integer", "description": "Forecast validity end (UNIX epoch)." },
          "timeBec":      { "type": ["integer","null"], "description": "End of BECMG transition (UNIX epoch)." },
          "fcstChange":   { "type": ["string","null"], "enum": [null, "TEMPO","FM","BECMG","PROB"], "description": "Change type." },
          "probability":  { "type": ["integer","null"], "description": "Probability from PROB30 / PROB40 groups." },
          "wdir":         { "type": ["integer","string","null"], "description": "Wind direction in degrees or VRB." },
          "wspd":         { "type": ["integer","null"], "description": "Wind speed (knots)." },
          "wgst":         { "type": ["integer","null"], "description": "Wind gust (knots)." },
          "wshearHgt":    { "type": ["integer","null"], "description": "Wind shear top in feet." },
          "wshearDir":    { "type": ["integer","null"], "description": "Wind direction at top of shear layer." },
          "wshearSpd":    { "type": ["integer","null"], "description": "Wind speed at top of shear layer (knots)." },
          "visib":        { "type": ["number","string","null"], "description": "Visibility (SM); 6+ for >6 SM." },
          "altim":        { "type": ["number","null"], "description": "Altimeter setting (hPa)." },
          "vertVis":      { "type": ["integer","null"], "description": "Vertical visibility (feet)." },
          "wxString":     { "type": ["string","null"], "description": "Encoded present weather." },
          "notDecoded":   { "type": ["string","null"], "description": "Text that could not be decoded." },
          "clouds":       { "type": "array", "items": { "type": "object" } },
          "icgTurb": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "var":       { "type": "string", "enum": ["ICE","TURB"] },
                "intensity": { "type": "integer" },
                "minAlt":    { "type": "integer", "description": "Minimum altitude (feet)." },
                "maxAlt":    { "type": "integer", "description": "Maximum altitude (feet)." }
              }
            }
          },
          "temp": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "validTime": { "type": "integer", "description": "Time of max/min (UNIX epoch)." },
                "sfcTemp":   { "type": "integer", "description": "Surface temperature (C)." },
                "maxOrMin":  { "type": "string", "enum": ["MAX","MIN"] }
              }
            }
          }
        }
      }
    }
  }
}