aviationapis

Get the current surface weather observation for an airport by ICAO code, fully decoded: temperature, dewpoint, wind (direction/speed/gust), visibility, altimeter, cloud layers, present weather, and the derived flight-rules category. Includes the raw observation string. Ideal for agents reasoning about real-time conditions at an airfield.

Get the terminal aerodrome forecast (TAF) for an airport by ICAO code, decoded into forecast periods: each with valid window, change indicator (FM/BECMG/TEMPO), wind, visibility, present weather, and cloud layers. Includes issue/validity times and the raw forecast. Useful for planning around expected conditions.

Get the current flight-rules category (VFR, MVFR, IFR, or LIFR) for an airport by ICAO code, derived from the latest observed ceiling and visibility. Returns the category plus the underlying ceiling (ft) and visibility (statute miles). A compact, decision-ready signal for routing and go/no-go logic.

Get the current automatic terminal information (ATIS) for an airport by ICAO code: the active information code (letter), issue time, arrival/departure designation, and decoded temperature/dewpoint, plus the full information text. Falls back to the latest surface observation when no current ATIS is published.

Get the most recent reported position of an aircraft by flight number or registration (tail): latitude, longitude, altitude (ft), track (deg), and ground speed (kt), along with callsign, type, and origin/destination when known. Returns the freshest available fix.

Get operational status for a flight by flight number or registration (tail): status/phase, origin and destination, scheduled vs. actual departure and arrival times, and gate assignments when known. Useful for agents tracking a specific flight's progress.

Decode a raw METAR or SPECI observation string into structured fields: station, time, wind (with gusts and variable direction), visibility, present weather (expanded to plain language), cloud layers, temperature/dewpoint, altimeter (hPa and inHg), and the derived flight-rules category. Pure decode — you supply the text; no lookup is performed.

Decode a raw terminal aerodrome forecast (TAF) string into structured forecast periods. Returns the station, issue time, overall validity window, and each period (initial plus FM/BECMG/TEMPO and PROB groups) with its time window, wind, visibility, present weather, and cloud layers. Pure decode of caller-supplied text.

Decode a raw NOTAM into structured fields. Extracts the NOTAM id and type and the ICAO field markers (Q/A/B/C/D/E/F/G) when present, isolates the free-text body, and expands common aviation contractions (RWY, TWY, CLSD, U/S, etc.) into plain language. Pure decode of caller-supplied text.

Decode an ACARS message: identify the message label and its meaning, return the message text, and extract a latitude/longitude fix and altitude when the body carries them (e.g. position reports). Best-effort structured extraction from caller-supplied text.

Compute the crosswind and headwind/tailwind components for a runway given the runway heading and the wind direction and speed. Returns the angle off the nose, the headwind component (negative for a tailwind), the crosswind magnitude, and which side the crosswind comes from. Deterministic; no lookup.

Compute pressure altitude and density altitude from field elevation, outside air temperature, and altimeter setting (hPa or inHg; defaults to standard). Returns pressure altitude, the ISA temperature at that altitude, and density altitude — the performance-relevant altitude for takeoff/climb planning. Deterministic; no lookup.

Compute the great-circle distance between two coordinates (in nautical miles, kilometers, and statute miles), the initial and final true bearings, and — when a ground speed is supplied — the estimated time en route. Deterministic; no lookup.

Compute sunrise, sunset, civil twilight begin/end, solar noon, and day length for a location (latitude/longitude) on a given UTC date (defaults to today). All times are returned as ISO-8601 UTC. Useful for day/night and lighting determinations. Deterministic; no lookup.