arc.js
Calculate great circle routes as lines in GeoJSON or WKT format.
🌍 Try the interactive demo - Click to plot great circle arcs on a map!
Features:
Full TypeScript support with type definitions
Works in Node.js and browsers
Generates GeoJSON and WKT output formats
Handles dateline crossing automatically
Based on Ed Williams' Aviation Formulary algorithms
Installation
Quick Start
import { GreatCircle } from 'arc' ;
const gc = new GreatCircle ({x: - 122 , y: 48 }, {x: - 77 , y: 39 });
const line = gc. Arc (); // npoints is optional, defaults to 100
console. log (line. json ()); // GeoJSON output copy
TypeScript
import { GreatCircle, CoordinatePoint } from 'arc' ;
const start : CoordinatePoint = { x: - 122 , y: 48 };
const end : CoordinatePoint = { x: - 77 , y: 39 };
const gc = new GreatCircle (start, end);
const line = gc. Arc ( 100 ); copy
Browser (ESM)
< script type = "module" >
import { GreatCircle } from 'https://cdn.skypack.dev/arc@1' ;
const gc = new GreatCircle ({x: - 122 , y: 48 }, {x: - 77 , y: 39 });
const line = gc. Arc ();
</ script > copy
API Reference
Basic Usage
1. Define coordinates
Coordinates use x for longitude and y for latitude (both in degrees):
const start = { x: - 122 , y: 48 }; // Seattle
const end = { x: - 77 , y: 39 }; // Washington DC copy
2. Create a GreatCircle
const gc = new GreatCircle (start, end, { name: 'Seattle to DC' }); copy
3. Generate the arc
const line = gc. Arc (); // defaults to 100 points
const line = gc. Arc ( 500 ); // or specify a custom value copy
Parameters:
npoints (number, optional): Number of intermediate points (higher = more precise, default: 100)
TypeScript Support
import { GreatCircle, CoordinatePoint, ArcOptions } from 'arc' ;
// Define custom properties interface
interface RouteProperties {
name : string ;
color ?: string ;
}
const start : CoordinatePoint = { x: - 122 , y: 48 };
const end : CoordinatePoint = { x: - 77 , y: 39 };
const properties : RouteProperties = { name: 'Seattle to DC' , color: 'blue' };
const gc = new GreatCircle (start, end, properties);
Available Types: CoordinatePoint, ArcOptions, Coord, GreatCircle, Arc, GeoJSONFeature
Raw Arc Object
The generated arc contains intermediate coordinate pairs:
{
properties : { name : 'Seattle to DC' },
geometries : [
{
coords: [
[ - 122 , 48 ],
[ - 112.06162 , 47.724167 ],
[ - 102.384043 , 46.608132 ],
[ - 93.227189 , 44.716217 ],
[ - 84.74824 , 42.144155 ],
[ - 77 , 39 ]
],
length: 6
}
]
} copy
const geojson = line. json ();
// Returns:
{
type : 'Feature' ,
geometry : {
type : 'LineString' ,
coordinates : [[ - 122 , 48 ], [ - 112.06162 , 47.724167 ], ... ]
},
properties : { name : 'Seattle to DC' }
} copy
const wkt = line. wkt ();
// Returns:
'LINESTRING(-122 48,-112.061619 47.724167,-102.384043 46.608131,...)' copy
Dateline Crossing
Routes that cross the international dateline are automatically detected and split into a MultiLineString with exact ±180° boundary points. No configuration is needed.
Examples
See the interactive demo for sample code showing how to create GeoJSON feature collections from multiple routes.
Used in Turf.js
arc.js powers the greatCircle function in Turf.js , a popular geospatial JavaScript library. You can use great circle calculations directly through Turf:
License
This project is licensed under the BSD license. See LICENSE.md for details.