EN DE ES FR IT NL

Welcome bij Trakkit.org

Trakkit.org is de front-end voor een track-rendering engine voor recreatief en offshore zeilen.

Je kunt ermee:

  • Navigatie Tracks aanmaken, bekijken en delen.
  • Ze insluiten in applicaties of websites.
  • Tracks delen via een eenvoudige weblink of rechtstreeks vanaf de homepage van de website.
  • Realtime tracking inschakelen via automatische uploads van NMEA, GPX of TEXT Data via email of SFTP.
  • Je positie op NoForeignLand automatisch bijwerken.

Trakkit.org verzamelt geen persoonlijke gegevens.

🚀 Snel starten

Om je op weg te helpen en snel vertrouwd te raken, volg je deze stappen:

  1. Maak een account aan (gratis)
  2. Maak een Boat
  3. Er is automatisch een set voorbeelddata en een test Track aangemaakt.
  4. Test de voorbeeld Track door te gaan naar: https://<boatname>.trakkit.org
  5. Upload je eigen data met een gewoon .GPX bestand: DATA > Upload
  6. Maak een track aan: TRACK > Add Track om te kiezen welk deel van de data je wilt weergeven
  7. Er wordt een TTR ID toegewezen en de track kan gedeeld worden via: https://trakkit.org/ttr/<TRACK-ID-TTR>

NB: De voorbeelddataset wordt automatisch verwijderd zodra je je eigen data begint te uploaden.

📚 Algemene documentatie

Alles in Trakkit.org draait om drie objecten:

  • Boat
  • Data
  • Track

Data is gekoppeld aan een boot. Een track is een segment van data tussen twee datums.

🔧 Hoe werkt het?

Het is essentieel om te begrijpen dat in Trakkit, data niet aan tracks gekoppeld is. Data kan continu worden verzonden. Tracks definiëren simpelweg datumbereiken waarbinnen de bijbehorende data zichtbaar is. Het verwijderen van een track heeft geen invloed op de data. Data is alleen zichtbaar als er een track is gedefinieerd om die zichtbaar te maken. Dezelfde data kan in meerdere tracks verschijnen.

Basisstructuur:

  • 1 User kan meerdere Boats hebben
  • 1 Boat behoort slechts tot 1 user
  • 1 Boat kan zoveel Tracks hebben als nodig
  • Meerdere Tracks kunnen dezelfde Data gebruiken
  • Het verwijderen van een Track heeft geen invloed op de Data



🛥️ Boat


Een boot aanmaken is de eerste vereiste stap om data te importeren en tracks te koppelen.


📝 Beschikbare velden


  • Name (verplicht): Identificeert de boot.
  • Maxspeed: In knopen. Wordt gebruikt om mogelijke anomalieën in GPS-punten te detecteren (bijv. onrealistische snelheden).
  • Info: Een optioneel, puur informatief veld. Zet erin wat je wilt.
  • Active LiveTrack: De track die getoond wordt bij realtime tracking. Er moet vooraf een speciale track aangemaakt worden via het menu Track, en die selecteer je hier. Om in aanmerking te komen voor LiveTrack moet de track een einddatum in de toekomst hebben (bijv. 1/1/2050). Als dit veld leeg blijft, wordt bij realtime tracking alleen het icoon van de laatst bekende positie weergegeven.
  • Direct URL: Een openbaar webadres dat directe toegang geeft tot de huidige positie van de boot (en zijn LiveTrack indien gedefinieerd). Over het algemeen wordt aanbevolen de bootnaam te gebruiken. <boatname>.trakkit.org
  • Email: Adres waarvan de tracking-emails worden verzonden. Dit wordt overschreven als er een geldige TAG in het onderwerp van de email staat.
  • Noforeignland Email: Als je een NoForeignLand-account hebt, voeg dit emailadres toe als tracking-afzender in de instellingen van je NFL-account, en je positie op NFL wordt automatisch bijgewerkt vanuit Trakkit.org.
  • Tags: Tags zijn aliassen voor je boot. Je kunt ze gebruiken om data te verzenden, de SFTP-server te benaderen, of je eigen data-sender te maken. Om data via onze SFTP-server te verzenden, maak je een Tag-wachtwoord aan (Boat > Tags & Mails > Edit Tag > Create Password).

