Warum jetzt
Die überarbeiteten ECDIS-Leistungsnormen der IMO (MSC.530(106)) bringen S-100 auf die Brücke, und S-124 ist darin das Produkt für Navigationswarnungen. Die Spezifikation steht, die Daten fehlen. Die nationalen Koordinatoren veröffentlichen weiter Text: NAVTEX, Webseiten, PDFs. Neptun schließt diese Lücke: Du kannst S-124 schon heute in deinem Produkt bauen, testen und vorführen, mit echten, aktuellen Warnungen statt handgemachter Beispiele.
Was du bekommst
Jeder Abruf liefert ein ZIP mit einem S-100-Exchange-Set. Entpackt sieht es so aus:
Wer hat es geschickt, und ist es unverändert?
S-124 ist nicht nur ein Datenformat. Ein Empfänger muss wissen, wer eine Warnung herausgegeben hat und dass sie unterwegs niemand verändert hat. Neptun deckt drei Ebenen ab:
Jeder Datensatz nennt die herausgebende Behörde in agencyResponsibleForProduction, mit Serie, Nummer und Jahr. Im Dateinamen steht unser Erzeugercode NPTN.
Jeder Datensatz und der Katalog sind signiert (DSA, SHA-256). Die Zertifikate stehen im Katalog, ein Empfänger kann die Daten also prüfen, ohne uns zu fragen.
Heute: HTTPS mit API-Schlüssel. Als Nächstes: ein SECOM-Dienst (IEC 63173-2), bei dem sich beide Seiten mit Zertifikaten der Maritime Connectivity Platform ausweisen.
Was wir sind, und was nicht
Neptun verteilt amtliche Warnungen, gibt sie aber nicht heraus. Wir signieren als Neptun, nie im Namen einer Behörde. Maßgeblich ist die Originalquelle. Unsere Zertifikate stammen aus Neptuns eigener Test-Zertifizierungsstelle, nicht aus dem IHO-Verfahren für typgeprüfte ECDIS. Ein ECDIS im Betrieb nimmt sie deshalb nicht an. Für Entwicklung, Tests und Lageübersicht ist das richtig so. Jeder Katalogeintrag trägt notForNavigation. Die Daten ersetzen nicht den amtlichen Empfang von Navigationswarnungen über NAVTEX/GMDSS.
API
GET /v1/warnings/s124?bbox=minLat,minLon,maxLat,maxLon
Exchange Set (ZIP) für ein Gebiet; dazu lat/lon/radius, lang, source, since. Bis zu 1.000 Datensätze je Paket; weiterblättern mit dem Header X-Neptun-Next-Offset.
GET /v1/warnings/s124/{mid}
Eine einzelne Warnung als S-124-Datensatz (GML), über ihre Neptun-ID.
curl -H "Authorization: Bearer mapi_…" -o navarea-x.zip \
"https://neptun.marine-api.com/v1/warnings/s124?bbox=-60,90,0,170&lang=en"
Wie aus einer Warnung S-124 wird
| Neptun-Feld | S-124 | Hinweis |
|---|---|---|
| nts „AUSCOAST 317/26“ | messageSeriesIdentifier | Serie AUSCOAST, Nummer 317, Jahr 2026 |
| Serienname | warningType | NAVAREA-, Küsten- oder örtliche Warnung |
| Quellbehörde | agencyResponsibleForProduction | die herausgebende Behörde |
| category / kind | navwarnTypeGeneral, navwarnTypeDetails | IHO-Labels; Details nur, wo eindeutig |
| place, detail | navwarnTitle, information | in der angefragten Sprache |
| valid_from / valid_until | fixedDateRange, cancellationDate | |
| closed | restriction | Entry Prohibited |
| Fläche, Linie, Position | S100:Surface, Curve, Point | ungefähre Positionen ohne Geometrie |
Selbst prüfen
Jeder Stand wird gegen die amtlichen IHO-Schemata geprüft (S-124 2.0.0, S-100-5.0.0-Katalog und Part 15), und jede Signatur wird verifiziert. Mit dem Beispiel und unseren öffentlichen Zertifikaten kannst du das nachvollziehen:
unzip neptun-s124-sample-navarea-x.zip
xmllint --noout --schema 124_2.0.0.xsd S100_ROOT/S-124/DATASET_FILES/NPTN/*.GML
openssl verify -CAfile neptun-s100-test-root.pem neptun-data-server-nptn.pem
Zertifikate
Neptun-S-100-Test-Zertifizierungsstelle SHA-256 906ae33e97a555da640ff24f1620f3502b7d035aebfe1427cd53df1b67fd08cd
Neptun-Datenserver NPTN SHA-256 7aa127b7f35efd310f326f9851a3872843d9e91458a57739491b238e57fc4b2a
Als Nächstes
- SECOM-Dienst (IEC 63173-2) mit Identitäten der Maritime Connectivity Platform
- Bulletins der gültigen Warnungen und Aufhebungsverweise (
References) - Erzeugercode aus dem IHO-Register S-62
Für NAVAREA- und nationale Koordinatoren
Deine Warnungen gibt es schon als Text. Neptun macht daraus einen S-124-Entwurf; deine Leute prüfen und geben ihn frei, signiert wird mit eurem eigenen Schlüssel in eurer Umgebung. Den Schlüssel sehen wir nie. Wenn du deine eigenen Warnungen in S-124 sehen willst, schreib uns, wir schicken dir ein Paket.
Zugang und Preise
S-124 gibt es auf Anfrage: Probezugang für Entwicklung und Tests sowie Lizenzen für Nutzung und Weitergabe in deinem Produkt. Schreib an [email protected] und sag uns in einem Satz, worum es geht.
Häufige Fragen
Welche Ausgabe?
S-124 Ausgabe 2.0.0 (IHO-Schema Build 20250729) auf dem GML-Profil von S-100 5.0.0.
Warum fehlen die Code-Werte bei den Aufzählungen?
S-124 macht den Zahlencode optional, verbindlich sind die Labels. Wir liefern deshalb nur Labels, so kann sich kein falscher Code einschleichen.
Welche Sprachen?
Die Texte kommen in der angefragten Sprache (lang), der Sprachcode steht in jedem Textelement.
Woher kommen die Daten?
Aus den amtlichen Quellen auf der Abdeckungsseite. Jeder Datensatz nennt seine Behörde, maßgeblich ist immer das Original.