Airports

Radio frequencies for one airfield from the OurAirports dataset: type (ATIS/TWR/GND/CLD/DIR/APP/DEP/CTAF/UNICOM/...), a human description, and the frequency in MHz. Pass any code ourairports_lookup accepts. An airfield with no frequencies on file returns an empty list with found:true, not an error. An unrecognized airfield code is refused with a clear error, never an empty success.

Navigational aids (NDB, VOR, DME, VOR-DME, VORTAC, TACAN, ...) associated with one airfield from the OurAirports dataset: ident, name, type, frequency in kHz, coordinates, elevation, DME channel and power. Pass any code ourairports_lookup accepts. Most airfields have none on file (navaids are sparse relative to airports) -- that returns an empty list with found:true, not an error. An unrecognized airfield code is refused with a clear error, never an empty success.

Runway details for one airfield from the OurAirports dataset: for each runway, length and width in feet, surface type, whether it is lighted, whether it is closed, and both ends' ident/coordinates/elevation/heading/displaced threshold. Pass any code ourairports_lookup accepts (ICAO, IATA, GPS or local ident). An airfield with no fixed-wing runways on file (e.g. most heliports) returns an empty runways array with found:true, not an error. An unrecognized airfield code is refused with a clear error, never an empty success.

Calculate straight-line distance between two airports by IATA code (e.g., "JFK" to "LHR"). Returns kilometers and miles.

Get airport details by IATA code (e.g., "JFK", "LHR"). Returns name, city, country, coordinates, altitude, timezone.

Look up ANY airfield in the OurAirports bulk dataset (~86,000 rows: every ICAO/IATA/local-code airport, heliport, seaplane base and balloonport OurAirports tracks, including fields with no IATA code at all). Pass ANY of: an ICAO code ("KJFK", "EGLL"), an IATA code ("JFK"), a GPS code, or OurAirports' own local/national ident (e.g. a US local code like "00A", or a non-US ident like "AT-0001"). Returns name, type (large_airport/medium_airport/small_airport/heliport/seaplane_base/balloonport/closed), coordinates, elevation, country/region, and whether it has scheduled airline service. This is the superset of get_airport's AirportGap data -- use this for any code AirportGap does not recognize, or for a heliport/seaplane base/ICAO-only field get_airport cannot see at all. An unrecognized code is refused with a clear error, never an empty success.

Search the OurAirports dataset (~86,000 airfields) by a text match against name, municipality or ident, optionally narrowed by ISO country code (e.g. "US", "GB") and/or airfield type ("large_airport", "medium_airport", "small_airport", "heliport", "seaplane_base", "balloonport", "closed"). Results default to airfields with scheduled airline service first. Use this to find airfields by partial name/city when you do not already have a code -- ourairports_lookup requires an exact code. Rows beyond `limit` are reported via truncated/total_matching rather than silently dropped -- narrow the query or page with limit/offset to see the rest. A query that matches nothing returns found:false with an explanation, never a silent empty array mistaken for "no such place".

Look up an airport by city name (e.g. "Tokyo", "New York", "London") OR by 3-letter IATA code (e.g. "JFK", "LHR"). City lookup uses a bundled map of the top ~150 international hubs; cities with multiple airports return all primary ones. For airports not in the bundle, pass an IATA code or use the aviationstack pack for full-text name/country search.