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 Hochseesegeln.

Damit können Sie:

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

Trakkit.org erfasst keine persönlichen 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, welcher Teil der Data angezeigt werden soll
  7. Es wird eine TTR ID zugewiesen, und der Track kann hier geteilt werden: https://trakkit.org/ttr/<TRACK-ID-TTR>

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

📚 Allgemeine Dokumentation

Alles in Trakkit.org dreht sich um drei Objekte:

  • Boat
  • Data
  • Track

Data ist mit einem Boat verknüpft. Ein Track ist ein Segment der Data zwischen zwei Datumsangaben.

🔧 Wie funktioniert es?

Es ist entscheidend zu verstehen, dass in Trakkit Data nicht an Tracks gebunden ist. Data kann 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 ist nur sichtbar, wenn ein Track definiert ist, der sie sichtbar macht. Dieselbe Data kann in mehreren Tracks erscheinen.

Grundstruktur:

  • 1 User kann mehrere Boats haben
  • 1 Boat gehört nur zu 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 Boats ist der erste Schritt, um Data zu importieren und Tracks zuzuordnen.


📝 Verfügbare Felder


  • Name (erforderlich): Identifiziert das Boat.
  • Maxspeed: In Knoten. Wird verwendet, um potenzielle Anomalien von GPS-Punkten zu erkennen (z. B. unrealistische Geschwindigkeiten).
  • Info: Ein optionales, rein informatives Feld. Tragen Sie ein, was Sie möchten.
  • Active LiveTrack: Der Track, der beim Echtzeit-Tracking angezeigt wird. Ein dedizierter Track muss zuvor über das Menü Track erstellt und anschließend 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 beim Echtzeit-Tracking nur das Symbol der zuletzt bekannten Position angezeigt.
  • Direct URL: Eine öffentliche Webadresse, die direkten Zugriff auf die aktuelle Position des Boats (und seinen LiveTrack, falls definiert) bietet. Es wird generell empfohlen, den Boat-Namen zu verwenden. <boatname>.trakkit.org
  • Email: Adresse, von der die Tracking-E-Mails gesendet werden. Dies wird überschrieben, wenn ein gültiger Tag im Betreff der E-Mail enthalten ist.
  • Noforeignland Email: Wenn Sie ein NoForeignLand-Konto haben, fügen Sie diese E-Mail-Adresse in Ihren NFL-Kontoeinstellungen als Tracking-Absender hinzu; Ihre Position auf NFL wird dann automatisch von Trakkit.org aktualisiert.
  • Tags: Tags sind Aliase für Ihr Boat. Sie können sie nutzen, 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 Boat erstellen, werden automatisch ein test track und ein Satz Beispieldaten erzeugt. Dadurch können Sie sich schnell mit den Boat-Parametern und der Track-Visualisierung vertraut machen. Dieser Test-Track und seine Data werden automatisch gelöscht, sobald zum ersten Mal echte Data importiert werden.


🏷️ Tags


Tags sind alternative Aliase zur Identifikation eines Boats. 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 jeder, der einen anderen Tag verwendet, hat weiterhin Zugriff.

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

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

⚠️ Achten Sie darauf, sich dieses Passwort zu merken, da es nicht wiederhergestellt werden kann. Geht das Passwort verloren, 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 in die Betreffzeile setzen. Teilen Sie in diesem Fall den Tag mit niemandem.
  • Tags mit Passwörtern können für den Zugriff auf den SFTP-Server verwendet werden, 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 Boat.

Data kann verschiedene Formen annehmen:

  • Eine GPX-Datei, die von einem GPS-Gerät erzeugt oder aus Apps wie Navionics Boating exportiert wurde
  • NMEA 0183-Dateiverkehr, aufgezeichnet mit Apps wie OpenCPN oder QtVlm oder einer Companion-App.
  • Eine normale TEXT-Datei mit GPS-Positionsinformationen, wie sie z. B. per E-Mail von Geräten wie Iridium Go gesendet werden:

I am here Lat+28.851240 Lon-13.794377 Alt+009ft GPS Sats seen 10 2023-01-17 00:34UTC

Oder eine Zeile mit folgendem Muster:

[±]Latitude [±]Longitude YYYY-MM-DD HH:MM[:SS[.sss]] [Timezone] [AWA:XXX] [AWS:XX.X] [COG:XXX] [SOG:XX.X] ...

NB: Breitengrad und Längengrad sind in Dezimalgrad angegeben. Datum, Uhrzeit und Zeitzone können in einem einzelnen ISO-Format kombiniert werden: 2025-11-10T14:26:05Z. Mehrere Zeilen sind in Textnachricht oder Dateianhang erlaubt.

Akzeptables Textformat-Beispiel:

-38.1052 -12.277 20210210 102345                                # UTC implicit
46.238 -0.5687 2021-02-10 10:23:45 UTC
-38.1052 -12.277 20210210 102345 UTC+2                          # If, for some mysterious reason, your navigation system isn’t set to UTC…
46.238 -0.5687 2021-02-10 10:23:45 UTC COG:125 SOG:9.2
-38.1052 -12.277 2021-02-10T10:23:45Z                           # ISO format UTC
46.238 -0.5687 2021-02-10T10:23:45+02:00 AWA:120 AWS:23.5       # ISO format UTC+2


Wie sendet man DATA:


Sie können Data auf unterschiedliche Weise und 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 Data-Übertragung spielen keine Rolle; relevant sind nur die Zeitstempel, die in den Data enthalten sind. 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 Möglichkeiten ist, sich bei Trakkit.org anzumelden, DATA>UPLOAD zu wählen und Ihre aus einer Navigations-App oder einem GNSS-Gerät 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 Data-Übertragungen und große Dateien.

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

