Airports and Heliports

Version 1.0.0 • Published Jun 04, 2025 23:54 UTC • by RefPack, Federal Aviation Administration (FAA), International Civil Aviation Organization (ICAO), International Air Transport Association (IATA)

A global dataset of airports, airstrips, and heliports, including their location, type, and international codes (ICAO, IATA, GPS). This data supports applications in aviation, logistics, geospatial mapping, and transportation systems.

Download v1.0.0 (.zip)

🛩️ Airports Dataset (`airports`)

🧾 Overview

This dataset provides a comprehensive global list of aviation facilities, including airports, heliports, and landing strips, categorized by type and identified using standard aviation codes. It includes key fields such as the unique ident code, location details (municipality, region, country), and multiple standard identifiers including gps_code, iata_code, and icao_code when available.

The dataset is designed for use in applications involving air traffic operations, logistics, mapping, emergency response, and geographic visualization of aviation infrastructure. Data is based on publicly available records from aviation authorities and includes geospatial coordinates and elevation information.

🗂️ Dataset Structure

The dataset consists of an array of airport facility objects with the following fields:

Field Name	Data Type	Description	Required
`ident`	Text	Unique identifier for the airport (can be FAA, ICAO, or local code). Primary key.	Yes
`type`	Text	Type of facility (e.g., `small_airport`, `heliport`, `seaplane_base`, etc.).	Yes
`name`	Text	Common name of the airport or heliport.	Yes
`elevation_ft`	Number	Elevation in feet above sea level.	Yes
`continent`	Text	Continent code (e.g., `NA` for North America).	Yes
`iso_country`	Text	ISO 3166-1 alpha-2 country code (e.g., `US`, `DE`).	Yes
`iso_region`	Text	Region code combining country and subdivision (e.g., `US-AL`).	Yes
`municipality`	Text	City or locality where the airport is situated.	Yes
`icao_code`	Text/null	ICAO airport code (e.g., `KATL` for Atlanta). May be null.	Yes
`iata_code`	Text/null	IATA airport code (e.g., `ATL` for Atlanta). May be null.	Yes
`gps_code`	Text	Code used for GPS navigation.	Yes
`local_code`	Text	Local/FAA code if applicable (often same as `ident` for small U.S. airports).	Yes
`coordinates`	Text	Geospatial coordinates as a comma-separated string (latitude, longitude).	Yes

🧩 Usage Scenarios

This dataset is well-suited for:

Mapping and visualizing global airport infrastructure.
Air traffic control and routing simulations.
Emergency service dispatch and logistics.
Flight planning tools and pilot applications.
Aviation research, education, and geographic analysis.
Localizing airport data for booking platforms or travel apps.
Linking GPS or IATA codes to airport metadata in commercial systems.

📐 Standardization Info

The dataset conforms to widely used aviation and geographic coding standards:

ICAO Code: Four-letter codes maintained by the International Civil Aviation Organization.
IATA Code: Three-letter codes used by the International Air Transport Association (mostly for commercial airports).
FAA/Local Code: Identifier used in local aviation databases.
ISO 3166-1: Used for iso_country and iso_region.
WGS84 Coordinates: Latitude and longitude in decimal degrees.

🔍 Sample Entries

ident	type	name	elevation_ft	iso_country	gps_code	coordinates
AL89	small_airport	Sommerset Strip	820	US	AL89	32.7187004, -85.3668975
AL90	heliport	Selma Medical Center Heliport	150	US	AL90	32.4290009, -87.0567017

🔒 Data Integrity

The ident field is the unique identifier for each airport record.
All fields are mandatory; icao_code and iata_code may be null if unavailable.
The format of coordinates is consistent as "<latitude>, <longitude>".
The dataset adheres to strict schema validation (additionalProperties: false).

📊 Metadata & Versioning

Dataset ID: airports
Packager Version (RefPack): 1.0.0
Packaged Date (UTC): 2025-06-08T00:00:00Z
Title: Airports Dataset
Description: A structured dataset of global airport and heliport locations, including identification codes, geographic and administrative information.
Authors & Contributors:
- RefPack
- OpenAIP / FAA / ICAO (source references)
License:
- Type: CC BY 4.0
- Details: This dataset is licensed under the Creative Commons Attribution 4.0 International license.
- Terms URL: https://creativecommons.org/licenses/by/4.0/
Tags: airports, aviation, icao, iata, faa, geography, reference, location, transport, infrastructure, mapping, travel

