Range & bearing to target API

Combined Vincenty rangefinder: returns the ellipsoidal distance (km and nautical miles), the initial compass bearing and the final bearing from an observer to a target — the navigation/targeting pair in one call. Answers 'How far and in what direction is the target?', 'What range and heading do I set to reach a point?'.

Price$0.04per request

MethodPOST

Route/v1/geo/range-bearing

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

geogisrangebearingvincentynavigationtargetingrangefindernautical-miles

API URLhttps://x402.hexl.dev/v1/geo/range-bearing

Integration docs

Example request

{
  "from": {
    "latitude": 51.5074,
    "longitude": -0.1278
  },
  "to": {
    "latitude": 48.8566,
    "longitude": 2.3522
  }
}

Example response

{
  "from": {
    "latitude": 51.5074,
    "longitude": -0.1278
  },
  "to": {
    "latitude": 48.8566,
    "longitude": 2.3522
  },
  "rangeKm": 343.92312,
  "rangeNauticalMiles": 185.703629,
  "bearing": 148.045928,
  "compass": "SSE",
  "finalBearing": 149.951405,
  "interpretation": "Target is 343.923 km (185.704 nm) away at bearing 148.046° (SSE). Combined Vincenty range + bearing for navigation/targeting."
}

Input schema

{
  "type": "object",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "from": {
      "type": "object",
      "properties": {
        "latitude": {
          "type": "number"
        },
        "longitude": {
          "type": "number"
        }
      },
      "examples": [
        {
          "latitude": 51.5074,
          "longitude": -0.1278
        }
      ]
    },
    "to": {
      "type": "object",
      "properties": {
        "latitude": {
          "type": "number"
        },
        "longitude": {
          "type": "number"
        }
      },
      "examples": [
        {
          "latitude": 48.8566,
          "longitude": 2.3522
        }
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}