EN DE ES FR IT NL

Willkommen bei Trakkit.org

Trakkit.org ist das Frontend für eine Track-Rendering-Engine für Freizeit- und Offshore-Segeln.

Es ermöglicht Ihnen:

  • Navigations-Tracks zu erstellen, anzusehen und zu teilen.
  • Sie in Anwendungen oder Websites einzubetten.
  • Tracks über einen einfachen Weblink oder direkt von der Startseite der Website zu teilen.
  • Echtzeit-Tracking durch automatische Uploads von NMEA-, GPX- oder TEXT-Data per email oder SFTP zu aktivieren.
  • Ihre Position auf NoForeignLand automatisch zu aktualisieren.

Trakkit.org erfasst keine personenbezogenen Daten.

🚀 Schnellstart

Um Ihnen den Einstieg zu erleichtern und schnell vertraut zu werden, folgen Sie diesen Schritten:

  1. Erstellen Sie ein Konto (kostenlos)
  2. Erstellen Sie ein Boat
  3. Ein Satz Beispieldaten und ein Test-Track wurde automatisch erstellt.
  4. Testen Sie den Beispiel-Track, indem Sie folgende Seite besuchen: https://<boatname>.trakkit.org
  5. Laden Sie Ihre eigenen Data mit einer normalen .GPX-Datei hoch: DATA > Upload
  6. Erstellen Sie einen Track: TRACK > Add Track, um auszuwählen, welchen Teil der Data Sie anzeigen möchten
  7. Es wird eine TTR ID zugewiesen, und der Track kann geteilt werden unter: https://trakkit.org/ttr/<TRACK-ID-TTR>

NB: Der Beispieldatensatz wird automatisch gelöscht, sobald Sie beginnen, Ihre eigenen Data hochzuladen.

📚 Allgemeine Dokumentation

In Trakkit.org dreht sich alles um drei Objekte:

  • Boat
  • Data
  • Track

Data ist mit einem Boat verknüpft. Ein Track ist ein Segment von Data zwischen zwei Daten.

🔧 Wie funktioniert es?

Es ist entscheidend zu verstehen, dass in Trakkit Data nicht an Tracks gebunden sind. Data können kontinuierlich gesendet werden. Tracks definieren lediglich Datumsbereiche, innerhalb derer die entsprechenden Data sichtbar sind. Das Löschen eines Tracks hat keinen Einfluss auf die Data. Data sind nur sichtbar, wenn ein Track definiert ist, der sie sichtbar macht. Dieselben Data können in mehreren Tracks erscheinen.

Grundstruktur:

  • 1 User kann mehrere Boats haben
  • 1 Boat gehört nur 1 User
  • 1 Boat kann beliebig viele Tracks haben
  • Mehrere Tracks können dieselben Data verwenden
  • Das Löschen eines Track hat keinen Einfluss auf die Data



🛥️ Boat


Das Erstellen eines Bootes ist der erste Schritt, um Data zu importieren und Tracks zuzuordnen.


📝 Verfügbare Felder


  • Name (erforderlich): Identifiziert das Boot.
  • Maxspeed: In Knoten. Wird verwendet, um mögliche GPS-Punkt-Anomalien zu erkennen (z. B. unrealistische Geschwindigkeiten).
  • Info: Ein optionales, rein informatives Feld. Tragen Sie ein, was Sie möchten.
  • Active LiveTrack: Der Track, der im Echtzeit-Tracking angezeigt wird. Ein dedizierter Track muss zuvor über das Menü Track erstellt und dann hier ausgewählt werden. Um für LiveTrack geeignet zu sein, muss der Track ein Enddatum in der Zukunft haben (z. B. 1/1/2050). Wenn das Feld leer bleibt, wird im Echtzeit-Tracking nur das Symbol der zuletzt bekannten Position angezeigt.
  • Direct URL: Eine öffentliche Webadresse, die direkten Zugriff auf die aktuelle Position des Boots (und seinen LiveTrack, falls definiert) bietet. Es wird generell empfohlen, den Bootsnamen zu verwenden. <boatname>.trakkit.org
  • Email: Adresse, von der die Tracking-E-Mails gesendet werden. Dies wird überschrieben, wenn im Betreff der E-Mail ein gültiger TAG enthalten ist.
  • Noforeignland Email: Wenn Sie ein NoForeignLand-Konto haben, fügen Sie diese E-Mail-Adresse in den NFL-Kontoeinstellungen als Tracking-Absender hinzu, und Ihre Position auf NFL wird automatisch von Trakkit.org aktualisiert.
  • Tags: Tags sind Aliase für Ihr Boot. Sie können sie verwenden, um Data zu senden, auf den SFTP-Server zuzugreifen oder Ihren eigenen Data-Sender zu erstellen. Um Data über unseren SFTP-Server zu senden, erstellen Sie ein Tag-Passwort (Boat > Tags & Mails > Edit Tag > Create Password).

