EN DE ES FR IT NL

Welkom bij Trakkit.org

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

Het stelt je in staat om:

  • Navigatietracks aan te maken, te bekijken en te delen.
  • Ze in applicaties of websites te embedden.
  • Tracks te delen via een eenvoudige weblink of rechtstreeks vanaf de homepage van de website.
  • Real-time tracking in te schakelen via automatische uploads van NMEA, GPX of TEXT Data via email of SFTP.
  • Je positie op NoForeignLand automatisch bij te werken.

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 bezoeken: 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 begint met het uploaden van je eigen data.

📚 Algemene documentatie

Alles in Trakkit.org draait om drie objecten:

  • Boat
  • Data
  • Track

Data is gekoppeld aan een boat. 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 is gekoppeld. Data kan continu worden verzonden. Tracks definiëren enkel 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 die die data zichtbaar maakt. Dezelfde data kan in meerdere tracks voorkomen.

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


Het aanmaken van een boat is de eerste stap die nodig is om data te importeren en tracks te koppelen.


📝 Beschikbare velden


  • Name (verplicht): Identificeert de boat.
  • 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 bij real-time tracking zal worden weergegeven. Vooraf moet via het menu Track een speciale track worden aangemaakt en daarna hier worden geselecteerd. 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 real-time tracking alleen het icoon met de laatst bekende positie weergegeven.
  • Direct URL: Een openbaar webadres dat directe toegang geeft tot de huidige positie van de boat (en de LiveTrack indien gedefinieerd). Over het algemeen wordt aanbevolen de boatnaam te gebruiken. <boatname>.trakkit.org
  • Email: Adres van waaruit de trackingmails worden verzonden. Dit wordt overschreven als er een geldige TAG in het onderwerp van de mail staat.
  • Noforeignland Email: Als je een NoForeignLand-account hebt, voeg dit e-mailadres toe als tracking-afzender in je NFL-accountinstellingen, en je positie op NFL wordt automatisch bijgewerkt vanuit Trakkit.org.
  • Tags: Tags zijn aliassen voor je boat. Je kunt ze gebruiken om data te verzenden, toegang te krijgen tot de SFTP-server, of je eigen datazender 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 boat aanmaakt, worden automatisch een test track en een set voorbeelddata gegenereerd. Zo kun je snel vertrouwd raken met de boatparameters en trackvisualisatie. Deze test track en de data worden automatisch verwijderd bij de eerste import van echte data.


🏷️ Tags


Tags zijn alternatieve aliassen die worden gebruikt om een boat te identificeren. Het belangrijkste doel 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 toegang.

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

Om data aan te leveren via companion-apparaten 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 boat.
  • Tags kunnen met groepen of individuen gedeeld worden om toegang te verlenen.
  • Een tag kan op elk moment worden verwijderd zonder impact op Boats, Tracks of Data.
  • Tags kunnen gebruikt worden om data per e-mail te verzenden vanaf elk e-mailadres, door simpelweg de tag in het onderwerp te zetten. Deel in dit geval de tag met niemand.
  • Tags met wachtwoorden kunnen worden gebruikt voor toegang tot de SFTP-server, waarbij de Tag dient als gebruikersnaam.




📈 Data


Zodra 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 sensorinformatie (AWA, AWS, enz.) voor een boat.

Data kan verschillende vormen aannemen:

  • Een GPX-bestand dat door een GPS-apparaat is gegenereerd of is geëxporteerd uit apps zoals Navionics Boating
  • NMEA 0183-bestandstraffic, opgenomen met apps zoals OpenCPN of QtVlm of een companion-app.
  • Een gewoon TEXT-bestand met GPS-positie-informatie, zoals die per e-mail worden verzonden met apparaten zoals Iridium Go:

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

Of een regel met dit patroon:

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

NB: Latitude en Longitude zijn in decimale graden. Datum, tijd en tijdzone kunnen worden gecombineerd tot één enkel ISO-formaat: 2025-11-10T14:26:05Z. Meerdere regels zijn toegestaan in een tekstbericht of bestandsbijlage.

Voorbeeld van een acceptabel TEXT-formaat:

-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


Hoe DATA te verzenden:


Je kunt Data op verschillende manieren en op verschillende momenten verzenden. Met een internetverbinding op zee kun je data in real time verzenden. Zo niet, sla dan gewoon een GPX-, NMEA- of TEXT-bestand op vanuit je GPS- of navigatiesysteem en upload het later wanneer je weer online bent. De volgorde, datum en tijd van dataverzending maken niet uit; alleen de tijdstempels in de data zelf zijn relevant. Het meerdere keren uploaden van dezelfde data heeft geen invloed op je Data en beschadigt die niet. Hier zijn de verschillende manieren om je data te verzenden:

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


📤 Via directe Data-upload naar Trakkit.org:

