Neptun·

Tidal currents

Set & drift — direction and rate of the tidal stream at a point.

GET /v1/currents

Scope: currents

Three tiers, best first. Where an official NOAA current station lies within 5 km (United States, about 2,600 stations), slack and maximum times come from there — the stream changes quickly over short distances, hence the tight limit; `station=` pins a specific station (see current stations). On the French Channel and Atlantic coast the SHOM tidal stream atlases apply (14 atlases, grids down to 30 m: English Channel, Channel Islands, Brittany, Bay of Biscay); `atlas` gives atlas, reference port, grid and coefficient. The atlases are official, their timing is not: high water at the reference port and the coefficient come from our model (`timing: model`, checked against published times to 0–7 min). Everywhere else FES2014a (depth-averaged, ~7 km grid — too weak in narrow passages). Decisive for passage planning: the stream sets your course to steer and, over a day, often more miles than the wind does.

Parameters

NameTypeDescription
latnumber, requiredLatitude (−90…90)
lonnumber, requiredLongitude (−180…180)
hoursinteger, optionalHours to look ahead
langstring, optionalLanguage (de · en) of the notice texts or the attribution
sourcestring, optionalFilter by source, comma-separated

Example response

{ "ok": true, "source": "shom", "confidence": "official", "timing": "model", "unit": "kn",
  "atlas": { "name": "GOLFE-NORM-BRET-562-500M-1h", "ref_port": "Saint-Malo", "ref_event": "HW",
             "resolution": "500M", "coefficient_now": 66 },
  "series": [ { "ts": 1794578400, "speed_kn": 3.84, "set_deg": 188 }, … ],
  "extremes": [ { "ts": 1794564600, "typ": "max", "speed_kn": 5.63, "set_deg": 350 }, … ],
  "attribution": "Currents: Shom, Atlas de courants de marée 2D (Licence Ouverte 2.0) …", "quota": { … } }