Test Track: Wenn Sie zum ersten Mal ein Boot erstellen, werden automatisch ein test track und ein Satz von Beispieldaten erzeugt. Dadurch können Sie sich schnell mit den Boot-Parametern und der Track-Visualisierung vertraut machen. Dieser Test-Track und seine Data werden beim ersten Import realer Data automatisch gelöscht.


🏷️ Tags


Tags sind alternative Aliase zur Identifikation eines Boots. Der Hauptzweck eines Tags ist, einer bestimmten Personengruppe Zugriff zu gewähren. Das Löschen eines Tags entfernt den Zugriff für diese Gruppe, aber alle, die einen anderen Tag verwenden, haben weiterhin Zugriff.

Typischerweise erstellen Sie für jedes System, das Data an das Boot liefert, einen eigenen Tag. Boat > Mails & Tag > Add Tag Wenn der Zugriff eines Systems beschädigt oder nicht mehr verfügbar ist, löschen Sie einfach den zugehörigen Tag.

Verfügbare Felder:

  • INFO: Ein rein informatives Feld, damit Sie sich merken können, wie Sie den Tag verwenden. Tragen Sie ein, was Sie möchten.
  • ALLOWED TO SEND MAIL: Aktivieren Sie dieses Kontrollkästchen, wenn Sie den Tag verwenden möchten, um Data per E-Mail zu senden.

Um Data über Companion-Devices zu liefern oder den SFTP-Server zu verwenden, müssen Sie einen Tag mit Passwort erstellen:
Boat > Mails & Tag > Edit > Create Password

⚠️ Merken Sie sich dieses Passwort unbedingt, da es nicht wiederhergestellt werden kann. Wenn das Passwort verloren geht, müssen Sie ein neues erstellen.

  • Sie können beliebig viele Tags für ein bestimmtes Boat erstellen.
  • Tags können mit Gruppen oder Einzelpersonen geteilt werden, um Zugriff zu gewähren.
  • Ein Tag kann jederzeit gelöscht werden, ohne Auswirkungen auf Boats, Tracks oder Data.
  • Tags können verwendet werden, um Data per E-Mail von jeder E-Mail-Adresse zu senden, indem Sie den Tag einfach in die Betreffzeile setzen. In diesem Fall teilen Sie den Tag mit niemandem.
  • Tags mit Passwörtern können verwendet werden, um auf den SFTP-Server zuzugreifen, wobei der Tag als Benutzername dient.




📈 Data


Sobald ein Boat erstellt wurde, können Sie Trakkit.org mit Data für dieses Boat versorgen.


Was ist DATA?


Data ist eine Sammlung von GPS-Punkten und optionalen Sensorinformationen (AWA, AWS usw.) für ein Boot.

Data können verschiedene Formen annehmen:

  • Eine GPX-Datei, die von einem GPS-Gerät erzeugt oder aus Apps wie Navionics Boating exportiert wurde
  • NMEA 0183-Datei-Traffic, aufgezeichnet mit Apps wie OpenCPN oder QtVlm oder einer Companion-App.
  • Eine TEXT CSV-Datei, die ein Semikolon (;) als Trennzeichen verwendet, mit Feldnamen in der ersten Zeile.