Einschränkungen (Fair-Use-Richtlinie): Maximale Upload-Frequenz: 1 Verbindung alle 3 Minuten. Maximale Dateigröße: 50 MB pro Upload. Das Nichtbefolgen dieser Empfehlungen kann zu Einschränkungen beim Upload-Zugriff oder sogar zu einer dauerhaften Sperre von Trakkit.org führen. Beachten Sie, dass 50 MB komprimierte Data über 24 Stunden vollständigen NMEA-Verkehr speichern können.

Sobald Sie verbunden sind, 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 dem Tag-Zugangsdaten übereinstimmen, die für die Verbindung verwendet werden.

➡️ Bei manuellem Upload wird dringend empfohlen, die Datei zunächst mit der Endung .part hochzuladen (z. B. TAG_YYYYMMDD_HHMMSS.gz.part) und sie erst nach Abschluss der Übertragung in .data umzubenennen. Dadurch wird sichergestellt, dass die Datei nicht verarbeitet wird, bevor der Upload vollständig abgeschlossen 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, das auf Trakkit.org unter About > Downloads verfügbar ist und Uploads automatisiert, wobei die empfohlenen Einstellungen eingehalten werden.


✉️ Per Mail:

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

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

Zuordnungsregeln:

  • Wenn die Absender-E-Mail mit einem BOAT auf Trakkit.org verknüpft ist, werden die DATA diesem Boat zugeordnet.
  • Wenn ein Tag-Alias in der Betreffzeile der E-Mail angegeben ist, werden die DATA dem Boat 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 Anhanggrößen strikt begrenzen und sie ggf. ohne Hinweis ablehnen. Diese Methode sollte kleinen Text-Data oder Trackern mit geringer Bandbreite 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-Chunk
  • Das Löschen eines track löscht die data nicht.


---

🗺️ TRACKS:

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

Sie definieren die Start- und End-Zeit und geben ihm einen Namen.

Trakkit prüft, ob für diesen Zeitraum entsprechende Data verfügbar sind, und zeigt sie dann an.

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

Ein Track kann außerdem manuell über TRACK > Regen aktualisiert werden.

  • BoatName: Das Boat, 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 für Ihren Track einen Mehrfarbenmodus basierend auf der Bootsgeschwindigkeit (SOG) oder der scheinbaren Windgeschwindigkeit (AWS) wählen. SOG wird automatisch berechnet, für AWS müssen Sie die Werte jedoch in Ihren Data bereitgestellt haben, typischerweise durch das Hochladen von NMEA-Sätzen.
  • Default Layer: Die zu verwendende Karten-Vordergrundebene. Standard ist OSM SRTM Topographic. Beachten Sie, dass die Verfügbarkeit von Tiles variieren kann, insbesondere bei denen, die von US-Behörden (NASA, NOAA usw.) bereitgestellt werden, aufgrund von Finanzierungseinschrä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 Track-Punkte (Track-Genauigkeit). Warnung: Eine zu hohe Genauigkeit kann das Rendering, das Laden und die Visualisierung des Tracks drastisch verlangsamen. Nutzen Sie gesunden Menschenverstand und passen Sie die Genauigkeit an den Track-Typ an: „60 für Küstennavigation, 300 für Hochseeschläge 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 den finalen Track bei Bedarf mit höherer Genauigkeit neu generieren.
  • Published: Aktivieren Sie dies, wenn Sie den Track in der „TRACK LIST“ aufführen möchten, die auf Ihrer Boat-Seite unter https://.trakkit.org sichtbar ist
  • Erinnerung: Das Löschen eines Track löscht die Data nicht.

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

  • Direkter Link: https://trakkit.org/ttr/<TRACK-ID>
  • Von der Startseite mit dem TRACK-ID
  • Tracks werden statisch gerendert und nur dann automatisch aktualisiert, wenn neue Data importiert werden
  • Können 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 Generierung eines Tracks verwendet wird, kann die angezeigte URL variieren. Dennoch 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 weiterleitet.

Echtzeit-Tracking visualisieren

Wählen Sie in Boat > Edit > Direct URL eine URL für Ihr Boat (in der Regel den Boat-Namen).

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

Wobei 'boatname' der in Direct URL vergebene Name ist.

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

Die Standardseite für Live-Tracking zeigt Navigationsinformationen und Buttons, die Zugriff auf die Live Weather Map, die Track List (für Tracks, die als Public markiert sind) sowie die Full Screen-Ansicht bieten. Bitte beachten Sie, dass Live-Wetterdaten von einem Drittanbieter bereitgestellt werden, außerhalb unserer Kontrolle nicht verfügbar sein können und nicht garantiert korrekt sind.

Wahrscheinlich bevorzugen Sie eine Full-Screen-Ansicht ohne das Data-Panel innerhalb der in Ihre eigene Website oder Webseiten eingebetteten Frames. Sie können eine Full-Screen-Ansicht direkt über 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.
Beispielsweise: Um https://boatname.trakkit.org einzubetten, verwenden Sie folgendes 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 Ihre Position automatisch 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 Synchronisierung kann hier jederzeit deaktiviert werden.

⚠️ Bitte beachten Sie, dass NoForeignLand keine GNSS-Zeitstempel verwendet; stattdessen entspricht der aufgezeichnete Zeitstempel dem Zeitpunkt der Synchronisierung. Positionsupdates werden höchstens alle 6 Stunden durchgeführt.



💻 Companion App


Eine Companion-App ist eine Drittanbieteranwendung, 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 von Trakkit.org > About > Download Tools heruntergeladen werden.

Sie können eine vollständige, eigenständige Tracking-Lösung mit einem einfachen Raspberry Pi oder einem anderen Mini-Computer 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.