Catalog/nav-set-and-drift

Navigation

Marine set & drift API

Solves the current triangle for set (current direction) and drift (current speed) from heading/speed through water versus course/speed over ground. Answers 'What current set and drift explain my actual track?', 'How strong is the current pushing my boat off course?'.

Price$0.06per request
MethodPOST
Route/v1/nav/set-and-drift
StatusLive
MIME typeapplication/json
Rate limit120/minute
Cache0s public
marineset-driftcurrentnavigationsailingleewayvectorground-track
API URLhttps://x402.hexl.dev/v1/nav/set-and-drift
Integration docs
Example request
{
  "headingDeg": 90,
  "speedThroughWaterKt": 10,
  "courseOverGroundDeg": 100,
  "speedOverGroundKt": 10.5
}
Example response
{
  "setDeg": 169.4,
  "driftKt": 1.85,
  "interpretation": "Current sets toward 169 deg at 1.85 kt (drift). It is pushing you off heading."
}
Input schema
{
  "type": "object",
  "required": [
    "headingDeg",
    "speedThroughWaterKt",
    "courseOverGroundDeg",
    "speedOverGroundKt"
  ],
  "properties": {
    "headingDeg": {
      "type": "number",
      "examples": [
        90
      ]
    },
    "speedThroughWaterKt": {
      "type": "number",
      "examples": [
        10
      ]
    },
    "courseOverGroundDeg": {
      "type": "number",
      "examples": [
        100
      ]
    },
    "speedOverGroundKt": {
      "type": "number",
      "examples": [
        10.5
      ]
    }
  }
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}