Test Track: Wanneer je voor het eerst een boot aanmaakt, worden automatisch een test track en een set voorbeelddata gegenereerd. Zo kun je snel vertrouwd raken met de bootparameters en trackvisualisatie. Deze test track en zijn data worden automatisch verwijderd bij de eerste import van echte data.


🏷️ Tags


Tags zijn alternatieve aliassen die gebruikt worden om een boot te identificeren. Het hoofddoel van een tag is om toegang te geven aan een specifieke groep mensen. Het verwijderen van een tag verwijdert de toegang voor die groep, maar iedereen die een andere tag gebruikt behoudt nog steeds toegang.

Doorgaans maak je een aparte tag aan voor elk systeem dat data naar de boot stuurt. Boat > Mails & Tag > Add Tag Als toegang tot een systeem beschadigd raakt of niet meer beschikbaar is, verwijder je gewoon de bijbehorende tag.

Beschikbare velden:

  • INFO: Een puur informatief veld om je te helpen onthouden hoe je de Tag gebruikt. Vul in wat je wilt.
  • ALLOWED TO SEND MAIL: Vink dit aan als je de Tag wilt gebruiken om data per email te verzenden.

Om data aan te leveren via companion devices of de SFTP-server te gebruiken, moet je een tag met een wachtwoord aanmaken:
Boat > Mails & Tag > Edit > Create Password

⚠️ Zorg dat je dit wachtwoord onthoudt, want het kan niet worden hersteld. Als het wachtwoord verloren is, moet je een nieuw wachtwoord aanmaken.

  • Je kunt zoveel tags aanmaken als je wilt voor een bepaalde boot.
  • Tags kunnen met groepen of individuen gedeeld worden om toegang te geven.
  • Een tag kan op elk moment verwijderd worden zonder impact op Boats, Tracks of Data.
  • Tags kunnen gebruikt worden om data per email te verzenden vanaf elk emailadres, door simpelweg de tag in de onderwerpregel te zetten. Deel in dat geval de tag met niemand.
  • Tags met wachtwoorden kunnen worden gebruikt om toegang te krijgen tot de SFTP-server, waarbij de Tag als gebruikersnaam dient.




📈 Data


Zodra er een Boat is aangemaakt, kun je Trakkit.org voeden met data voor deze Boat.


Wat is DATA?


Data is een verzameling GPS-punten en optionele sensorinfo (AWA, AWS, enz.) voor een boot.

Data kan verschillende vormen aannemen:

  • Een GPX-bestand gegenereerd door een GPS-apparaat of geëxporteerd uit apps zoals Navionics Boating
  • NMEA 0183-bestandstraffic, opgenomen met apps zoals OpenCPN of QtVlm of een companion app.
  • Een TEXT CSV-bestand met een puntkomma (;) als scheidingsteken, met veldnamen op de eerste regel.

Verplichte velden: - Date (ISO 8601-formaat - waarden zonder tijdzone worden verondersteld in UTC te zijn) - LAT - LON (in decimale graden)

Optionele velden: Er kunnen extra velden worden meegegeven, zoals: AWA, AWS, COG, SOG, enz.

Sommige optionele velden kunnen door de parser genegeerd worden afhankelijk van de versie.

Momenteel ondersteunde velden: AWS, AWA, COG, SOG, TWA, TWS, MTW, MTA, HDG, TWD, CTW, MBP, STW, DEPTH, RPM, ELEV

Snelheden in knopen, hoeken in graden, diepte in meters, temperatuur in Celsius. Elk veld gemarkeerd als (calc) wordt genegeerd, omdat Trakkit ontworpen is om alleen ruwe data in te lezen die rechtstreeks door navigatiesystemen aan boord wordt geproduceerd.

Voorbeeld van geldige 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

Om historische redenen en voor compatibiliteit met legacy Iridium GO-tekstformaten blijven Trakkit’s oudere TEXT-formaten ondersteund, maar ze zijn verouderd en zouden niet gebruikt moeten worden voor nieuwe ontwikkeling. Voortaan moet alleen het CSV-formaat gebruikt worden.


Hoe DATA te verzenden:


Je kunt Data op verschillende manieren en op verschillende momenten verzenden. Met een internetverbinding op zee kun je data in realtime verzenden. Anders sla je gewoon een GPX-, NMEA- of TEXT-bestand op van je GPS- of navigatiesysteem en upload je het later wanneer je weer online bent. De volgorde, datum en tijd van de datatransmissie maken niet uit; alleen de timestamps in de data zijn relevant. Het meerdere keren uploaden van dezelfde data heeft geen effect op je Data en beschadigt die niet. Dit zijn de verschillende manieren om je data te verzenden:

Welke uploadmethode je ook kiest, alle Data kan gecomprimeerd worden in: .zip .gzip .z .xz .7z .tar .tgz


📤 Via directe Data-upload naar Trakkit.org:

Een van de eenvoudigste manieren is in te loggen op Trakkit.org, DATA>UPLOAD en je GPX-, NMEA- of TEXT-bestand te uploaden dat geëxporteerd is uit een navigatie-app of GNSS-apparaat.


📡 Via SFTP:

Je kunt je bestanden naar de Trakkit SFTP server sturen; dit is de aanbevolen methode voor geautomatiseerde data-overdrachten en grote bestanden.

Inloggegevens & serveradres worden verstrekt wanneer je een tag-wachtwoord aanvraagt op Trakkit.org: BOATS > Mails & Tags > Create Tag Password

Beperkingen (fair use policy): Maximale uploadfrequentie: 1 verbinding elke 3 minuten. Maximale bestandsgrootte: 50 MB per upload. Als je deze aanbevelingen niet volgt, kan dat leiden tot beperkingen op uploadtoegang, of zelfs een permanente ban van Trakkit.org. Let op: 50 MB aan gecomprimeerde data kan meer dan 24 uur volledige NMEA-traffic opslaan.

Eenmaal verbonden upload je je data eenvoudig naar de map /upload.

Geüploade bestanden moeten dit formaat volgen: TAG_YYYYMMDD_HHMMSS.data

Opmerking: TAG moet overeenkomen met de Tag-inloggegevens die voor de verbinding worden gebruikt.

➡️ Bij handmatige upload wordt sterk aanbevolen om het bestand eerst te uploaden met de extensie .part (bijv. TAG_YYYYMMDD_HHMMSS.gz.part) en het vervolgens te hernoemen naar .data zodra de overdracht voltooid is. Zo wordt het bestand niet verwerkt voordat de upload volledig klaar is. Comprimeer je bestanden om bandbreedte te besparen (bijv. .zip, .gzip, .z, gz, .xz, .7z, .tar, .tgz).

Je kunt het Python-script sftp_send.py gebruiken, beschikbaar op Trakkit.org onder About > Downloads, dat uploads automatiseert terwijl het de aanbevolen instellingen volgt.


✉️ Via Mail:

Mails moeten worden verzonden naar spool@trakkit.org

Je moet óf een Tag in het onderwerp van je email opnemen, óf je emailadres koppelen aan je boot op Trakkit.org voordat je via mail verstuurt. Hiermee kan Trakkit.org de data aan de juiste Boat koppelen.

Als je een Tag in het onderwerp van je email gebruikt, moet je deze Tag eerst toestaan om mail te verzenden (BOATS > Mails & Tags > Edit > Allowed to send mail). Emails die ontvangen worden met een Tag die niet is toegestaan, worden genegeerd, zelfs als het emailadres van de afzender al gekoppeld is.

Toewijzingsregels:

  • Als het emailadres van de afzender gekoppeld is aan een BOAT op Trakkit.org, wordt de DATA aan die boot toegewezen.
  • Als een TAG alias die mail mag verzenden is opgegeven in de Subject-regel van de email, wordt de DATA toegewezen aan de boot die bij die Tag hoort.
  • Bij conflicterende informatie heeft de Tag voorrang op de email.
  • Je kunt de data als bijlage verzenden of in de berichttekst plaatsen

