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
| Name | Typ | Beschreibung |
|---|---|---|
bbox | string, optional | Gebiet als minLat,minLon,maxLat,maxLon |
lat | number, optional | Breite (−90…90) |
lon | number, optional | Länge (−180…180) |
radius | number, optional | Umkreis in km (bei lat/lon) |
lang | string, optional | Sprache (de · en) der Meldungstexte bzw. der Quellenangabe |
source | string, optional | Quellen filtern, kommagetrennt |
closed_only | boolean, optional | nur Sperrungen |
since | integer, optional | nur Änderungen ab diesem Unix-Zeitstempel |
limit | integer, optional | Treffer je Abruf — Standard 200, höchstens 1000 |
offset | integer, optional | Blättern: `next_offset` der vorigen Antwort einsetzen, solange `has_more` true ist |
exact_only | boolean, optional | nur 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": { … } }