Een van de eenvoudigste manieren is inloggen op Trakkit.org, DATA>UPLOAD en je GPX-, NMEA- of TEXT-bestand uploaden dat is geëxporteerd 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-overdracht en grote bestanden.

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

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

Na het verbinden 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-gegevens die voor de verbinding zijn gebruikt.

➡️ Bij handmatige upload wordt sterk aanbevolen om eerst het bestand te uploaden met de extensie .part (bijv. TAG_YYYYMMDD_HHMMSS.gz.part) en het daarna te hernoemen naar .data zodra de overdracht is voltooid. Zo wordt gegarandeerd dat het bestand niet wordt 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 opnemen in het onderwerp van je e-mail (BOATS > Mails & Tags), óf vóór verzending per mail je e-mailadres aan je boat koppelen op Trakkit.org. Zo kan Trakkit.org de data aan de juiste Boat koppelen.

Toewijzingsregels:

  • Als het e-mailadres van de afzender gekoppeld is aan een BOAT op Trakkit.org, wordt de DATA aan die boat toegewezen.
  • Als er een TAG-alias is opgegeven in de Subject-regel van de e-mail, wordt de DATA toegewezen aan de boat die aan die Tag is gekoppeld.
  • Bij tegenstrijdige informatie heeft de Tag voorrang op de e-mail.
  • Je kunt de data als bestandsbijlage verzenden of in de berichttekst schrijven

Opmerking: E-mail is niet de aanbevolen methode, omdat de meeste providers bericht- en bijlagegroottes strikt beperken en deze zonder melding kunnen weigeren. Deze methode moet worden gereserveerd voor kleine tekstdata of trackers met lage bandbreedte 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 gegevensdeel
  • Het verwijderen van een track verwijdert de data niet.


---

🗺️ TRACKS:

In tegenstelling tot andere navigatiesystemen is een Track in Trakkit simpelweg een benoemd tijdssegment binnen een set Data.

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

Trakkit controleert of er overeenkomstige Data beschikbaar is voor dat interval 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 boat 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, typisch door NMEA-zinnen te uploaden.
  • Default Layer: De voorgrondlaag van de kaart die wordt gebruikt. De standaard is OSM SRTM Topographic. Let op dat 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 progress points (de oranje punten).
  • WPP: Interval in seconden voor de track points (Track precision).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 oversteken” zijn goede richtlijnen. Voor real-time tracking (LiveTrack) mag dit nooit lager dan 300 seconden worden ingesteld. Zodra de track en navigatie zijn voltooid, kun je indien nodig de definitieve track opnieuw genereren met hogere precisie.
  • Published: Vink dit aan als je de track wilt opnemen in de "TRACK LIST" die zichtbaar is op je boatpagina op https://.trakkit.org
  • Herinnering: Het verwijderen van een Track verwijdert de Data niet.

We raden 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 homepagina met de TRACK-ID
  • Tracks worden statisch gerenderd en alleen automatisch ververst wanneer nieuwe data wordt geïmporteerd
  • Kan handmatig opnieuw worden gegenereerd (TRACK > Regen)

Je kunt een responsieve link in je eigen pagina of website integreren met de directe URL die in je boatsectie wordt aangegeven:

    <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 wordt gebruikt om een track te genereren, kan de weergegeven URL variëren. Maar je moet altijd het formaat https://trakkit.org/ttr/<TRACK-ID> gebruiken om een track te benaderen, zelfs als Trakkit deze later intern hernoemt of omleidt.

Real-Time Tracking visualiseren

Kies in Boat > Edit > Direct URL een URL voor je boat (meestal de boatnaam).

Je kunt de positie van je boat 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 boat weergegeven. Anders wordt alleen de laatst bekende positie getoond.

De standaard live tracking pagina toont navigatie-info en knoppen die toegang geven tot de Live Weather Map, de Track List (voor tracks gemarkeerd als Public) en de Full Screen-weergave. Let erop dat live weerdatas door een externe dienst worden geleverd, buiten onze controle mogelijk niet beschikbaar zijn, en niet gegarandeerd nauwkeurig zijn.

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

Je kunt de live tracking weergave (of elke andere track) rechtstreeks in een iframe op je eigen website of persoonlijke pagina embedden.
Bijvoorbeeld: om https://boatname.trakkit.org te embedden, 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-afzendadres (iets zoals nfl_xxxxx@trakkit.org) dat aan jou is toegewezen in Boat > Mails & Tag > NoForeignLand toe aan de e-mail synchronisatie-instellingen van je NoForeignLand account.

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

⚠️ Let op: NoForeignLand gebruikt geen GNSS-tijdstempels; in plaats daarvan komt de geregistreerde tijdstempel overeen met het moment van synchronisatie. 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-applicatie, is vrij beschikbaar en kan eenvoudig worden aangepast aan je setup. Je kunt deze downloaden via 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 real-time tracking.