Initial & final geodesic bearing API

Returns the initial (forward) and final (reverse) azimuths of the geodesic between two points on the WGS-84 ellipsoid, plus 16-point compass labels. The bearing changes along a geodesic, so both endpoints differ. Answers 'What heading do I depart on and arrive at?', 'What is the final bearing at the destination?'.

Price$0.04per request

MethodPOST

Route/v1/geo/vincenty-bearing

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

geogisbearingazimuthvincentygeodesicheadingnavigationcompass

API URLhttps://x402.hexl.dev/v1/geo/vincenty-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
  },
  "ellipsoid": "WGS-84",
  "initialBearing": 148.045928,
  "finalBearing": 149.951405,
  "initialCompass": "SSE",
  "finalCompass": "SSE",
  "interpretation": "Depart on bearing 148.046° (SSE); arrive heading 149.951° (SSE). The bearing rotates along a geodesic."
}

Input schema

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

Output schema

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