Closest point of approach API

Computes closest point of approach (CPA) distance and time-to-CPA (TCPA) for own vessel versus a contact given bearing, range, course and speed. Answers 'How close will that ship pass and when?', 'Are we on a collision course?'.

Price$0.08per request

MethodPOST

Route/v1/nav/cpa-tcpa

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

marinecpatcpacollision-avoidanceradararpanavigationcontact

API URLhttps://x402.hexl.dev/v1/nav/cpa-tcpa

Integration docs

Example request

{
  "ownCourseDeg": 0,
  "ownSpeedKt": 20,
  "targetBearingDeg": 45,
  "targetRangeNm": 10,
  "targetCourseDeg": 270,
  "targetSpeedKt": 20
}

Example response

{
  "cpaNm": 0,
  "tcpaHr": 0.3536,
  "tcpaMin": 21.2,
  "relativeSpeedKt": 28.28,
  "relativeCourseDeg": 225,
  "closing": true,
  "interpretation": "CPA 0 nm in 21.2 min (TCPA)."
}

Input schema

{
  "type": "object",
  "required": [
    "ownCourseDeg",
    "ownSpeedKt",
    "targetBearingDeg",
    "targetRangeNm",
    "targetCourseDeg",
    "targetSpeedKt"
  ],
  "properties": {
    "ownCourseDeg": {
      "type": "number",
      "examples": [
        0
      ]
    },
    "ownSpeedKt": {
      "type": "number",
      "examples": [
        20
      ]
    },
    "targetBearingDeg": {
      "type": "number",
      "examples": [
        45
      ]
    },
    "targetRangeNm": {
      "type": "number",
      "examples": [
        10
      ]
    },
    "targetCourseDeg": {
      "type": "number",
      "examples": [
        270
      ]
    },
    "targetSpeedKt": {
      "type": "number",
      "examples": [
        20
      ]
    }
  }
}

Output schema

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