GET /v1/tides
Scope: tides
Liegt eine amtliche Station höchstens 20 km entfernt, gilt deren Vorhersage: LINZ in Neuseeland (88 Häfen, 273 Nebenhäfen), NOAA in den USA (rund 3.500 Stationen, Bezug MLLW), Rijkswaterstaat in den Niederlanden (87, Bezug NAP) und das BSH an der deutschen Nordsee (82, Bezug LAT). Das BSH sagt rund sechs Tage voraus; danach schließt das Modell an, jedes Extrem nennt seine Quelle, `official_from`/`model_from` den Übergang. `source` nennt die Quelle, `station` Name, Art und Entfernung, `datum` den Höhenbezug. Überall sonst rechnet das harmonische Modell FES2022b für die exakt angefragte Position (`source`: fes, Bezug LAT); `source=model` erzwingt das Modell. Wo das Modell eine Bucht nicht auflöst und wir es gegen veröffentlichte Zeiten geprüft haben, korrigieren wir es und sagen das im Feld `correction` (Rade de Brest: Hochwasser +28 min); wo das nicht geht, steht `confidence: low` mit `limitation` (Seine-Mündung). Geliefert werden der aktuelle Stand, der Trend und die kommenden Extremwerte.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
lat | number, Pflicht | Breite (−90…90) |
lon | number, Pflicht | Länge (−180…180) |
days | integer, optional | Vorhersagezeitraum in Tagen |
lang | string, optional | Sprache (de · en) der Meldungstexte bzw. der Quellenangabe |
source | string, optional | Quellen filtern, kommagetrennt |
Beispiel-Antwort
{
"ok": true, "source": "noaa", "confidence": "official", "datum": "MLLW",
"station": { "id": "noaa-8518750", "name": "NEW YORK (The Battery)", "kind": "standard", "dist_km": 0.5 },
"now": 0.42, "trend": "falling", "extremes": [ { "ts": 1794560880, "typ": "NW", "hoehe": 0.28 } ],
"attribution": "Tide predictions: NOAA CO-OPS …",
"quota": { "used": 3, "limit": 50000, "remaining": 49997 }
}