volo-great-circle

Great-circle distance, bearing and midpoint between coordinates — the haversine math behind every flight-distance estimate. Zero dependencies.

Part of VOLO's open aviation toolkit.

Install

npm install volo-great-circle

const { distance, bearing } = require("volo-great-circle");

const JFK = { lat: 40.6413, lon: -73.7781 };
const LHR = { lat: 51.4700, lon: -0.4543 };

distance(JFK, LHR, "nm"); // → 2991  (nautical miles)
distance(JFK, LHR, "km"); // → 5540
bearing(JFK, LHR);        // → 51    (degrees, initial bearing)

API

| Function | Returns | |---|---| | distance(a, b, unit?) | great-circle distance — unit ∈ "nm" \| "km" \| "mi" \| "m" (default nm) | | bearing(a, b) | initial bearing in degrees (0–360) | | midpoint(a, b) | { lat, lon } of the great-circle midpoint |

Points are { lat, lon } in decimal degrees.

About

Built by VOLO — the world's first agent-native private aviation platform. See more open tools and the live charter API at flyvolo.ai/open-source.

License

MIT © VOLO Technologies Pte. Ltd.