TAF

TAF is a format for reporting forecast weather information.

Terminal Aerodrome Forecast (TAF) is a format for reporting weather forecast information, particularly as it relates to aviation. TAFs are issued every six hours for major civil airfields: 0000, 0600, 1200 and 1800 UTC, and generally apply to a 24- or 30-hour period, and an area within approximately five statute miles (8.0 km) (or 5 nautical miles (9.3 km) in Canada) from the center of an airport runway complex. TAFS are issued every three hours for military airfields and some civil airfields and cover a period ranging from 3 hours to 30 hours.

TAFs complement and use similar encoding to METAR reports. They are produced by a human forecaster based on the ground. For this reason there are considerably fewer TAF locations than there are airports for which METARs are available. TAFs can be more accurate than Numerical Weather Forecasts, since they take into account local, small-scale, geographic effects.

In the United States the weather forecasters responsible for the TAFs in their respective areas are located within one of the 122 Weather Forecast Offices operated by the United States’ National Weather Service. In contrast, a trend type forecast (TTF), which is similar to a TAF, is always produced by a person on-site where the TTF applies. In the United Kingdom most TAFs at military airfields are produced locally, however TAFs for civil airfields are produced at the Met Office headquarters in Exeter.

TAF is the most common format in the world for the transmission of forecast weather data. It is highly standardized through the International Civil Aviation Organization, which allows it to be understood throughout most of the world.

Our decoded TAF, decodes the raw TAF to creates keys and values for each part in a TAF. We also include additional weather information and conversions in the response data.

 

TAF Raw vs Decoded

By default all TAF endpoints return data in a raw string format.

By adding the /decoded URL Parameter to the end of any TAF endpoint, both the raw and decoded TAF will be included in the response data.

 

TAF Fields

The following table lists the fields which are returned by all /decoded TAF endpoints.

Fields marked as Conditional will not be included in the JSON response data if no value exists for that field.

Therefore your code should check for the existence of these fields before attempting to access the data value to avoid any errors.

Field Type Description Conditional
raw_text string Raw TAF text string
icao string ICAO airport code or station indicator
station.name string Station name
location GeoJSON GeoJSON location object
.coordinates array GeoJSON array of coordinates: [longitude, latitude]
.type string GeoJSON object type: "POINT"
timestamp.issued datetime TAF issued ISODate in UTC
timestamp.from datetime Overall forecast from ISODate in UTC
timestamp.to datetime Overall forecast to ISODate in UTC
forecast array Array with the following properties
timestamp.from datetime Section forecast from ISODate in UTC
timestamp.to datetime Section forecast to ISODate in UTC
change.probability integer Change probability percentage
change.indicator.code string Change indicator abbreviation code
change.indicator.text string Change indicator text
change.indicator.desc string Change indicator description
clouds array Array of cloud levels each with the following properties
code string Cloud abbreviation code
text string Cloud description text
feet decimal Base feet above ground level (AGL)
meters decimal Base meters above ground level (AGL)
conditions array Array of conditions levels each with the following properties
code string Condition abbreviation code
text string Condition description text
visibility.miles string Visibility in miles (Expressed as a string to support values like '1/2 mile')
visibility.miles_float float Visibility in miles
visibility.meters string Visibility in meters (Expressed as a string to support values like '> 9000')
visibility.meters_float float Visibility in meters
wind.degrees integer Wind direction in degrees
wind.speed_kts integer Wind speed in knots
wind.speed_kph integer Wind speed in kilometers per hour
wind.speed_mph integer Wind speed in miles per hour
wind.speed_mps integer Wind speed in meters per second
wind.gust_kts integer Wind gust in knots
wind.gust_kph integer Wind gust in kilometers per hour
wind.gust_mph integer Wind gust in miles per hour
wind.gust_mps integer Wind gust in meters per second
turbulence array Array of turbulence levels each with the following properties
minimum.feet decimal Minimum altitiude in Feet AGL
minimum.meters decimal Minimum altitiude in Meters AGL
maximum.feet decimal Maximum altitiude in Feet AGL
maximum.meters decimal Maximum altitiude in Meters AGL
intensity.code string Intensity code
intensity.desc string Intensity description
icing array Array of icing levels each with the following properties
minimum.feet decimal Minimum altitiude in Feet AGL
minimum.meters decimal Minimum altitiude in Meters AGL
maximum.feet decimal Maximum altitiude in Feet AGL
maximum.meters decimal Maximum altitiude in Meters AGL
intensity.code string Intensity code
intensity.desc string Intensity description
 

/taf/:icao

Method
GET

Returns the latest TAF report for a one or more ICAO codes.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes
Parameter Description
icao A single ICAO code or multiple ICAO codes seperated by commas.
Maximum of 20 ICAO codes per request. Search for ICAO codes
Required
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station - raw TAF
curl 'https://api.checkwx.com/taf/KJFK' -H 'X-API-Key: YOUR_API_KEY'

###### multiple stations - raw TAF
curl 'https://api.checkwx.com/taf/KJFK,KLAX,KMIA' -H 'X-API-Key: YOUR_API_KEY'

###### single station - decoded TAF
curl 'https://api.checkwx.com/taf/KJFK/decoded' -H 'X-API-Key: YOUR_API_KEY'

###### multiple stations - decoded TAF
curl 'https://api.checkwx.com/taf/KJFK,KLAX,KMIA/decoded' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/taf/:icao/radius/:radius

Method
GET

Returns one or more TAF reports within a specified radius of a single ICAO code.

The results are sorted based on the distance from the requested ICAO code.

Additional response fields are included in the response data to show the distance and direction from the requested ICAO.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from string Base location ICAO
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
icao A single ICAO code. (Multiple ICAO codes are not allowed for this endpoint) Required
radius The surrounding radius in miles from the ICAO code.
250 miles is the maximum radius.
Required
decoded The response data will include decoded TAF key value pairs Optional
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station
curl 'https://api.checkwx.com/taf/KJFK/radius/20' -H 'X-API-Key: YOUR_API_KEY'

###### single station with 'Airport' only filter
curl 'https://api.checkwx.com/taf/KJFK/radius/20?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/taf/lat/:latitude/lon/:longitude

Method
GET

Returns a single TAF report nearest to the parameters latitude and longitude.

Additional response fields are included in the response data to show the distance and direction from the requested latitude and longitude.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from.latitude float Base location latitude
.from.longitude float Base location longitude
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
latitude The decimal latitude Required
longitude The decimal longitude Required
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


# latitude / longitude
curl 'https://api.checkwx.com/taf/lat/40.72/lon/-73.99' -H 'X-API-Key: YOUR_API_KEY'

# latitude / longitude with 'Airport' only filter
curl 'https://api.checkwx.com/taf/lat/40.72/lon/-73.99?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/taf/lat/:latitude/lon/:longitude/radius/:radius

Method
GET

Returns one or more TAF reports within a specified radius of the parameters latitude and longitude.

Additional response fields are included in the response data to show the distance and direction from the requested latitude and longitude.

Included in Plans
Basic
No
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from.latitude float Base location latitude
.from.longitude float Base location longitude
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
latitude The decimal latitude Required
longitude The decimal longitude Required
radius The surrounding radius in miles from the ICAO code.
250 miles is the maximum radius.
Required
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


curl 'https://api.checkwx.com/taf/lat/40.72/lon/-73.99/radius/10' -H 'X-API-Key: YOUR_API_KEY'

curl 'https://api.checkwx.com/taf/lat/40.72/lon/-73.99/radius/10?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online