airports-data

Airports data: static, dynamic and custom dump. Data from OpenFlights Airports Database.

Installation

npm install airports-data

Usage

const fs = require("fs");
const getAirportsData = require("airports-data");

process.on("unhandledRejection", err => {
  console.error(err);
  process.exit(1);
});

async function dumpData() {
  const data = await getAirportsData({
    dynamic: true,
    keys: ["name", "iata"]
  });
  fs.writeFileSync("airports.json", JSON.stringify(data));
}

dumpData();

API

getAirportsData(options): Promise<AirportData[]>

| Option | Type | Default | Description | | ------------------- | -------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------ | | options | object? | | | | options.dynamic | boolean? | false | Request the latest data online. | | options.keys | string?[] | string? | undefined | Apply a simple filtering to the loaded data (both statically and dynamically). Array of strings or string with comma separated keys. |

CLI

Usage
	$ airports-data

Options
	--dynamic, -d  Get data from https://openflights.org/data.html#airport instead of the local dump [Default: false]
	--keys, -k  Keys to include [Default:
		id
		name
		city
		country
		iata
		icao
		latitude
		longitude
		altitude
		timezone
		dst
		tz
		type
		source
	]

Examples
	$ airports-data
	[..., {"id":1382,"name":"Charles de Gaulle International Airport","city":"Paris","country":"France","iata":"CDG","icao":"LFPG","latitude":49.0127983093,"longitude":2.54999995232,"altitude":392,"timezone":1,"dst":"E","tz":"Europe/Paris","type":"airport","source":"OurAirports"}, ...]
	$ airports-data --keys name,iata
	[..., {"name":"Charles de Gaulle International Airport","iata":"CDG"}, ...]

Data

| Key | Description | | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Unique OpenFlights identifier for this airport. | | name | Name of airport. May or may not contain the City name. | | city | Main city served by airport. May be spelled differently from Name. | | country | Country or territory where airport is located. See countries.dat to cross-reference to ISO 3166-1 codes. | | iata | 3-letter IATA code. null if not assigned/unknown. | | icao | 4-letter ICAO code. null if not assigned. | | latitude | Decimal degrees, usually to six significant digits. Negative is South, positive is North. | | longitude | Decimal degrees, usually to six significant digits. Negative is West, positive is East. | | altitude | In feet. | | timezone | Hours offset from UTC. Fractional hours are expressed as decimals, eg. India is 5.5. | | dst | Daylight savings time. One of E (Europe), A (US/Canada), S (South America), O (Australia), Z (New Zealand), N (None) or U (Unknown). | | tz | Timezone in "tz" (Olson) format, eg. "America/Los_Angeles". | | type | Type of the airport. Value "airport" for air terminals, "station" for train stations, "port" for ferry terminals and "unknown" if not known. | | source | Source of this data. "OurAirports" for data sourced from OurAirports, "Legacy" for old data not matched to OurAirports (mostly DAFIF), "User" for unverified user contributions. |

License

MIT. See license file.