RapidAPI logo

Great Circle Mapper

FREEMIUM
By marcusgoede
Updated 6 months ago
Travel
8.7/10
Popularity Score
159ms
Latency
93%
Success Rate

Great Circle Mapper API Documentation

Use Great Circle Mapper to calculate the air distance and flight time between all airports worldwide.

View API Details
Aviation
GETAir Route Calculation
GETAircraft Type Read
GETAirport Read
GETAirport Search
GETAir Route Calculation

calculate distance and flight time for any airports and any speed

Header Parameters
X-RapidAPI-HostSTRING
REQUIRED
X-RapidAPI-KeySTRING
REQUIRED
varySTRING
REQUIRED
content-typeSTRING
REQUIRED
Required Parameters
speedSTRING
REQUIREDSpeed in kts
routeSTRING
REQUIREDICAO airport cides, separated by hyphens
Code Snippet
unirest.get("https://greatcirclemapper.p.rapidapi.com/airports/route/EGLL-KJFK/510")
.header("X-RapidAPI-Host", "greatcirclemapper.p.rapidapi.com")
.header("X-RapidAPI-Key", "SIGN-UP-FOR-KEY")
.header("vary", "Accept-Encoding")
.header("content-type", "text/html;charset=UTF-8")
.end(function (result) {
  console.log(result.status, result.headers, result.body);
});
Sample Response
General
Request URL: https://greatcirclemapper.p.rapidapi.com/airports/route/{route}/{speed}
Request Method: GET
Response Headers
"accept-ranges": "none"
"content-type": "text/html;charset=UTF-8"
"date": "Wed, 24 Jul 2019 18:38:32 GMT"
"server": "RapidAPI-1.0.20"
"vary": "Accept-Encoding"
"x-rapidapi-region": "AWS - us-east-1"
"x-rapidapi-version": "1.0.20"
"content-length": "1105"
"connection": "Close"
Response Body
{"totals":{"distance_km":5554.53,"distance_nm":2999.21,"flight_time_min":372.85,"speed_kmh":944.52,"speed_kts":"510"},"legs":[{"origin":{"id":"2434","ident":"EGLL","name":"London Heathrow Airport","elevation_ft":"83.00","icao_code":"EGLL","iata_code":"LHR","alias":"LHR-EGLL-london-heathrow-airport","latitude_deg":"51.4706001282","longitude_deg":"-0.4619410038","latitude_minsec":"51°28'14\"N","longitude_minsec":"0°27'42\"W","link":"http:\/\/www.greatcirclemapper.net\/en\/airport\/LHR-EGLL-london-heathrow-airport.html"},"destination":{"id":"3622","ident":"KJFK","name":"John F Kennedy International Airport","elevation_ft":"13.00","icao_code":"KJFK","iata_code":"JFK","alias":"JFK-KJFK-john-f-kennedy-international-airport","latitude_deg":"40.6398010300","longitude_deg":"-73.7789001500","latitude_minsec":"40°38'23\"N","longitude_minsec":"73°46'44\"W","link":"http:\/\/www.greatcirclemapper.net\/en\/airport\/JFK-KJFK-john-f-kennedy-international-airport.html"},"distance_km":5554.53,"distance_nm":2999.21,"flight_time_min":373,"heading_deg":287.93693010005,"heading_compass":"WNW"}]}

Install SDK for NodeJS

Installing

To utilize unirest for node.js install the the npm module:

$ npm install unirest

After installing the npm package you can now start simplifying requests like so:

var unirest = require('unirest');

Creating Request

unirest.get("https://greatcirclemapper.p.rapidapi.com/airports/route/EGLL-KJFK/510")
.header("X-RapidAPI-Host", "greatcirclemapper.p.rapidapi.com")
.header("X-RapidAPI-Key", "SIGN-UP-FOR-KEY")
.header("vary", "Accept-Encoding")
.header("content-type", "text/html;charset=UTF-8")
.end(function (result) {
  console.log(result.status, result.headers, result.body);
});
OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication