❓ Trakkit.org – FAQ
⚠️ Deze FAQ is een automatische vertaling die is gegenereerd op basis van de officiële Trakkit-documentatie.
Ze is uitsluitend bedoeld ter informatie.
🌍 Algemene vragen
Wat is Trakkit.org?
Trakkit.org is een webgebaseerde front-end voor een track-rendering-engine, bedoeld voor recreatie- en offshorezeilen.
Het stelt je in staat om 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 online kiest te publiceren.
Is Trakkit gratis?
Ja. Een account aanmaken en boats, data en tracks beheren is gratis.
🚀 Aan de slag
Hoe begin ik met Trakkit?
- Maak een gratis account aan
- Maak een Boat aan (alleen de boatnaam is vereist)
- Een voorbeelddataset en test track worden automatisch aangemaakt
- Ga naar: https://
.trakkit.org - Upload je eigen .gpx-bestand via DATA > Upload
- 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).
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 om een track betrouwbaar te openen altijd het canonieke formaat:
https://trakkit.org/ttr/<TRACK-ID>
🛥️ Boats
Wat is een Boat in Trakkit?
Een Boat is de hoofdcontainer voor je navigatie-data en tracks.
Je moet een boat aanmaken voordat je data kunt verzenden.
Wat gebeurt er wanneer ik een boat aanmaak?
- Er wordt automatisch een test track gegenereerd
- Voorbeelddata wordt eraan gekoppeld
- Je kunt de visualisatie meteen testen
Wat is de Direct URL?
De Direct URL biedt publieke toegang tot:
- De huidige positie van de boat
- De live track (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
- Zet de einddatum in de toekomst (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
- Posities als e-mailtekst
- 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 ook 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 verzend ik data per e-mail?
Verzend het naar:
spool@trakkit.org
Je moet ofwel:
- Een Tag opnemen in het onderwerp van de e-mail
OF
- Je e-mailadres aan je boat koppelen
Wat heeft prioriteit: Tag of afzender-e-mail?
De Tag heeft prioriteit boven het e-mailadres van de afzender.
Welk formaat moet de positiedata volgen?
Eén punt per regel:
Latitude Longitude YYYY-MM-DD HH:MM[:SS] [Timezone] [Optional fields]
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 te verzenden via SFTP
- Vraag een tag-wachtwoord 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 SFTP-serveradres en de poort 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 het volledig is geüpload.
🏷️ 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 boats worden gekoppeld?
Nee. Een tag kan slechts 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 worden gebruikt voor SFTP?
Ja.
- Tag = gebruikersnaam
- Wachtwoord vereist
Wachtwoorden kunnen niet worden hersteld.
🗺️ Tracks
Wat is een Track?
Een Track is simpelweg een tijdslice van data.
Hij definieert:
- Een startdatum/-tijd
- Een einddatum/-tijd
- Een naam
Hij 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 overeenkomende 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 openbaar 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?
- Stel een Direct URL in
- Maak een track aan met een toekomstige einddatum
- 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:
- Navigatie-data verzamelt
- Deze automatisch naar Trakkit verzendt
Is er een referentie-implementatie voor een Companion App?
Ja.
De Python-basiscodes van JoliCompanion zijn beschikbaar op Trakkit.org en GitHub. Deze kunnen worden aangepast aan jouw setup.
🔐 Data & zichtbaarheid
Is data automatisch zichtbaar?
Nee.
Data wordt pas zichtbaar wanneer een Track een tijdsinterval definieert dat deze data omvat.
Moet ik vertrek- en aankomsttijdstempels 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 offshorezeilen.