Pflichtfelder: - Date (ISO-8601-Format – Werte ohne Zeitzone werden als UTC angenommen) - LAT - LON (in Dezimalgrad)

Optionale Felder: Es können zusätzliche Felder angegeben werden, z. B.: AWA, AWS, COG, SOG, usw.

Einige optionale Felder können je nach Version vom Parser ignoriert werden.

Aktuell unterstützte Felder: AWS, AWA, COG, SOG, TWA, TWS, MTW, MTA, HDG, TWD, CTW, MBP, STW, DEPTH, RPM, ELEV

Geschwindigkeiten in Knoten, Winkel in Grad, Tiefe in Metern, Temperatur in Celsius. Jedes Feld, das als (calc) markiert ist, wird ignoriert, da Trakkit dafür ausgelegt ist, nur Rohdaten aufzunehmen, die direkt von bordeigenen Navigationssystemen erzeugt werden.

Beispiel für gültige CSV DATA:

  Date;LAT;LON;SOG;COG;AWA;AWS;DEPTH;MTW
  2026-04-21T08:00:00Z;44.8500;-55.2167;5.2;145;32;14.5;120;12.4
  2026-04-21T08:05:00Z;44.8485;-55.2135;5.4;147;30;15.0;118;12.5
  2026-04-21T08:10:00Z;44.8470;-55.2103;5.6;149;29;15.6;115;12.5

Aus historischen Gründen und zur Kompatibilität mit älteren Iridium-GO-Textformaten werden Trakkits ältere TEXT-Formate weiterhin unterstützt, sind jedoch veraltet und sollten für neue Entwicklungen nicht verwendet werden. Ab sofort sollte nur noch das CSV-Format verwendet werden.


Wie man DATA sendet:


Sie können Data auf unterschiedliche Arten zu unterschiedlichen Zeiten senden. Mit einer Internetverbindung auf See können Sie Data in Echtzeit senden. Andernfalls speichern Sie einfach eine GPX-, NMEA- oder TEXT-Datei von Ihrem GPS- oder Navigationssystem und laden sie später hoch, wenn Sie wieder online sind. Reihenfolge, Datum und Uhrzeit der Datenübertragung spielen keine Rolle; relevant sind nur die in den Data enthaltenen Zeitstempel. Das mehrfache Hochladen derselben Data beeinflusst oder beschädigt Ihre Data nicht. Hier sind die verschiedenen Möglichkeiten, Ihre Data zu senden:

Unabhängig von der gewählten Upload-Methode können alle Data komprimiert werden in: .zip .gzip .z .xz .7z .tar .tgz


📤 Per direktem Data-Upload zu Trakkit.org:

Eine der einfachsten Methoden ist, sich bei Trakkit.org anzumelden, DATA>UPLOAD und Ihre von Navigations-Apps oder GNSS-Geräten exportierte GPX-, NMEA- oder TEXT-Datei hochzuladen.


📡 Per SFTP:

Sie können Ihre Dateien an den Trakkit SFTP server senden – dies ist die empfohlene Methode für automatisierte Datenübertragungen und große Dateien.

Zugangsdaten & Serveradresse werden bereitgestellt, wenn Sie auf Trakkit.org ein Tag-Passwort anfordern: BOATS > Mails & Tags > Create Tag Password

Beschränkungen (Fair-Use-Policy): Maximale Upload-Frequenz: 1 Verbindung alle 3 Minuten. Maximale Dateigröße: 50 MB pro Upload. Wenn Sie diese Empfehlungen nicht befolgen, kann dies zu Einschränkungen beim Upload-Zugang oder sogar zu einem dauerhaften Bann von Trakkit.org führen. Beachten Sie, dass 50 MB komprimierte Data über 24 Stunden vollständigen NMEA-Traffic speichern können.

