❓ Trakkit.org – FAQ

⚠️ Diese FAQ ist eine automatische Übersetzung, die aus der offiziellen Trakkit-Dokumentation generiert wurde.
Sie wird ausschließlich zu Informationszwecken bereitgestellt.

🌍 Allgemeine Fragen

Was ist Trakkit.org?

Trakkit.org ist ein webbasiertes Front-End für eine Track-Rendering-Engine, die dem Freizeit- und Offshore-Segeln gewidmet ist.
Es ermöglicht dir, Bootsnavigation-Tracks zu erstellen, zu visualisieren und zu teilen.


Sammelt Trakkit personenbezogene Daten?

⚠️ Nein. Trakkit.org sammelt keine personenbezogenen Daten.
Du bist vollständig dafür verantwortlich, was du online veröffentlichst.


Ist Trakkit kostenlos?

Ja. Das Erstellen eines Kontos sowie das Verwalten von Booten, Data und Tracks ist kostenlos.


🚀 Erste Schritte

Wie fange ich an, Trakkit zu nutzen?

  1. Erstelle ein kostenloses Konto
  2. Erstelle ein Boat (nur der Bootsname ist erforderlich)
  3. Ein Beispieldatensatz und ein Test-Track werden automatisch erstellt
  4. Besuche: https://.trakkit.org
  5. Lade deine eigene .gpx-Datei über DATA > Upload hoch
  6. Erstelle einen Track über TRACK > Add Track

Was passiert mit den Beispieldaten?

Der Beispieldatensatz und der Test-Track werden automatisch gelöscht, sobald du deine ersten echten Daten hochlädst.


Was ist ein TTR-Link?

Jeder Track erhält eine eindeutige ID, genannt TTR ID (oder TRACK ID).
Du kannst deinen Track teilen über:

https://trakkit.org/ttr/

Hinweis:
Abhängig von der Rendering-Engine kann Trakkit die in deinem Browser angezeigte URL dynamisch anpassen.

Um einen Track zuverlässig aufzurufen, verwende immer das kanonische Format:

https://trakkit.org/ttr/<TRACK-ID>


🛥️ Boats

Was ist ein Boat in Trakkit?

Ein Boat ist der Haupt-Container für deine Navigationsdaten und Tracks.
Du musst ein Boat erstellen, bevor du Daten sendest.


Was passiert, wenn ich ein Boat erstelle?

  • Ein Test-Track wird automatisch erzeugt
  • Beispieldaten werden damit verknüpft
  • Du kannst die Visualisierung sofort testen

Was ist die Direct URL?

Die Direct URL bietet öffentlichen Zugriff auf:

  • Die aktuelle Position des Boots
  • Seinen Live-Track (falls aktiviert)

Beispiel:

https://boatname.trakkit.org


Was ist Active LiveTrack?

Active LiveTrack ermöglicht die Echtzeit-Anzeige der Bewegung deines Boots.
So aktivierst du es:

  • Erstelle einen Track
  • Setze sein Enddatum in die Zukunft (z. B. 01/01/2050)
  • Wähle ihn in Boat > Edit > Active LiveTrack aus

📈 Data

Was ist Data?

Data ist eine Sammlung von GPS-Punkten und optionalen Navigationsinformationen (AWA, AWS, COG, SOG usw.).


Welche Dateiformate werden unterstützt?

  • .gpx
  • .nmea
  • .txt
  • E-Mail-Textpositionen
  • Komprimierte Formate: .zip, .gzip, .z, .xz, .7z, .tar, .tgz

Kann ich Data manuell hochladen?

Ja.
Gehe zu DATA > Upload und lade deine .gpx-, .nmea- oder .txt-Dateien hoch.


Kann ich Data automatisch senden?

Ja. Du kannst Data senden über:

  • E-Mail an spool@trakkit.org
  • SFTP (empfohlen für Automatisierung)
  • Companion-Apps
  • Satellitensysteme (z. B. Iridium Go)

Kann ich unterschiedliche Data-Quellen kombinieren?

Ja. Data kann zu unterschiedlichen Zeitpunkten aus mehreren Quellen kommen:

  • Echtzeit-Satelliten-E-Mails auf See
  • Vollständiger GPX-Upload im Hafen
  • NMEA-Logs aus Navigationssoftware

Löscht das Löschen eines Track auch Data?

Nein.
Das Löschen eines Track löscht die Data nicht.

Um Data zu löschen, verwende:

  • DATA > Delete
  • Löschen nach Datumsbereich oder BatchID

✉️ E-Mail-Data

Wie sende ich Data per E-Mail?

Sende sie an:

spool@trakkit.org

Du musst entweder:

  • Einen Tag im Betreff der E-Mail angeben

ODER

  • Deine E-Mail-Adresse mit deinem Boat verknüpfen

Was hat Priorität: Tag oder Absender-E-Mail?

Der Tag hat Priorität gegenüber der E-Mail-Adresse des Absenders.


Welchem Format sollten Positionsdaten folgen?

Ein Punkt pro Zeile:

Latitude Longitude YYYY-MM-DD HH:MM[:SS] [Timezone] [Optionale Felder]

Beispiel:

