AeroCommonsNavigation Data · pack formats · test reports

Pack formats

Exactly what a pyEfis device reads from each pack, generated from the published packs, never written by hand. Machine-readable index: index.json.

pack kindkind containerschema_versiongenerated from
Airports (regional)airportsSQLite1airports-canada 2026.06
Roads & highwayshighwaysSQLite1highways-conus 2026q3r1
Navaids & airwaysnavaidsSQLite1navaids-conus 2612
Airports & runwaysnavdataSQLite1airports-conus 2612
ObstaclesobstaclesSQLite1obstacles-conus 261001
Procedures & airwaysproceduresSQLite1procedures-conus 2612
Terrainterrainzip1terrain-alaska 2024edr4, terrain-canada-east 2024edr4, terrain-canada-west 2024edr4, terrain-mexico-central-america 2024edr4, terrain-mosaic 2024edr4, terrain-us-central 2024edr4, terrain-us-east 2024edr4, terrain-us-south 2024edr4, terrain-us-west 2024edr4
WaterwaterSQLite1water-na 2026q4r1

The contract

Every pack carries a pack_meta header (a pack_meta(key, value) table in an SQLite pack, a pack_meta.json member in a zip pack) whose schema_version names the version of its format. Today it is the version of the pack_meta header itself, except for the kinds below, whose build reads it from the pack's content. Editions packed before a kind's rule existed declare 1 whatever they carry, so a reader should still check for the tables and columns it needs.

kindschema_versionwhat the pack carries
highways1columns of highway_lines: fclass, id, max_lat, max_lon, min_lat, min_lon, verts
highways2adds flags, ref
procedures1tables: airway_legs, airways, legs, procedures, transitions
procedures2adds msa
procedures3adds grid_mora, grid_mora_bands
procedures4adds fas_blocks

The tables and columns on these pages are public and versioned. Readers should look up columns by name and ignore tables and columns they do not know: new ones are added without a schema_version change. Removing or changing one is a format change.

What the build enforces today: each pack's test record (check ROW-003) fails when a table that the previous edition had is gone and schema_version did not change. A removed or retyped column is not yet checked by the record; the device acceptance check (ACC-001) only covers the columns pyEfis itself reads.

The pack formats described here are published under the Apache License 2.0, so anyone may write a tool that reads or writes them. The text of these pages is CC BY 4.0. The data inside each pack carries its own licence, named in the pack's manifest entry (license, license_url) and its attribution string.

The catalog: manifest.json

manifest.json lists every pack (manifest_version 1). It is signed: manifest.json.minisig is an ed25519 minisign signature checked against the public key in the repository (keys/minisign.pub), and each pack is checked against the sha256 its entry carries before it is installed. Each entry in packs has these fields:

fielddescription
idStable pack id, e.g. obstacles-conus. A device subscribes to ids.
kindPack kind; decides which reader opens the pack and where it installs.
cycleEdition: an AIRAC cycle (2612), a date (261001) or an edition tag (2026q3r1). A hyphen-suffixed cycle is a test build and never outranks the canonical one.
bytesSize of the pack file.
sha256SHA-256 of the pack file; checked before the pack is installed.
urlWhere to download the pack.
effectiveFirst day the edition is current (ISO date). Absent for packs with no currency window.
expiresFirst day the edition is no longer current (ISO date, exclusive). Absent means it does not expire.
regionsCoverage regions the pack belongs to (see the manifest's regions block).
attributionAttribution text to show the pilot.
licenseShort licence tag for the data (an SPDX id, LicenseRef-*, or e.g. ODbL-1.0). Empty means unspecified.
license_urlLink to the licence's full text.
min_pyefisOldest pyEfis version that can read this pack, when there is one.
tiles_bboxBounding box of the pack's tiles: [lat_min, lon_min, lat_max, lon_max].
report_urlThe pack's test record (pack-report/1), bound to the signature by report_sha256.
report_sha256SHA-256 of that test record.
originWhere the data came from: federal, community or user-supplied. A pedigree label, not a score.
noticeThe standing use notice.
build_commitThe makerplane-data commit that built the pack.

The header inside every pack: pack_meta

A pack still identifies itself when it is copied away from the catalog. Its pack_meta fields are a subset of its manifest entry:

fielddescription
idStable pack id; equals the manifest entry's id.
kindPack kind; equals the manifest entry's kind.
cycleEdition; equals the manifest entry's cycle.
effectiveFirst day current (ISO date); absent for packs with no currency window.
expiresFirst day no longer current (ISO date, exclusive); absent means it does not expire.
attributionAttribution text to show the pilot.
licenseShort licence tag for the data. Empty means unspecified.
license_urlLink to the licence's full text.
pyefis_commitFull pyEfis commit sha whose tools built the pack. Absent for packs built by no pyEfis code and for editions published before CERT5a.
schema_versionVersion of the pack's format (see The contract).

Experimental / Amateur-Built use only. Not certified. This data is provided as-is with no warranty and any use of the data is at your own risk.