❓ Trakkit.org – FAQ

⚠️ Deze FAQ is een automatische vertaling, gegenereerd op basis van de officiële Trakkit-documentatie.
Ze wordt uitsluitend verstrekt ter informatie.

🌍 Algemene vragen

Wat is Trakkit.org?

Trakkit.org is een webgebaseerde front-end voor een track-rendering-engine, speciaal bedoeld voor recreatief en offshore zeilen.
Het stelt je in staat bootnavigatie-tracks te maken, te visualiseren en te delen.


Verzamelt Trakkit persoonlijke gegevens?

⚠️ Nee. Trakkit.org verzamelt geen persoonlijke gegevens.
Je bent volledig verantwoordelijk voor wat je ervoor kiest om online te publiceren.


Is Trakkit gratis?

Ja. Een account aanmaken en boten, data en tracks beheren is gratis.


🚀 Aan de slag

Hoe begin ik Trakkit te gebruiken?

  1. Maak een gratis account aan
  2. Maak een Boat aan (alleen de bootnaam is vereist)
  3. Er worden automatisch een voorbeelddataset en een test track aangemaakt
  4. Bezoek: https://.trakkit.org
  5. Upload je eigen .gpx-bestand via DATA > Upload
  6. Maak een track aan via TRACK > Add Track

Wat gebeurt er met de voorbeelddata?

De voorbeelddataset en test track worden automatisch verwijderd wanneer je je eerste echte data uploadt.


Wat is een TTR-link?

Elke track krijgt een unieke ID, een TTR ID (of TRACK ID) genoemd.
Je kunt je track delen via:

https://trakkit.org/ttr/

Opmerking:
Afhankelijk van de rendering engine kan Trakkit de URL die in je browser wordt weergegeven dynamisch aanpassen.

Gebruik voor betrouwbare toegang tot een track altijd het canonieke formaat:

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


🛥️ Boats

Wat is een Boat in Trakkit?

Een Boat is de belangrijkste container voor je navigatiedata en tracks.
Je moet een boat aanmaken voordat je data verstuurt.


Wat gebeurt er wanneer ik een boat aanmaak?

  • Er wordt automatisch een test track gegenereerd
  • Voorbeelddata wordt eraan gekoppeld
  • Je kunt onmiddellijk de visualisatie testen

Wat is de Direct URL?

De Direct URL geeft publieke toegang tot:

  • De huidige positie van de boat
  • De LiveTrack (indien ingeschakeld)

Voorbeeld:

https://boatname.trakkit.org


Wat is Active LiveTrack?

Active LiveTrack maakt realtime weergave van de beweging van je boat mogelijk.
Om dit in te schakelen:

  • Maak een track aan
  • Stel de einddatum in de toekomst in (bijv. 01/01/2050)
  • Selecteer deze in Boat > Edit > Active LiveTrack

📈 Data

Wat is Data?

Data is een verzameling GPS-punten en optionele navigatie-informatie (AWA, AWS, COG, SOG, enz.).


Welke bestandsformaten worden ondersteund?

  • .gpx
  • .nmea
  • .txt
  • E-mailtekstposities
  • Gecomprimeerde formaten: .zip, .gzip, .z, .xz, .7z, .tar, .tgz

Kan ik data handmatig uploaden?

Ja.
Ga naar DATA > Upload en upload je .gpx-, .nmea- of .txt-bestanden.


Kan ik data automatisch verzenden?

Ja. Je kunt data verzenden via:

  • E-mail naar spool@trakkit.org
  • SFTP (aanbevolen voor automatisering)
  • Companion apps
  • Satellietsystemen (bijv. Iridium Go)

Kan ik verschillende databronnen combineren?

Ja. Data kan op verschillende momenten uit meerdere bronnen komen:

  • Realtime satelliet-e-mails op zee
  • Volledige GPX-upload in de haven
  • NMEA-logs uit navigatiesoftware

Verwijdert het verwijderen van een Track de Data?

Nee.
Het verwijderen van een track verwijdert de data niet.

Om data te verwijderen, gebruik:

  • DATA > Delete
  • Verwijderen op datumbereik of BatchID

✉️ E-mail Data

Hoe verstuur ik data per e-mail?

Stuur het naar:

spool@trakkit.org

Je moet óf:

  • Een Tag opnemen in het e-mailonderwerp

OF

  • Je e-mailadres koppelen aan je boat

Wat heeft prioriteit: Tag of afzender-e-mail?

De Tag heeft prioriteit boven het e-mailadres van de afzender.


Welk formaat moet positiedata volgen?

Eén punt per regel:

Latitude Longitude YYYY-MM-DD HH:MM[:SS] [Timezone] [Optionele velden]

Voorbeeld:

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