Nach dem Verbinden laden Sie Ihre Data einfach in das Verzeichnis /upload hoch.

Hochgeladene Dateien müssen diesem Format entsprechen: TAG_YYYYMMDD_HHMMSS.data

Hinweis: TAG muss mit den Tag-Zugangsdaten übereinstimmen, die für die Verbindung verwendet werden.

➡️ Bei einem manuellen Upload wird dringend empfohlen, die Datei zuerst mit der Endung .part hochzuladen (z. B. TAG_YYYYMMDD_HHMMSS.gz.part) und sie dann in .data umzubenennen, sobald die Übertragung abgeschlossen ist. Dadurch wird sichergestellt, dass die Datei nicht verarbeitet wird, bevor der Upload vollständig beendet ist. Komprimieren Sie Ihre Dateien, um Bandbreite zu sparen (z. B. .zip, .gzip, .z, gz, .xz, .7z, .tar, .tgz).

Sie können das Python-Skript sftp_send.py verwenden, verfügbar auf Trakkit.org unter About > Downloads, das Uploads automatisiert und dabei die empfohlenen Einstellungen einhält.


✉️ Per Mail:

E-Mails müssen an spool@trakkit.org gesendet werden

Sie müssen entweder einen Tag im Betreff Ihrer E-Mail angeben oder Ihre E-Mail-Adresse vor dem Versand per Mail in Trakkit.org mit Ihrem Boot verknüpfen. Dadurch kann Trakkit.org die Data dem richtigen Boat zuordnen.

Wenn Sie einen Tag im Betreff Ihrer E-Mail verwenden, müssen Sie zuvor erlauben, dass dieser Tag Mail senden darf (BOATS > Mails & Tags > Edit > Allowed to send mail). E-Mails, die mit einem Tag eingehen, der nicht erlaubt ist, werden ignoriert – selbst wenn die E-Mail-Adresse des Absenders bereits verknüpft ist.

Zuordnungsregeln:

  • Wenn die E-Mail des Absenders auf Trakkit.org mit einem BOAT verknüpft ist, werden die DATA diesem Boot zugeordnet.
  • Wenn im Betreff der E-Mail ein TAG alias angegeben ist, der Mail senden darf, werden die DATA dem Boot zugeordnet, das mit diesem Tag verknüpft ist.
  • Bei widersprüchlichen Informationen hat der Tag Vorrang vor der E-Mail.
  • Sie können die Data als Dateianhang senden oder in den Nachrichtentext schreiben

Hinweis: E-Mail ist nicht die empfohlene Methode, da die meisten Anbieter Nachrichten- und Anhangsgrößen streng begrenzen und diese ohne Hinweis ablehnen können. Diese Methode sollte kleinen Textdaten oder Low-Bandwidth-Trackern wie Iridium GO vorbehalten bleiben. Komprimieren Sie Ihre Dateien, um Bandbreite zu sparen (z. B. .zip, .gzip, .z, .xz, .7z, .tar, .tgz).


🗑️ Data löschen

So löschen Sie Data:

  • Verwenden Sie das Menü Data > Delete
  • Löschen nach Datumsbereich oder BatchID
  • Jeder Upload hat eine BatchID; das Entfernen eines Batches löscht nur diesen Data-Block
  • Das Löschen eines track löscht nicht die data.


🗂️ Batches

Jedes Mal, wenn Data hochgeladen werden, wird eine Batch ID zugewiesen. Alle Data, die in einem einzigen Vorgang hochgeladen werden, teilen sich dieselbe Batch ID.

Wenn Sie z. B. 10.000 Positionspunkte auf einmal hochladen, haben sie alle dieselbe Batch ID.

Der Hauptzweck der Batch ID besteht darin, gemeinsam hochgeladene Data vom selben Gerät zu identifizieren und das Löschen des gesamten Uploads in einem einzigen Vorgang zu ermöglichen. Das kann in Fällen fehlerhafter Geräte oder korrupter Data nützlich sein.

