airport-dist 1.0.0 → 1.1.0

package/README.md

@@ -23,7 +23,7 @@ airport-dist -f LHR -t DXB
 The tool provides two distance measurements:
 
 1. **Geographical Distance** - Great circle (Haversine) distance, the shortest path between two points on Earth
-2. **Aviation Route Distance** - Estimated actual flight distance accounting for airways, waypoints, and routing factors
+2. **Aviation Route Distance** - Actual airline route distance from bundled route database (55,000+ routes)
 
 ```
 Calculating distances from JFK to LAX...
@@ -42,10 +42,10 @@ DISTANCE RESULTS
    2145.97 nautical miles
 
 2. AVIATION ROUTE DISTANCE:
-   4173.05 km
-   2593.01 miles
-   2253.27 nautical miles
-   Source: Calculated (Great Circle + industry routing factors)
+   3982.00 km
+   2474.30 miles
+   2150.11 nautical miles
+   Source: Airline route data (bundled)
 
 ============================================================
 
@@ -62,18 +62,17 @@ airways, restricted airspace, weather patterns, and traffic flow.
 | `--version` | `-V` | Show version number |
 | `--help` | `-h` | Show help |
 
-## Supported Airports
+## Data Sources
 
-The tool includes a built-in database of 150+ major international airports. If an airport is not in the database, it will attempt to fetch the data from a public API.
+- **Airport Database**: 150+ major international airports with coordinates
+- **Route Database**: 55,000+ airline routes with actual distances from [Jonty/airline-route-data](https://github.com/Jonty/airline-route-data)
+- **Fallback**: Estimation using industry-standard routing factors when route not in database
 
 ## How It Works
 
 - **Geographical Distance**: Calculated using the Haversine formula, which determines the great-circle distance between two points on a sphere given their latitudes and longitudes.
 
-- **Aviation Route Distance**: Estimated using industry-standard routing factors that account for:
-  - Airways and waypoint requirements
-  - Departure/arrival procedures (SIDs/STARs)
-  - Distance-based overhead (shorter flights have proportionally higher overhead)
+- **Aviation Route Distance**: Sourced from bundled airline route data containing actual flight distances. Falls back to estimation for routes not in the database.
 
 ## License
 

package/dist/aviation-api.d.ts

@@ -1,13 +1,7 @@
 /**
  * Aviation route distance module.
- * Calculates estimated flight route distances based on industry-standard factors.
- *
- * Aviation routes differ from great circle distances due to:
- * - Airways and waypoint requirements
- * - Restricted airspace avoidance
- * - Departure/arrival procedures (SIDs/STARs)
- * - Jet streams and wind optimization
- * - Traffic flow management
+ * Uses bundled airline route data from https://github.com/Jonty/airline-route-data
+ * Falls back to estimation when route is not in database.
  */
 import { Distance } from "./haversine";
 export interface AviationDistance extends Distance {
@@ -15,7 +9,7 @@ export interface AviationDistance extends Distance {
 }
 /**
  * Get the aviation route distance between two airports.
- * Uses industry-standard routing factors to estimate actual flight distance.
+ * First checks bundled route database, then falls back to estimation.
  */
 export declare function getAviationRouteDistance(fromIata: string, toIata: string, geoDistance: Distance): AviationDistance;
 //# sourceMappingURL=aviation-api.d.ts.map

package/dist/aviation-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aviation-api.d.ts","sourceRoot":"","sources":["../src/aviation-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKvC,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,QAAQ,GACpB,gBAAgB,CASlB"}
+{"version":3,"file":"aviation-api.d.ts","sourceRoot":"","sources":["../src/aviation-api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAMvC,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,QAAQ,GACpB,gBAAgB,CAoClB"}

package/dist/aviation-api.js

@@ -1,96 +1,70 @@
 "use strict";
 /**
  * Aviation route distance module.
- * Calculates estimated flight route distances based on industry-standard factors.
- *
- * Aviation routes differ from great circle distances due to:
- * - Airways and waypoint requirements
- * - Restricted airspace avoidance
- * - Departure/arrival procedures (SIDs/STARs)
- * - Jet streams and wind optimization
- * - Traffic flow management
+ * Uses bundled airline route data from https://github.com/Jonty/airline-route-data
+ * Falls back to estimation when route is not in database.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAviationRouteDistance = getAviationRouteDistance;
+const route_data_1 = require("./route-data");
 const KM_TO_MILES = 0.621371;
 const KM_TO_NAUTICAL_MILES = 0.539957;
 /**
  * Get the aviation route distance between two airports.
- * Uses industry-standard routing factors to estimate actual flight distance.
+ * First checks bundled route database, then falls back to estimation.
  */
 function getAviationRouteDistance(fromIata, toIata, geoDistance) {
-    const estimatedKm = estimateAviationDistance(geoDistance.km, fromIata, toIata);
+    // Try to find route in bundled database
+    const routeKey = `${fromIata}-${toIata}`;
+    const bundledDistance = route_data_1.ROUTE_DISTANCES[routeKey];
+    if (bundledDistance) {
+        return {
+            km: bundledDistance,
+            miles: bundledDistance * KM_TO_MILES,
+            nauticalMiles: bundledDistance * KM_TO_NAUTICAL_MILES,
+            source: "Airline route data (bundled)",
+        };
+    }
+    // Try reverse route (some routes may only be listed one direction)
+    const reverseKey = `${toIata}-${fromIata}`;
+    const reverseDistance = route_data_1.ROUTE_DISTANCES[reverseKey];
+    if (reverseDistance) {
+        return {
+            km: reverseDistance,
+            miles: reverseDistance * KM_TO_MILES,
+            nauticalMiles: reverseDistance * KM_TO_NAUTICAL_MILES,
+            source: "Airline route data (bundled)",
+        };
+    }
+    // Fallback to estimation
+    const estimatedKm = estimateAviationDistance(geoDistance.km);
     return {
         km: estimatedKm,
         miles: estimatedKm * KM_TO_MILES,
         nauticalMiles: estimatedKm * KM_TO_NAUTICAL_MILES,
-        source: "Calculated (Great Circle + industry routing factors)",
+        source: "Estimated (Great Circle + routing factors)",
     };
 }
 /**
- * Known route corrections for specific airport pairs.
- * These are based on published flight distances from airlines and aviation authorities.
- * Values represent the multiplier to apply to great circle distance.
+ * Estimate aviation distance when not in bundled database.
+ * Based on industry-standard routing overhead factors.
  */
-const ROUTE_CORRECTIONS = {
-    // Transatlantic routes (North Atlantic Tracks add distance)
-    "JFK-LHR": 1.02,
-    "LHR-JFK": 1.02,
-    "LAX-LHR": 1.03,
-    "LHR-LAX": 1.03,
-    // Transpacific routes
-    "LAX-NRT": 1.02,
-    "NRT-LAX": 1.02,
-    "SFO-HKG": 1.03,
-    "HKG-SFO": 1.03,
-    // Routes avoiding restricted airspace
-    "LHR-SIN": 1.04,
-    "SIN-LHR": 1.04,
-    "DXB-JFK": 1.03,
-    "JFK-DXB": 1.03,
-};
-/**
- * Estimate aviation distance based on great circle distance and routing factors.
- *
- * The estimation uses several factors:
- * 1. Base routing overhead (airways, waypoints)
- * 2. Distance-based adjustments (short flights have proportionally more overhead)
- * 3. Known route corrections for specific airport pairs
- */
-function estimateAviationDistance(greatCircleKm, fromIata, toIata) {
-    // Check for known route corrections first
-    const routeKey = `${fromIata}-${toIata}`;
-    const knownCorrection = ROUTE_CORRECTIONS[routeKey];
-    if (knownCorrection) {
-        return greatCircleKm * knownCorrection;
-    }
-    // Calculate base factor based on distance
-    // Industry data shows:
-    // - Very short flights (<500km): ~10% overhead due to SID/STAR procedures
-    // - Short flights (500-1500km): ~7% overhead
-    // - Medium flights (1500-5000km): ~5% overhead
-    // - Long-haul flights (5000-10000km): ~4% overhead
-    // - Ultra long-haul (>10000km): ~3% overhead (more optimized routing)
+function estimateAviationDistance(greatCircleKm) {
     let factor;
     if (greatCircleKm < 500) {
-        // Very short flights - significant overhead from departure/arrival procedures
-        factor = 1.10;
+        factor = 1.10; // 10% overhead for very short flights
     }
     else if (greatCircleKm < 1500) {
-        // Short regional flights
-        factor = 1.07;
+        factor = 1.07; // 7% for short regional flights
     }
     else if (greatCircleKm < 5000) {
-        // Medium-haul flights
-        factor = 1.05;
+        factor = 1.05; // 5% for medium-haul
     }
     else if (greatCircleKm < 10000) {
-        // Long-haul flights - more optimized but still need to follow airways
-        factor = 1.04;
+        factor = 1.04; // 4% for long-haul
     }
     else {
-        // Ultra long-haul - highly optimized great circle routing
-        factor = 1.03;
+        factor = 1.03; // 3% for ultra long-haul
     }
     return greatCircleKm * factor;
 }

package/dist/aviation-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"aviation-api.js","sourceRoot":"","sources":["../src/aviation-api.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAeH,4DAaC;AAxBD,MAAM,WAAW,GAAG,QAAQ,CAAC;AAC7B,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAMtC;;;GAGG;AACH,SAAgB,wBAAwB,CACtC,QAAgB,EAChB,MAAc,EACd,WAAqB;IAErB,MAAM,WAAW,GAAG,wBAAwB,CAAC,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE/E,OAAO;QACL,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,WAAW,GAAG,WAAW;QAChC,aAAa,EAAE,WAAW,GAAG,oBAAoB;QACjD,MAAM,EAAE,sDAAsD;KAC/D,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,iBAAiB,GAA2B;IAChD,4DAA4D;IAC5D,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IAEf,sBAAsB;IACtB,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IAEf,sCAAsC;IACtC,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF;;;;;;;GAOG;AACH,SAAS,wBAAwB,CAC/B,aAAqB,EACrB,QAAgB,EAChB,MAAc;IAEd,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC;IACzC,MAAM,eAAe,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACpD,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,aAAa,GAAG,eAAe,CAAC;IACzC,CAAC;IAED,0CAA0C;IAC1C,uBAAuB;IACvB,0EAA0E;IAC1E,6CAA6C;IAC7C,+CAA+C;IAC/C,mDAAmD;IACnD,sEAAsE;IAEtE,IAAI,MAAc,CAAC;IAEnB,IAAI,aAAa,GAAG,GAAG,EAAE,CAAC;QACxB,8EAA8E;QAC9E,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;SAAM,IAAI,aAAa,GAAG,IAAI,EAAE,CAAC;QAChC,yBAAyB;QACzB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;SAAM,IAAI,aAAa,GAAG,IAAI,EAAE,CAAC;QAChC,sBAAsB;QACtB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;SAAM,IAAI,aAAa,GAAG,KAAK,EAAE,CAAC;QACjC,sEAAsE;QACtE,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;SAAM,CAAC;QACN,0DAA0D;QAC1D,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,aAAa,GAAG,MAAM,CAAC;AAChC,CAAC"}
+{"version":3,"file":"aviation-api.js","sourceRoot":"","sources":["../src/aviation-api.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAgBH,4DAwCC;AArDD,6CAA+C;AAE/C,MAAM,WAAW,GAAG,QAAQ,CAAC;AAC7B,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAMtC;;;GAGG;AACH,SAAgB,wBAAwB,CACtC,QAAgB,EAChB,MAAc,EACd,WAAqB;IAErB,wCAAwC;IACxC,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC;IACzC,MAAM,eAAe,GAAG,4BAAe,CAAC,QAAQ,CAAC,CAAC;IAElD,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,eAAe,GAAG,WAAW;YACpC,aAAa,EAAE,eAAe,GAAG,oBAAoB;YACrD,MAAM,EAAE,8BAA8B;SACvC,CAAC;IACJ,CAAC;IAED,mEAAmE;IACnE,MAAM,UAAU,GAAG,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC;IAC3C,MAAM,eAAe,GAAG,4BAAe,CAAC,UAAU,CAAC,CAAC;IAEpD,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,eAAe,GAAG,WAAW;YACpC,aAAa,EAAE,eAAe,GAAG,oBAAoB;YACrD,MAAM,EAAE,8BAA8B;SACvC,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,MAAM,WAAW,GAAG,wBAAwB,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAE7D,OAAO;QACL,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,WAAW,GAAG,WAAW;QAChC,aAAa,EAAE,WAAW,GAAG,oBAAoB;QACjD,MAAM,EAAE,4CAA4C;KACrD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,wBAAwB,CAAC,aAAqB;IACrD,IAAI,MAAc,CAAC;IAEnB,IAAI,aAAa,GAAG,GAAG,EAAE,CAAC;QACxB,MAAM,GAAG,IAAI,CAAC,CAAC,sCAAsC;IACvD,CAAC;SAAM,IAAI,aAAa,GAAG,IAAI,EAAE,CAAC;QAChC,MAAM,GAAG,IAAI,CAAC,CAAC,gCAAgC;IACjD,CAAC;SAAM,IAAI,aAAa,GAAG,IAAI,EAAE,CAAC;QAChC,MAAM,GAAG,IAAI,CAAC,CAAC,qBAAqB;IACtC,CAAC;SAAM,IAAI,aAAa,GAAG,KAAK,EAAE,CAAC;QACjC,MAAM,GAAG,IAAI,CAAC,CAAC,mBAAmB;IACpC,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,IAAI,CAAC,CAAC,yBAAyB;IAC1C,CAAC;IAED,OAAO,aAAa,GAAG,MAAM,CAAC;AAChC,CAAC"}

package/dist/route-data.d.ts

@@ -0,0 +1,2 @@
+export declare const ROUTE_DISTANCES: Record<string, number>;
+//# sourceMappingURL=route-data.d.ts.map

package/dist/route-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-data.d.ts","sourceRoot":"","sources":["../src/route-data.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAko0xB,CAAC"}