Module @squawk/airway-data
@squawk/airway-data
Pre-processed snapshot of US airway data from the 2026-04-16 FAA NASR
cycle. Data only - no query logic, no dependency on
@squawk/airways.
Part of the @squawk aviation library suite. See all packages on npm.
Coverage
- Victor airways (V1, V16, etc.) - VOR-based low-altitude routes
- Jet routes (J1, J60, etc.) - high-altitude IFR routes
- RNAV Q-routes (Q1, Q102, etc.) - GPS-based high-altitude routes
- RNAV T-routes (T238, T270, etc.) - GPS-based low-altitude routes
- Colored airways (Green, Red, Amber, Blue) - Alaska and other regions
- Oceanic routes (Atlantic, Bahama, Pacific, Puerto Rico)
- Full waypoint sequences with ordered fix/navaid references
- MEA, MOCA, MAA, MCA, and GNSS MEA altitude restrictions per segment
- Distance to next waypoint in nautical miles
- Magnetic course and changeover point data
- Signal gap and US airspace-only indicators
Installation
npm install @squawk/airway-data
Usage
import { usBundledAirways } from '@squawk/airway-data';
// Inspect metadata
console.log(usBundledAirways.properties.nasrCycleDate); // "2026-01-22"
console.log(usBundledAirways.properties.recordCount);
console.log(usBundledAirways.properties.waypointCount);
// Use with @squawk/airways for zero-config airway queries
import { createAirwayResolver } from '@squawk/airways';
const resolver = createAirwayResolver({ data: usBundledAirways.records });
Consumers who have their own data pipeline can use @squawk/airways alone and
pass any compatible Airway array at initialization.
Data format
Each record is a full Airway object from @squawk/types. Key fields:
| Property | Type | Description |
|---|---|---|
designation |
string | Airway designation (e.g. "V16", "J60", "Q1", "ATA315") |
type |
AirwayType | VICTOR, JET, RNAV_Q, RNAV_T, GREEN, RED, ATLANTIC, etc. |
region |
AirwayRegion | US, ALASKA, or HAWAII |
waypoints |
AirwayWaypoint[] | Ordered waypoint sequence (west-to-east / south-to-north) |
Each AirwayWaypoint contains:
| Property | Type | Description |
|---|---|---|
name |
string | Waypoint name |
identifier |
string or undefined | Short identifier (e.g. "BOS", "MERIT") |
waypointType |
AirwayWaypointType | NAVAID, FIX, WAYPOINT, BORDER, or OTHER |
lat, lon |
number | Decimal degrees |
minimumEnrouteAltitudeFt |
number or undefined | Minimum Enroute Altitude in feet |
maximumAuthorizedAltitudeFt |
number or undefined | Maximum Authorized Altitude in feet |
minimumObstructionClearanceAltitudeFt |
number or undefined | Minimum Obstruction Clearance Altitude |
distanceToNextNm |
number or undefined | Distance to next waypoint in NM |
magneticCourseDeg |
number or undefined | Magnetic course to next waypoint |
Data source
All data is derived from the FAA National Airspace System Resource (NASR) 28-day subscription, which is public domain. Airway data comes from AWY.txt (Victor, Jet, RNAV Q/T, colored airways) and ATS.txt (Atlantic, Bahama, Pacific, Puerto Rico oceanic routes). The build pipeline that produces this dataset lives in tools/build-airway-data.