Hinweis: Das mehrfache Hochladen derselben Data wird unterstützt und erfordert keine manuelle Löschung über die Batch ID.

Batch IDs werden mindestens ein Jahr nach Erstellung aufbewahrt. Danach gelten die Data als gültig, und die Batch ID kann entfernt werden.


🗺️ TRACKS:

Im Gegensatz zu anderen Navigationssystemen ist ein Track in Trakkit einfach ein benannter Zeitausschnitt innerhalb eines Satzes von Data.

Sie definieren Start- und End-Zeitpunkte und geben ihm einen Namen.

Trakkit prüft, ob für dieses Intervall entsprechende Data verfügbar sind, und zeigt sie an, falls ja.

Wenn keine Data verfügbar sind, wird nichts angezeigt. Später, wenn Data hochgeladen werden, die zum Intervall des Tracks passen, wird der Track automatisch aktualisiert.

Ein Track kann auch manuell über TRACK > Regen aktualisiert werden.

  • BoatName: Das Boot, dem der Track zugeordnet werden soll.
  • TrackName: Angezeigter Name des Tracks.
  • Color: Wählen Sie die Farbe des Tracks. Zusätzlich zu den standardmäßigen festen Farben können Sie einen Mehrfarbenmodus für Ihren Track wählen, basierend auf der Bootsgeschwindigkeit (SOG) oder der scheinbaren Windgeschwindigkeit (AWS). SOG wird automatisch berechnet, aber für AWS müssen Sie es in Ihren Data bereitgestellt haben, typischerweise durch das Hochladen von NMEA-Sätzen.
  • Default Layer: Die zu verwendende Vordergrund-Kartenebene. Standard ist OSM SRTM Topographic. Beachten Sie, dass die Verfügbarkeit der Tiles variieren kann, insbesondere bei solchen, die von US-Behörden (NASA, NOAA usw.) bereitgestellt werden, aufgrund von Finanzierungsbeschränkungen, die diese Dienste in den Vereinigten Staaten betreffen.
  • WPO: Intervall in Minuten für die Fortschrittspunkte (die orangefarbenen Punkte).
  • WPP: Intervall in Sekunden für die Trackpunkte (Track-Präzision). Warnung: Eine zu hohe Präzision kann das Rendering, das Laden und die Visualisierung des Tracks drastisch verlangsamen. Nutzen Sie gesunden Menschenverstand und passen Sie die Präzision an die Art des Tracks an: „60 für Küstennavigation, 300 für Offshore-Navigation und 600 für lange Passagen“ sind gute Richtwerte. Für Echtzeit-Tracking (LiveTrack) sollte dieser Wert niemals unter 300 Sekunden liegen. Sobald Track und Navigation abgeschlossen sind, können Sie bei Bedarf den finalen Track mit höherer Präzision neu generieren.
  • Published: Aktivieren Sie dies, wenn Sie den Track in der „TRACK LIST“ aufführen möchten, die auf Ihrer Boot-Seite unter https://.trakkit.org sichtbar ist
  • Erinnerung: Das Löschen eines Track löscht nicht die Data.

Wir empfehlen dringend, Start- und Enddatum/-uhrzeit Ihres Tracks so zu setzen, dass Ihre exakten Abfahrts- und Ankunftspunkte nicht dauerhaft angezeigt werden

Einen Track visualisieren

  • Direktlink: https://trakkit.org/ttr/<TRACK-ID>
  • Von der Startseite mit dem TRACK-ID
  • Tracks werden statisch gerendert und nur automatisch aktualisiert, wenn neue Data importiert werden
  • Kann manuell neu generiert werden (TRACK > Regen)

Sie können einen responsiven Link in Ihre eigene Seite oder Website integrieren, indem Sie die in Ihrem Boat-Bereich bereitgestellte Direct URL verwenden:

    <div class="iframe-container">
      <iframe src="https://trakkit.org/ttr/<TRACK-ID>"
              title="My Track on Trakkit"></iframe>
    </div>