Als er geen tijdzone is opgegeven, wordt UTC aangenomen.


📡 SFTP Upload

Waarom SFTP gebruiken?

SFTP is de aanbevolen methode voor geautomatiseerde overdrachten.


Wat zijn de beperkingen?

  • Maximale frequentie: 1 bestand elke 3 minuten
  • Maximale bestandsgrootte: 20 MB

Hoe data via SFTP te verzenden

  • Vraag een tagwachtwoord aan in: Boat > Mails & Tags > Password
  • Sla het wachtwoord onmiddellijk op. Het kan niet worden hersteld zodra het is weergegeven (je kunt indien nodig een nieuw wachtwoord aanvragen).
  • Het adres en de poort van de SFTP-server worden samen met het wachtwoord weergegeven.
  • Je kunt bestanden handmatig uploaden met een SFTP-client zoals FileZilla, of de automatiseringsscripts gebruiken die door JoliCompanion worden geleverd.

Hoe moeten bestanden worden genoemd?

TAG_YYYYMMDD_HHMMSS.data

Upload eerst als:

TAG_YYYYMMDD_HHMMSS.part

Hernoem daarna naar .data zodra de upload volledig is afgerond.


🏷️ Tags

Wat is een Tag?

Een Tag is een alias voor een boat.
Het maakt het volgende mogelijk:

  • Data-toewijzing
  • Toegangscontrole
  • SFTP-authenticatie

Kan ik meerdere Tags aanmaken?

Ja. Je kunt zoveel tags aanmaken als je wilt voor een boat.


Kan een Tag aan meerdere boten worden gekoppeld?

Nee. Een tag kan maar bij één boat horen.


Wat gebeurt er als ik een Tag verwijder?

Toegang via die tag wordt onmiddellijk ingetrokken.
Andere tags blijven geldig.


Kunnen Tags voor SFTP worden gebruikt?

Ja.

  • Tag = gebruikersnaam
  • Wachtwoord vereist

Wachtwoorden kunnen niet worden hersteld.


🗺️ Tracks

Wat is een Track?

Een Track is simpelweg een tijdssegment van data.

Het definieert:

  • Een startdatum/-tijd
  • Een einddatum/-tijd
  • Een naam

Het slaat zelf geen data op.


Kunnen meerdere tracks dezelfde data gebruiken?

Ja.
Tracks zijn slechts weergaven van bestaande data.


Wat gebeurt er als ik een track aanmaak voordat ik data upload?

Er wordt niets weergegeven totdat bijpassende data is geüpload.
De track wordt automatisch bijgewerkt wanneer data binnenkomt.


Wat is WPP en WPO?

  • WPP (Track precision): interval in seconden tussen weergegeven trackpunten
  • WPO (Progress points): interval in minuten tussen oranje voortgangsmarkeringen

Aanbevolen WPP-waarden:

  • 10 seconden → Regatta’s
  • 60 seconden → Kustnavigatie
  • 300 seconden → Offshore navigatie

Hoe regenereer ik een track?

Ga naar:

TRACK > Regen


Hoe kan ik een track publiek maken?

Vink de optie Published aan bij het bewerken van de track.


🗺️ Tracks bekijken

Hoe bekijk ik een track?

Directe link:

https://trakkit.org/ttr/

Of voer de Track ID in op de homepage.


📡 Live Tracking

Hoe schakel ik live tracking in?

  1. Stel een Direct URL in
  2. Maak een track aan met een einddatum in de toekomst
  3. Selecteer deze als Active LiveTrack

Hoe embed ik live tracking op mijn website?

Voorbeeld-HTML:

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

💻 Companion Apps

Wat is een Companion App?

Een companion app is een applicatie van derden die:

  • Navigatiedata verzamelt
  • Die automatisch naar Trakkit verzendt

Is er een referentie-implementatie voor een Companion App?

Ja.
De Python-basiscode van JoliCompanion is beschikbaar op Trakkit.org en GitHub. Die kan worden aangepast aan je setup.


🔐 Data & zichtbaarheid

Is data automatisch zichtbaar?

Nee.
Data wordt pas zichtbaar wanneer een Track een tijdsinterval definieert dat deze omvat.


Moet ik vertrek- en aankomsttijden verbergen?

Ja.
Het wordt sterk aanbevolen om de start- en eindtijden van de track zo in te stellen dat je exacte vertrek- en aankomstpunten niet permanent zichtbaar zijn.


🧭 Samenvatting

Trakkit is opgebouwd rond drie kernobjecten:

  • Boat
  • Data
  • Track

Data is continu.
Tracks zijn weergaven.
Tags regelen toegang.
Live tracking is optioneel.

Eenvoudig, flexibel en ontworpen voor echt offshore zeilen.