Opmerking: Email is niet de aanbevolen methode, omdat de meeste providers bericht- en bijlagegroottes strikt beperken en ze zonder melding kunnen weigeren. Deze methode moet gereserveerd worden voor kleine tekstdata of low-bandwidth trackers zoals Iridium GO. Comprimeer je bestanden om bandbreedte te besparen (bijv. .zip, .gzip, .z, .xz, .7z, .tar, .tgz).


🗑️ Data verwijderen

Om data te verwijderen:

  • Gebruik het menu Data > Delete
  • Verwijder op datumbereik of BatchID
  • Elke upload heeft een BatchID; het verwijderen van een batch verwijdert alleen dat datablok
  • Het verwijderen van een track verwijdert de data niet.


🗂️ Batches

Elke keer dat data wordt geüpload, wordt een Batch ID toegewezen. Alle data die in één operatie wordt geüpload, deelt dezelfde Batch ID.

Als je bijvoorbeeld 10.000 positiepunten in één keer uploadt, hebben ze allemaal dezelfde Batch ID.

Het belangrijkste doel van de Batch ID is om data te identificeren die samen is geüpload vanaf hetzelfde apparaat en om de volledige upload in één operatie te kunnen verwijderen. Dit kan nuttig zijn bij defecte apparaten of corrupte data.

Opmerking: Het meerdere keren uploaden van dezelfde data wordt ondersteund en vereist geen handmatige verwijdering met behulp van de Batch ID.

Batch IDs worden minimaal één jaar na aanmaak bewaard. Daarna wordt de data als geldig beschouwd en kan de Batch ID verwijderd worden.


🗺️ TRACKS:

In tegenstelling tot andere navigatiesystemen is een Track in Trakkit simpelweg een benoemde tijdslice binnen een set Data.

Je definieert de start- en eindtijden en geeft het een naam.

Trakkit controleert of er voor dat interval bijbehorende Data beschikbaar is en toont die indien aanwezig.

Als er geen data beschikbaar is, wordt er niets getoond. Later, als Data die overeenkomt met het interval van de track wordt geüpload, wordt de Track automatisch bijgewerkt.

Een Track kan ook handmatig worden bijgewerkt via TRACK > Regen.

  • BoatName: De boot waaraan de track gekoppeld moet worden.
  • TrackName: Weergavenaam van de track.
  • Color: Kies de kleur van de track. Naast de standaard vaste kleuren kun je een multicolor-modus kiezen voor je track op basis van de bootsnelheid (SOG) of de schijnbare windsnelheid (AWS). SOG wordt automatisch berekend, maar voor AWS moet je die in je data hebben aangeleverd, doorgaans door NMEA-zinnen te uploaden.
  • Default Layer: De kaart-voorgrondlaag die gebruikt moet worden. De standaard is OSM SRTM Topographic. Let op: de beschikbaarheid van tiles kan variëren, vooral voor tiles die door Amerikaanse instanties (NASA, NOAA, enz.) worden geleverd, door financieringsbeperkingen die deze diensten in de Verenigde Staten beïnvloeden.
  • WPO: Interval in minuten voor de voortgangspunten (de oranje punten).
  • WPP: Interval in seconden voor de trackpunten (Track-precisie). Waarschuwing: een te hoge precisie kan het renderen, laden en visualiseren van de track drastisch vertragen. Gebruik gezond verstand en pas de precisie aan op basis van het type track: “60 voor kustnavigatie, 300 voor offshore navigatie en 600 voor lange passages” zijn goede richtlijnen. Voor realtime tracking (LiveTrack) mag dit nooit onder 300 seconden worden ingesteld. Zodra de track en navigatie afgerond zijn, kun je desgewenst de definitieve track regenereren met hogere precisie.
  • Published: Vink dit aan als je de track wilt tonen in de "TRACK LIST" die zichtbaar is op je bootpagina op https://.trakkit.org
  • Herinnering: Het verwijderen van een Track verwijdert de Data niet.