Field Name	Field Type	Sample Values
continent	string	NA OC AF
coordinates	string	40.070985, -74.933689 38.704022, -101.473911 59.947733, -151.692524
elevation_ft	number	11 3435 450
gps_code	mixed	K00A 00AA 00AK
iata_code	string	null UTK OCA
icao_code	string	null OATD OALG
ident	mixed	00A 00AA 00AK
iso_country	string	US PR MH
iso_region	string	US-PA US-KS US-AK
local_code	mixed	00A 00AA 00AK
municipality	string	Bensalem Leoti Anchor Point
name	string	Total RF Heliport Aero B Ranch Airport Lowell Field
type	string	heliport small_airport seaplane_base

Full `data.schema.json` Content (v1.0.0)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "RefPack Data Schema",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "ident": {
        "type": ["string", "null", "number"],
        "description": "Unique identifier for the airport, typically matching the GPS or local code."
      },
      "type": {
        "type": "string",
        "description": "The type of airport or landing facility (e.g., 'small_airport', 'heliport')."
      },
      "name": {
        "type": "string",
        "description": "The full name of the airport or heliport."
      },
      "elevation_ft": {
        "type": ["integer", "null"],
        "description": "Elevation above sea level in feet."
      },
      "continent": {
        "type": "string",
        "description": "Continent code where the facility is located (e.g., 'NA' for North America).",
        "pattern": "^[A-Z]{2}$"
      },
      "iso_country": {
        "type": "string",
        "description": "ISO 3166-1 alpha-2 country code where the airport is located.",
        "pattern": "^[A-Z]{2}$"
      },
      "iso_region": {
        "type": "string",
        "description": "ISO 3166-2 region code indicating the region or state within the country (e.g., 'US-AL')."
      },
      "municipality": {
        "type": ["string", "null"],
        "description": "Name of the city or municipality served by the airport."
      },
      "icao_code": {
        "type": ["string", "null"],
        "description": "ICAO 4-letter airport code, if available."
      },
      "iata_code": {
        "type": ["string", "null"],
        "description": "IATA 3-letter airport code used for commercial passenger services, if available."
      },
      "gps_code": {
        "type": ["string", "null", "number"],
        "description": "Code used for GPS navigation, typically identical to ident or ICAO."
      },
      "local_code": {
        "type": ["string", "null", "number"],
        "description": "Local code assigned by national aviation authorities."
      },
      "coordinates": {
        "type": ["string", "number", "null"],
        "format": "geo-coordinate",
        "description": "Comma-separated latitude and longitude in decimal degrees (e.g., '32.4290, -87.0567').",
        "pattern": "^-?\\d+(\\.\\d+)?,\\s*-?\\d+(\\.\\d+)?$"
      }
    },
    "required": [
      "ident",
      "type",
      "name",
      "continent",
      "iso_country",
      "iso_region",
      "gps_code",
      "local_code",
      "coordinates"
    ],
    "additionalProperties": false
  }
}

Airports and Heliports

🛩️ Airports Dataset (`airports`)

🧾 Overview

🗂️ Dataset Structure

🧩 Usage Scenarios

📐 Standardization Info

🔍 Sample Entries

🔒 Data Integrity

📊 Metadata & Versioning

Data Preview (`data.json` - First 3 Records of v1.0.0)

RefPack Data Schema (v1.0.0)

Suggested Key Fields:

Changelog for Package v1.0.0

Version 1.0.0

Available Versions for airports

Version 1.0.0 Current

Report an Issue

Reporting Guidelines

Airports and Heliports

🛩️ Airports Dataset (airports)

🧾 Overview

🗂️ Dataset Structure

🧩 Usage Scenarios

📐 Standardization Info

🔍 Sample Entries

🔒 Data Integrity

📊 Metadata & Versioning

Data Preview (data.json - First 3 Records of v1.0.0)

RefPack Data Schema (v1.0.0)

Suggested Key Fields:

Changelog for Package v1.0.0

Version 1.0.0

Available Versions for airports

Version 1.0.0 Current

Report an Issue

Reporting Guidelines

Full data.json Content (v1.0.0)

Full data.changelog.json Content (v1.0.0)

Full data.schema.json Content (v1.0.0)

🛩️ Airports Dataset (`airports`)

Data Preview (`data.json` - First 3 Records of v1.0.0)

Full `data.json` Content (v1.0.0)

Full `data.changelog.json` Content (v1.0.0)

Full `data.schema.json` Content (v1.0.0)