Neptun·

Reviermeldungen

Amtliche Bekanntmachungen für die Schifffahrt aus 106 Quellen.

GET /v1/warnings

Scope: notices

Nachrichten für Seefahrer, Navigationswarnungen, Sperrungen und Baustellen — aus 106 nationalen Diensten, verortet, entdoppelt und auf Wunsch übersetzt. Genau die Arbeit, die man sonst für jedes Land einzeln machen müsste. Seit dem 29.10.2026 trägt jede Meldung drei einheitliche Angaben über alle Quellen: `kind` (Art, z. B. closure, works, event, military_exercise, search_and_rescue), `validity` (fixed = mit Enddatum, indefinite = bis auf Weiteres) und `position` — woher die Koordinate stammt: exact (von der Quelle), text (aus dem Meldungstext), waterway_km (Wasserstraßen-Kilometer), seamark (auf das Seezeichen gesetzt), place (Ortssuche), area (Gebietsmitte), water (ins nächste Wasser verlegt), none. `category` bleibt unverändert. `valid_from` ist der Beginn laut Quelle — nennt die Quelle keinen, bleibt das Feld leer. Größere Gebiete: `limit` bis 1000 und mit `next_offset` blättern, solange `has_more` true ist. Seit dem 15.11.2026 trägt jede Meldung `geometry`: ein GeoJSON-Polygon oder -MultiPolygon, wenn die Behörde Eckpunkte, einen Kasten oder einen Radius nennt (Sperr- und Warngebiete), sonst `null`. Neptun-Boating-Schlüssel (Neptun K-Boating und P-Boating, siehe /de/plotter/) fragen nur nach Bootsposition (`lat`+`lon`, Radius höchstens 200 km) und bekommen die Meldungen ihrer gebundenen Reviere; die Antwort trägt `plotter` mit Revier, gebundenen Revieren und Grenze. Ist die Grenze erreicht, antwortet die API mit `403` und `detail.error = region_limit`. Gebunden wird das Seerevier am Standort; Binnenreviere dort kommen ohne Zählung dazu (`plotter.included`), Meldungen aus Nachbarrevieren bis 3 sm um die Position ebenfalls (`plotter.nearby_nm`). Antworten an Neptun-Boating-Schlüssel tragen ein `ETag`; mit `If-None-Match` kommt bei unverändertem Stand `304` ohne Inhalt.

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)
langstring, optionalSprache (de · en) der Meldungstexte bzw. der Quellenangabe
sourcestring, optionalQuellen filtern, kommagetrennt
closed_onlyboolean, optionalnur Sperrungen
sinceinteger, optionalnur Änderungen ab diesem Unix-Zeitstempel
limitinteger, optionalTreffer je Abruf — Standard 200, höchstens 1000
offsetinteger, optionalBlättern: `next_offset` der vorigen Antwort einsetzen, solange `has_more` true ist
exact_onlyboolean, optionalnur Meldungen mit genauer Position (ohne Gebiets-/Ortsangaben, `coarse`)

Beispiel-Antwort

{ "count": 1, "warnings": [ { "id": "nfb-2026/2623", "source": "elwis", "regions": ["de-binnen"],
    "lat": 53.27442, "lon": 12.98869, "coarse": false, "place": "Schleuse Wesenberg",
    "fairway": "Obere Havel-Wasserstraße, km 81,7–81,8", "detail": "…",
    "category": "closure", "kind": "water_level", "validity": "fixed", "position": "waterway_km",
    "closed": true, "valid_from": 1789084800, "valid_until": 1796083199, "link": "…",
    "geometry": null } ],
  "attribution": "…", "quota": { … } }