We raden je sterk aan om de start- en einddatum/-tijd van je track zo in te stellen dat je exacte vertrek- en aankomstpunten niet permanent worden weergegeven

Een Track visualiseren

  • Directe link: https://trakkit.org/ttr/<TRACK-ID>
  • Vanaf de home page met de TRACK-ID
  • Tracks worden statisch gerenderd en alleen automatisch ververst wanneer nieuwe data wordt geïmporteerd
  • Kan handmatig geregenereerd worden (TRACK > Regen)

Je kunt een responsive link integreren in je eigen pagina of website door de directe URL te gebruiken die in je bootsectie wordt weergegeven:

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

Opmerking: Afhankelijk van de rendering engine die gebruikt wordt om een track te genereren, kan de weergegeven URL verschillen. Maar je moet altijd het formaat https://trakkit.org/ttr/<TRACK-ID> gebruiken om een track te benaderen, zelfs als Trakkit die later intern hernoemt of omleidt.

Realtime tracking visualiseren

Kies in Boat > Edit > Direct URL een URL voor je boot (meestal de bootnaam).

Je kunt de positie van je boot direct bekijken op:
https://boatname.trakkit.org

Waar 'boatname' de naam is die in Direct URL is opgegeven.

Als een LiveTrack is ingeschakeld (Boat > Edit > Active LiveTrack), wordt ook de track van de boot weergegeven. Anders wordt alleen de laatst bekende positie getoond.

De standaard live-trackingpagina toont nav-info en knoppen die toegang geven tot de Live Weather Map, de Track List (voor tracks die als Public gemarkeerd zijn) en de Full Screen-weergave. Let op dat live weersdata door een externe dienst wordt geleverd, buiten onze controle mogelijk niet beschikbaar is en niet gegarandeerd accuraat is.

Waarschijnlijk geef je de voorkeur aan een full-screen weergave zonder het datapaneel binnen de frames die in je eigen website of webpagina’s zijn ingesloten. Je kunt een full-screen weergave direct openen met de volgende URL: https://trakkit.org/live/simple/boatname

Je kunt de live-trackingweergave (of elke andere track) direct insluiten in een iframe op je eigen website of persoonlijke pagina.
Bijvoorbeeld, om https://boatname.trakkit.org in te sluiten, gebruik je de volgende HTML:

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



NoForeignLand


Als je een NoForeignLand account hebt, kan Trakkit automatisch je positie verzenden om je locatie op de NoForeignLand-website bij te werken.

Om deze functie in te schakelen, voeg je het Trakkit-afzenderadres (iets als nfl_xxxxx@trakkit.org) dat aan jou is toegewezen in Boat > Mails & Tag > NoForeignLand toe aan de email-synchronisatie-instellingen van je NoForeignLand-account.

Zodra dit adres is geregistreerd op NoForeignLand, klik je op “Activate” in Trakkit. Je positie wordt dan met regelmatige intervallen per email verzonden. De synchronisatie kan hier op elk moment worden uitgeschakeld.

⚠️ Let op: NoForeignLand gebruikt geen GNSS-timestamps; in plaats daarvan komt de geregistreerde timestamp overeen met het synchronisatiemoment. Positie-updates worden maximaal elke 6 uur uitgevoerd.



💻 Companion App


Een companion app is een applicatie van derden die data verzamelt en naar Trakkit verzendt.

De op Python gebaseerde code voor "joli_compagnon," Trakkit’s standaard companion application, is vrij beschikbaar en kan eenvoudig aan je setup worden aangepast. Deze kan worden gedownload vanaf Trakkit.org > About > Download Tools.

Je kunt een complete, zelfstandige trackingoplossing opzetten met een eenvoudige Raspberry Pi of een andere mini-computer. Het volledige setup-proces wordt beschreven in de volgende gidsen: DIY Tracker with USB GPS en DIY Tracker with NMEA Gateway.

Dit is de voorkeursoplossing voor realtime tracking.