Neptun·

← API-Referenz

Pegel & Messstationen

Gemessene Wasserstände, Wellen und Wassertemperatur aus amtlichen Netzen.

GET /v1/levels

Scope: levels

Gemessen, nicht gerechnet. Neptun führt zehn nationale Netze zusammen — darunter PEGELONLINE (DE), Rijkswaterstaat (NL), SMHI (SE), FMI (FI), Environment Agency (UK), Puertos del Estado (ES), Marine Institute (IE) und NDBC (US) — auf ein Format. An der deutschen Küste kommt die amtliche Wasserstandsvorhersage des Bundes dazu (BSH, §1 SeeAufG): forecast nennt den Stand über oder unter Mittelwasser, den Bezug auf Seekartennull, den Windstau gegenüber der astronomischen Vorhersage und die nächsten Hoch- und Niedrigwasser — mit forecast=full zusätzlich die Vorhersagekurve in Stundenwerten, 72 Stunden voraus.

Parameter

NameTypBeschreibung
bboxstring, optionalGebiet als minLat,minLon,maxLat,maxLon
latnumber, optionalBreite (−90…90)
lonnumber, optionalLänge (−180…180)
radiusnumber, optionalUmkreis in km (bei lat/lon)
sourcestring, optionalQuellen filtern, kommagetrennt
forecaststring, optionalWasserstandsvorhersage: off · summary (Standard) · full (mit Kurve)
limitinteger, optionalmaximale Trefferzahl
offsetinteger, optionalVersatz für Blättern

Beispiel-Antwort

{ "count": 1, "levels": [ { "id": "cuxhaven_steubenhoeft", "name": "Cuxhaven",
    "value": 354, "unit": "cm", "datum": "PN", "source": "BSH", "measured": 1789463400,
    "forecast": { "mean_water": 511, "vs_mean_water": -157, "above_chart_datum": 52, "surge": 7,
      "events": [ { "type": "HW", "time": 1789483020, "value": 686, "astronomical": 681 } ] } } ],
  "attribution": "…", "quota": { … } }