41.7267 -49.9469 2024-04-15 02:40:00 UTC AWA:120 AWS:24.5 COG:145 SOG:10.5

Wenn keine Zeitzone angegeben ist, wird UTC angenommen.


📡 SFTP Upload

Warum SFTP verwenden?

SFTP ist die empfohlene Methode für automatisierte Übertragungen.


Welche Einschränkungen gibt es?

  • Maximale Frequenz: 1 Datei alle 3 Minuten
  • Maximale Dateigröße: 20 MB

Wie sende ich Data per SFTP

  • Fordere ein Tag-Passwort an unter: Boat > Mails & Tags > Password
  • Speichere das Passwort sofort. Es kann nach der Anzeige nicht wiederhergestellt werden (bei Bedarf kannst du ein neues anfordern).
  • Die Adresse und der Port des SFTP-Servers werden zusammen mit dem Passwort angezeigt.
  • Du kannst Dateien manuell mit einem SFTP-Client wie FileZilla hochladen oder die von JoliCompanion bereitgestellten Automatisierungsskripte verwenden.

Wie sollten Dateien benannt werden?

TAG_YYYYMMDD_HHMMSS.data

Zuerst hochladen als:

TAG_YYYYMMDD_HHMMSS.part

Dann in .data umbenennen, sobald der Upload vollständig abgeschlossen ist.


🏷️ Tags

Was ist ein Tag?

Ein Tag ist ein Alias für ein Boat.
Er ermöglicht:

  • Data-Zuordnung
  • Zugriffskontrolle
  • SFTP-Authentifizierung

Kann ich mehrere Tags erstellen?

Ja. Du kannst so viele Tags erstellen, wie du für ein Boat möchtest.


Kann ein Tag mit mehreren Boats verknüpft werden?

Nein. Ein Tag kann nur zu einem Boat gehören.


Was passiert, wenn ich einen Tag lösche?

Der Zugriff über diesen Tag wird sofort entzogen.
Andere Tags bleiben gültig.


Können Tags für SFTP verwendet werden?

Ja.

  • Tag = Benutzername
  • Passwort erforderlich

Passwörter können nicht wiederhergestellt werden.


🗺️ Tracks

Was ist ein Track?

Ein Track ist einfach ein Zeitausschnitt der Data.

Er definiert:

  • Ein Startdatum/-zeit
  • Ein Enddatum/-zeit
  • Einen Namen

Er speichert selbst keine Data.


Können mehrere Tracks dieselbe Data verwenden?

Ja.
Tracks sind nur Ansichten auf bestehende Data.


Was passiert, wenn ich einen Track erstelle, bevor ich Data hochlade?

Es wird nichts angezeigt, bis passende Data hochgeladen wird.
Der Track aktualisiert sich automatisch, sobald Data eintrifft.


Was ist WPP und WPO?

  • WPP (Track precision): Intervall in Sekunden zwischen angezeigten Track-Punkten
  • WPO (Progress points): Intervall in Minuten zwischen orangefarbenen Fortschrittsmarkern

Empfohlene WPP-Werte:

  • 10 Sekunden → Regatten
  • 60 Sekunden → Küstennavigation
  • 300 Sekunden → Offshore-Navigation

Wie regeneriere ich einen Track?

Gehe zu:

TRACK > Regen


Wie kann ich einen Track öffentlich machen?

Aktiviere die Option Published beim Bearbeiten des Tracks.


🗺️ Tracks ansehen

Wie sehe ich einen Track an?

Direktlink:

https://trakkit.org/ttr/

Oder gib die Track ID auf der Startseite ein.


📡 Live Tracking

Wie aktiviere ich Live Tracking?

  1. Lege eine Direct URL fest
  2. Erstelle einen Track mit einem Enddatum in der Zukunft
  3. Wähle ihn als Active LiveTrack aus

Wie bette ich Live Tracking auf meiner Website ein?

Beispiel-HTML:

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

💻 Companion Apps

Was ist eine Companion App?

Eine Companion App ist eine Drittanbieter-Anwendung, die:

  • Navigationsdaten sammelt
  • Sie automatisch an Trakkit sendet

Gibt es eine Referenzimplementierung für eine Companion App?

Ja.
Der Python-Basiscode von JoliCompanion ist auf Trakkit.org und GitHub verfügbar. Er kann an dein Setup angepasst werden.


🔐 Data & Sichtbarkeit

Sind Data automatisch sichtbar?

Nein.
Data wird nur sichtbar, wenn ein Track ein Zeitintervall definiert, das sie abdeckt.


Sollte ich Abfahrts- und Ankunftszeitstempel verbergen?

Ja.
Es wird dringend empfohlen, Start- und Endzeiten des Tracks so zu setzen, dass deine exakten Abfahrts- und Ankunftspunkte nicht dauerhaft sichtbar sind.


🧭 Zusammenfassung

Trakkit basiert auf drei Kernobjekten:

  • Boat
  • Data
  • Track

Data ist kontinuierlich.
Tracks sind Ansichten.
Tags steuern den Zugriff.
Live Tracking ist optional.

Einfach, flexibel und für echtes Offshore-Segeln entwickelt.