Hinweis: Je nach Rendering-Engine, die zur Erzeugung eines Tracks verwendet wird, kann die angezeigte URL variieren. Allerdings sollten Sie immer das Format https://trakkit.org/ttr/<TRACK-ID> verwenden, um auf einen Track zuzugreifen, selbst wenn Trakkit ihn später intern umbenennt oder umleitet.

Echtzeit-Tracking visualisieren

Wählen Sie unter Boat > Edit > Direct URL eine URL für Ihr Boot (gewöhnlich den Bootsnamen).

Sie können die Position Ihres Boots direkt ansehen unter:
https://boatname.trakkit.org

Wobei „boatname“ der Name ist, der in Direct URL vergeben wurde.

Wenn ein LiveTrack aktiviert ist (Boat > Edit > Active LiveTrack), wird auch der Track des Boots angezeigt. Andernfalls wird nur die zuletzt bekannte Position angezeigt.

Die Standardseite für Live-Tracking zeigt Navigationsinformationen und Schaltflächen für den Zugriff auf die Live Weather Map, die Track List (für Tracks, die als Public gekennzeichnet sind) sowie die Full Screen-Ansicht. Bitte beachten Sie, dass Live-Wetterdaten von einem Drittanbieter bereitgestellt werden, außerhalb unserer Kontrolle nicht verfügbar sein können und keine Gewähr für Genauigkeit besteht.

Sie werden wahrscheinlich eine Full Screen-Ansicht ohne das Data-Panel innerhalb der in Ihre eigene Website oder Webseiten eingebetteten Frames bevorzugen. Sie können eine Full Screen-Ansicht direkt über die folgende URL öffnen: https://trakkit.org/live/simple/boatname

Sie können die Live-Tracking-Ansicht (oder jeden anderen Track) direkt in einem iframe auf Ihrer eigenen Website oder persönlichen Seite einbetten.
Zum Beispiel: Um https://boatname.trakkit.org einzubetten, verwenden Sie das folgende HTML:

<iframe
    src="https://boatname.trakkit.org"
    width="100%"
    height="600"
    style="border:0;"
    allowfullscreen>
</iframe>



NoForeignLand


Wenn Sie ein NoForeignLand account haben, kann Trakkit automatisch Ihre Position senden, um Ihren Standort auf der NoForeignLand-Website zu aktualisieren.

Um diese Funktion zu aktivieren, fügen Sie die Trakkit-Absenderadresse (etwa nfl_xxxxx@trakkit.org), die Ihnen in Boat > Mails & Tag > NoForeignLand zugewiesen wurde, zu den E-Mail-Synchronisationseinstellungen Ihres NoForeignLand-Kontos hinzu.

Sobald diese Adresse bei NoForeignLand registriert wurde, klicken Sie in Trakkit auf „Activate“. Ihre Position wird dann in regelmäßigen Abständen per E-Mail gesendet. Die Synchronisation kann hier jederzeit deaktiviert werden.

⚠️ Bitte beachten Sie, dass NoForeignLand keine GNSS-Zeitstempel verwendet; stattdessen entspricht der aufgezeichnete Zeitstempel dem Zeitpunkt der Synchronisation. Positionsaktualisierungen erfolgen höchstens alle 6 Stunden.



💻 Companion App


Eine Companion-App ist eine Drittanbieter-Anwendung, die Data sammelt und an Trakkit sendet.

Der Python-basierte Code für "joli_compagnon," Trakkits Standard-Companion-Anwendung, ist frei verfügbar und kann leicht an Ihr Setup angepasst werden. Er kann unter Trakkit.org > About > Download Tools heruntergeladen werden.

Sie können mit einem einfachen Raspberry Pi oder einem anderen Mini-Computer eine vollständige, in sich geschlossene Tracking-Lösung einrichten. Der vollständige Einrichtungsprozess wird in den folgenden Anleitungen beschrieben: DIY Tracker with USB GPS und DIY Tracker with NMEA Gateway.

Dies ist die bevorzugte Lösung für Echtzeit-Tracking.