turf great-circle module

Usage no npm install needed!

<script type="module">
  import turfGreatCircle from 'https://cdn.skypack.dev/@turf/great-circle';




Calculate great circles routes as LineString or MultiLineString. If the start and end points span the antimeridian, the resulting feature will be split into a MultiLineString.


  • start Coord source point feature
  • end Coord destination point feature
  • options Object Optional parameters (optional, default {})
    • options.properties Object line feature properties (optional, default {})
    • options.npoints number number of points (optional, default 100)
    • options.offset number offset controls the likelyhood that lines will be split which cross the dateline. The higher the number the more likely. (optional, default 10)


var start = turf.point([-122, 48]);
var end = turf.point([-77, 39]);

var greatCircle = turf.greatCircle(start, end, {properties: {name: 'Seattle to DC'}});

var addToMap = [start, end, greatCircle]

Returns Feature<(LineString | MultiLineString)> great circle line feature

This module is part of the Turfjs project, an open source module collection dedicated to geographic algorithms. It is maintained in the Turfjs/turf repository, where you can create PRs and issues.


Install this module individually:

$ npm install @turf/great-circle

Or install the Turf module that includes it as a function:

$ npm install @turf/turf