Benvenuti su Trakkit.org

Trakkit.org è il front-end di un motore di rendering delle tracce per la vela da diporto e d’altura.

Ti consente di:

  • Creare, visualizzare e condividere tracce di navigazione.
  • Integrarle in applicazioni o siti web.
  • Condividere tracce tramite un semplice link web o direttamente dalla homepage del sito.
  • Abilitare il tracciamento in tempo reale tramite upload automatici di dati NMEA, GPX o TEXT via email o SFTP.
  • Aggiornare automaticamente la tua posizione su NoForeignLand.

Trakkit.org non raccoglie alcun dato personale.


🚀 Avvio rapido

Per aiutarti a partire e familiarizzare rapidamente, segui questi passaggi:

  1. Crea un account (gratuito)
  2. Crea una Boat
  3. Un set di dati di esempio e un Track di test sono stati creati automaticamente.
  4. Prova il Track di esempio visitando: https://<boatname>.trakkit.org
  5. Carica i tuoi dati usando un normale file .GPX: DATA > Upload
  6. Crea un track: TRACK > Add Track per scegliere quale parte dei dati vuoi visualizzare
  7. Viene assegnato un TTR ID e il track può essere condiviso a: https://trakkit.org/ttr/<TRACK-ID-TTR>

NB: Il set di dati di esempio viene eliminato automaticamente non appena inizi a caricare i tuoi dati.


📚 Documentazione generale

Tutto in Trakkit.org ruota attorno a tre oggetti:

  • Boat
  • Data
  • Track

I Data sono collegati a una Boat. Un Track è un segmento di Data compreso tra due date.

🔧 Come funziona?

È essenziale capire che in Trakkit i Data non sono legati ai Track. I Data possono essere inviati in modo continuo. I Track definiscono semplicemente intervalli di date entro i quali i Data corrispondenti sono visibili. Eliminare un Track non influisce sui Data. I Data sono visibili solo se è definito un Track che li renda visibili. Gli stessi Data possono apparire in più Track.

Struttura di base:

  • 1 User può avere diverse Boats
  • 1 Boat appartiene a 1 solo user
  • 1 Boat può avere tutti i Tracks necessari
  • Più Tracks possono usare gli stessi Data
  • Eliminare un Track non influisce sui Data




🛥️ Boat


La creazione di una boat è il primo passaggio necessario per importare Data e associare i Track.


📝 Campi disponibili


  • Name (obbligatorio): Identifica la boat.
  • Maxspeed: In nodi. Usato per rilevare potenziali anomalie della posizione GPS (es. velocità non realistiche) e per calibrare la scala colori quando SOG è selezionato per la colorazione del track.
  • Info: Un campo opzionale, puramente informativo. Inserisci ciò che vuoi.
  • Active LiveTrack: Il track che verrà mostrato nel tracciamento in tempo reale. Un track dedicato deve essere creato prima tramite il menu Track, quindi selezionato qui. Per essere idoneo al LiveTrack, il track deve avere una data di fine nel futuro (es. 1/1/2050). Se il campo viene lasciato vuoto, nel tracciamento in tempo reale verrà mostrata solo l’icona dell’ultima posizione nota.
  • Direct URL: Un indirizzo web pubblico che fornisce accesso diretto alla posizione corrente della boat (e al suo LiveTrack se definito). In genere è consigliato usare il nome della boat. <boatname>.trakkit.org
  • Email: Indirizzo da cui verranno inviate le email di tracking. Questo viene ignorato se nel soggetto dell’email è incluso un TAG valido.
  • Noforeignland Email: Se hai un account NoForeignLand, aggiungi questo indirizzo email come mittente di tracking nelle impostazioni del tuo account NFL, e la tua posizione su NFL verrà aggiornata automaticamente da Trakkit.org.
  • Tags: I Tag sono alias per la tua boat. Puoi usarli per inviare Data, accedere al server SFTP o creare il tuo data sender. Per inviare Data tramite il nostro server SFTP, crea una password del Tag (Boat > Tags & Mails > Edit Tag > Create Password).

Test Track: Quando crei una boat per la prima volta, vengono generati automaticamente un track di test e un set di Data di esempio. Questo ti permette di familiarizzare rapidamente con i parametri della boat e la visualizzazione del track. Questo track di test e i suoi Data verranno eliminati automaticamente al primo import di Data reali.


🏷️ Tags


I Tags sono alias alternativi usati per identificare una boat. Lo scopo principale di un tag è concedere accesso a uno specifico gruppo di persone. Eliminare un tag rimuoverà l’accesso per quel gruppo, ma chiunque usi un tag diverso avrà ancora accesso.

Tipicamente, crei un tag separato per ciascun sistema che invia Data alla boat. Boat > Mails & Tag > Add Tag Se l’accesso a un sistema diventa compromesso o non disponibile, elimina semplicemente il tag associato.

Campi disponibili:

  • INFO: Un campo puramente informativo per aiutarti a ricordare come usi il Tag. Inserisci ciò che vuoi.
  • ALLOWED TO SEND MAIL: Spunta questa casella se vuoi usare il Tag per inviare Data via email.

Per inviare Data tramite dispositivi companion o usare il server SFTP, devi creare un tag con password:
Boat > Mails & Tag > Edit > Create Password

⚠️ Assicurati di ricordare questa password, perché non può essere recuperata. Se la password viene persa, dovrai crearne una nuova.

  • Puoi creare tutti i tag che vuoi per una determinata boat.
  • I tag possono essere condivisi con gruppi o individui per concedere accesso.
  • Un tag può essere eliminato in qualsiasi momento senza impatto su Boats, Tracks o Data.
  • I tag possono essere usati per inviare Data via email da qualsiasi indirizzo email, semplicemente mettendo il tag nell’oggetto. In questo caso, il tag deve essere autorizzato in anticipo e dovrebbe essere condiviso solo con le entità pertinenti.
  • I tag con password possono essere usati per accedere al server SFTP.





🗺️📍 Data


Una volta creata una Boat, puoi alimentare Trakkit.org con Data per questa Boat.


Cosa sono i DATA?


I Data consistono di coordinate GPS, data e ora, insieme a eventuali informazioni dei sensori disponibili come AWA, AWS, ecc. Sono memorizzati nel database di Trakkit e usati per creare i diversi Tracks.

I Data possono assumere diverse forme:

  • Un file GPX generato da un dispositivo GPS o esportato da app come Navionics Boating
  • Un file NMEA 0183 con traffico emesso direttamente dal tuo sistema di navigazione (sono riconosciuti i messaggi GNSS di GPS, Galileo e GLONASS). Metodo preferito quando usato con l’app companion per il tracciamento in tempo reale.
  • Un file TEXT semplice.
  • Un file CSV con i nomi dei campi nella prima riga, come comunemente esportato da applicazioni quali OpenCPN o QtVlm.

CSV:

Separatore: I separatori di campo supportati sono virgola (,), punto e virgola (;), pipe (|) o TAB, purché non ci sia ambiguità con il formato dei dati (ad esempio i separatori decimali). Se il formato non può essere interpretato senza ambiguità, il file verrà rifiutato.

Campi obbligatori: - DATE (formato ISO 8601 - i valori senza fuso orario sono considerati in UTC) - LAT - LON (in gradi decimali)

Campi opzionali: Possono essere forniti campi aggiuntivi: AWS, AWA, COG, SOG, TWA, TWS, MTW, MTA, HDG, TWD, CTW, MBP, STW, DEPTH, RPM, ELEV. Velocità in nodi, angoli in gradi, profondità in metri, temperatura in Celsius. Qualsiasi campo marcato come (calc) verrà ignorato, poiché Trakkit è progettato per acquisire solo dati grezzi prodotti direttamente dai sistemi di navigazione di bordo. I campi non riconosciuti vengono ignorati.

Esempio di CSV DATA valido:

  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

Un riferimento completo al formato CSV e alle sue varianti è disponibile qui.

TEXT:

Un normale file di testo semplice (o il corpo di un’email), con una posizione per riga.

Esempio di TEXT DATA valido:

20260814 103025 48.12345 -4.56789   # UTC implicit
2026-08-14T12:30:25+02:00 48.12345 -4.56789

Per ragioni storiche e compatibilità con i formati di testo legacy di Iridium GO, i vecchi formati TEXT di Trakkit restano supportati ma sono deprecati. Da ora in poi, dovrebbe essere usato solo il formato CSV.

Un riferimento completo al formato TEXT e alle sue varianti è disponibile qui.

NMEA:

Esempio di frasi NMEA183 valide:

$GPRMC,000003.199,A,4408.04134,N,03341.96985,W,6.86,103.55,130623,,,D*70
$WIMWV,87.99,R,21.18,N,A*26


Come inviare DATA:


Puoi inviare Data in modi diversi e in momenti diversi. Con una connessione Internet in mare, puoi inviare i Data in tempo reale. Altrimenti, salva semplicemente un file GPX, NMEA o TEXT dal tuo GPS o sistema di navigazione e caricalo in seguito quando torni online. L’ordine, la data e l’ora della trasmissione dei Data non contano; sono rilevanti solo i timestamp contenuti nei Data. Caricare gli stessi Data più volte non influisce né corrompe i tuoi Data. Ecco i diversi modi per inviare i tuoi Data:

Qualunque metodo di upload tu scelga, tutti i Data possono essere compressi in: .zip .gzip .z .xz .7z .tar .tgz


📤 Tramite upload diretto dei Data su Trakkit.org:

Uno dei modi più semplici è accedere a Trakkit.org, DATA>UPLOAD e caricare il tuo file GPX, NMEA o TEXT esportato da app di navigazione o dispositivo GNSS.


🤖 Tramite App Android

Sono disponibili diverse app Android. Consigliamo GPSLogger by Mendhak, che supporta upload di dati live via SFTP.

GPSLogger GPSLogger by Mendhak

Questa app non è disponibile direttamente sul Google Play Store, ma puoi scaricarne l’APK da GitHub o F-Droid.

Per prima cosa, crea un LiveTrack e un TAG con password nel tuo account Trakkit. Poi configura le seguenti impostazioni nell’app:

  • Scegli SFTP
  • Scegli "How often ? 5 minutes"
  • Abilita "Allow auto sending"
  • Server: sftp.trakkit.org
  • Port: 38888
  • Directory: /upload
  • User:
  • Password:


📡 Tramite SFTP:

Puoi inviare i tuoi file al server SFTP di Trakkit, che è il metodo consigliato per trasferimenti automatici di Data e file di grandi dimensioni.

Credenziali & indirizzo del server sono forniti quando richiedi una password del tag su Trakkit.org: BOATS > Mails & Tags > Create Tag Password

Restrizioni (fair use policy): Frequenza massima di upload: 1 connessione ogni 3 minuti. Dimensione massima del file: 50 MB per upload. Il mancato rispetto di queste raccomandazioni può comportare restrizioni sull’accesso agli upload o persino un ban permanente da Trakkit.org. Nota che 50 MB di dati compressi possono contenere oltre 24 ore di traffico NMEA completo.

Una volta connesso, carica semplicemente i tuoi Data nella directory /upload.

I file caricati devono seguire questo formato: TAG_YYYYMMDD_HHMMSS.data

Nota: TAG deve corrispondere alle credenziali del Tag usate per la connessione.

➡️ Per gli upload manuali, è fortemente consigliato caricare prima il file con estensione .part (es. TAG_YYYYMMDD_HHMMSS.gz.part) e poi rinominarlo in .data una volta completato il trasferimento. Questo garantisce che il file non venga elaborato prima che l’upload sia completamente terminato. Comprimi i file per risparmiare banda (es. .zip, .gzip, .z, gz, .xz, .7z, .tar, .tgz).

Puoi usare lo script Python sftp_send.py, disponibile su Trakkit.org in About > Downloads, che automatizza gli upload rispettando le impostazioni consigliate.


✉️ Tramite Mail:

Le email devono essere inviate a spool@trakkit.org

Devi includere un Tag nell’oggetto della tua email, oppure collegare il tuo indirizzo email alla tua boat su Trakkit.org prima dell’invio via mail. Questo consente a Trakkit.org di associare i Data alla Boat corretta.

Se usi un Tag nell’oggetto della tua email, devi prima autorizzare questo Tag all’invio di mail (BOATS > Mails & Tags > Edit > Allowed to send mail). Le email ricevute con un Tag non autorizzato verranno ignorate, anche se l’indirizzo email del mittente è già collegato.

Regole di assegnazione:

  • Se l’email del mittente è collegata a una BOAT su Trakkit.org, i DATA verranno assegnati a quella boat.
  • Se nell’oggetto dell’email è specificato un alias TAG autorizzato a inviare mail, i DATA verranno assegnati alla boat associata a quel Tag.
  • In caso di informazioni in conflitto, il Tag ha priorità rispetto all’email.
  • Puoi inviare i Data come allegato o scriverli nel corpo del messaggio

Nota: l’email non è il metodo consigliato, poiché la maggior parte dei provider limita rigidamente le dimensioni di messaggi e allegati e può rifiutarli senza preavviso. Questo metodo dovrebbe essere riservato a piccoli Data testuali o tracker a bassa banda come Iridium GO. Comprimi i file per risparmiare banda (es. .zip, .gzip, .z, .xz, .7z, .tar, .tgz).


🗑️ Eliminazione dei Data

Per eliminare i Data:

  • Usa il menu Data > Delete
  • Elimina per intervallo di date o BatchID
  • Ogni upload ha un BatchID; rimuovere un batch elimina solo quel blocco di Data
  • Eliminare un track non elimina i data.


🗂️ Batch

Ogni volta che i Data vengono caricati, viene assegnato un Batch ID. Tutti i Data caricati in una singola operazione condividono lo stesso Batch ID.

Ad esempio, se carichi 10.000 punti posizione in una volta sola, avranno tutti lo stesso Batch ID.

Lo scopo principale del Batch ID è identificare i Data caricati insieme dallo stesso dispositivo e permettere di eliminare l’intero upload in un’unica operazione. Questo può essere utile in caso di dispositivi difettosi o Data corrotti.

Nota: caricare gli stessi Data più volte è supportato e non richiede l’eliminazione manuale tramite Batch ID.

I Batch ID vengono conservati per almeno un anno dalla creazione. Dopo tale periodo, i Data sono considerati validi e il Batch ID può essere rimosso.



🗺️ TRACKS:

A differenza di altri sistemi di navigazione, un Track in Trakkit è semplicemente una porzione di tempo con un nome all’interno di un insieme di Data.

Definisci gli orari di inizio e fine e gli dai un nome.

Trakkit verificherà se sono disponibili Data corrispondenti per quell’intervallo e li visualizzerà in tal caso.

Se non ci sono Data disponibili, non verrà mostrato nulla. In seguito, se vengono caricati Data che corrispondono all’intervallo del track, il Track verrà aggiornato automaticamente.

Un Track può anche essere aggiornato manualmente tramite TRACK > Regen.

  • BoatName: La boat a cui il track deve essere associato.
  • TrackName: Nome visualizzato del track.
  • Start/End: Inizio/Fine: data/ora di inizio e fine. Il fuso orario predefinito è quello selezionato nel tuo Profile.
  • Color: Scegli il colore del track. Oltre ai colori fissi standard, puoi scegliere una modalità multicolore per il tuo track basata sulla velocità della boat (SOG) o sulla velocità del vento apparente (AWS). La SOG è calcolata automaticamente, ma per AWS devi averla fornita nei tuoi Data, tipicamente caricando frasi NMEA.
  • Default Layer: Il layer in primo piano della mappa da usare. Il predefinito è OSM SRTM Topographic. Nota che la disponibilità delle tile può variare, specialmente per quelle fornite da agenzie USA (NASA, NOAA, ecc.), a causa di restrizioni di finanziamento che interessano questi servizi negli Stati Uniti.
  • WPO: Intervallo in minuti per i punti di avanzamento (i punti arancioni).
  • Published: Seleziona questa opzione se vuoi elencare il track nella "TRACK LIST" visibile nella pagina della tua boat su https://.trakkit.org
  • Published: Quando abilitato, il track appare nella lista pubblica dei track mostrata nella pagina live della boat. Quando disabilitato, il track non è elencato ma resta accessibile direttamente tramite il suo Track ID (TTR).
  • Promemoria: Eliminare un Track non elimina i Data.
  • Define as LiveTrack: Il track viene designato come LiveTrack attivo della boat. Questo è possibile solo se la data di fine è impostata nel futuro.

Consigliamo vivamente di impostare la data/ora di inizio e fine del tuo track in modo che i punti esatti di partenza e arrivo non siano visualizzati permanentemente

Indicatori di stato del Track

I track possono mostrare un indicatore luminoso colorato che indica lo stato LiveTrack:

  • 🟢 Verde (fisso): Active LiveTrack.
  • 🟢 Verde (lampeggiante): LiveTrack programmato per iniziare in futuro.
  • 🟠 Arancione (lampeggiante): candidato LiveTrack — il Track può essere selezionato come LiveTrack, ma non è attualmente selezionato.
  • 🔴 Rosso (lampeggiante): LiveTrack scaduto — il Track è ancora selezionato come LiveTrack della Boat, ma la sua data di fine è passata.
  • 🔴 Rosso (fisso): Track senza Data

Visualizzazione di un Track

  • Link diretto: https://trakkit.org/ttr/<TRACK-ID>
  • Dalla home page con TRACK-ID
  • I track sono renderizzati staticamente e vengono aggiornati automaticamente solo quando vengono importati nuovi Data
  • Possono essere rigenerati manualmente (TRACK > Regen)

Puoi integrare un link responsive nella tua pagina o sito web usando l’URL diretto fornito nella sezione della tua boat:

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

Nota: a seconda del motore di rendering usato per generare un track, l’URL visualizzato può variare. Tuttavia, dovresti sempre usare il formato https://trakkit.org/ttr/<TRACK-ID> per accedere a un track, anche se Trakkit in seguito lo rinomina o lo reindirizza internamente.


Visualizzazione del tracciamento in tempo reale

In Boat > Edit > Direct URL, scegli un URL per la tua boat (di solito il nome della boat).

Puoi visualizzare direttamente la posizione della tua boat a:
https://boatname.trakkit.org

Dove 'boatname' è il nome indicato in Direct URL.

Se un LiveTrack è abilitato (Boat > Edit > Active LiveTrack), verrà mostrato anche il track della boat. Altrimenti, verrà mostrata solo l’ultima posizione nota.

La pagina predefinita di tracciamento live mostra info di navigazione e pulsanti che danno accesso alla Live Weather Map, alla Track List (per i track contrassegnati come Public) e alla vista Full Screen. Tieni presente che i dati meteo live sono forniti da un servizio di terze parti, possono non essere disponibili per cause fuori dal nostro controllo e non sono garantiti come accurati.

Probabilmente preferirai usare una vista a schermo intero senza il pannello dati all’interno dei frame incorporati nel tuo sito web o nelle tue pagine web. Puoi aprire direttamente una vista full-screen usando il seguente URL: https://trakkit.org/live/simple/boatname

Puoi incorporare la vista di tracciamento live (o qualsiasi altro track) direttamente in un iframe nel tuo sito web o pagina personale.
Per esempio, per incorporare https://boatname.trakkit.org, usa il seguente HTML:

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

Nota: l’aggiunta o l’eliminazione di Data attiva automaticamente un aggiornamento di tutti i track interessati dall’intervallo temporale corrispondente.


Multi-Tracks

Trakkit LiveMultiTracking

Il Multi-Tracking consente di visualizzare sulla stessa mappa più Tracks, appartenenti o meno allo User. Può essere usato per seguire una flotta, confrontare un Track con un riferimento di routing, seguire diverse Boats, combinare segmenti di Track separati.

  • Name: Nome del Multi-Track.
  • Default Layer: Sfondo mappa predefinito.
  • Public: Quando abilitato, il Multi-Track appare nella lista dei track nella pagina Live della Boat.

Una volta che un Multi-Track è creato e salvato, i Tracks possono essere aggiunti o rimossi da questo Multi-Track. Puoi selezionare i tuoi Tracks o aggiungere un Track esterno usando il suo TTR.

Un Multi-Track non può contenere un altro Multi-Track. Eliminare un Multi-Track non elimina i suoi singoli Tracks.

I Multi-Tracks sono accessibili e visualizzati come i track normali.

Se dei LiveTracks sono inclusi in un Multi-Track, vengono visualizzate anche le icone delle boats corrispondenti.

Un Multi-Track può essere designato come LiveTrack di una boat, a condizione che almeno uno dei track che lo compongono appartenente a quella boat abbia una data di fine impostata nel futuro.

La versione pubblica gratuita di Trakkit richiede che ogni visualizzazione LiveTrack sia associata a una boat di riferimento. Per il tracciamento live di un’intera flotta durante eventi come regate, drone battle o competizioni simili, contattaci in anticipo.

Nota: le scale colori possono differire tra le Boats, poiché dipendono dal MaxSpeed di ciascuna Boat. Quando le scale differiscono, ciascuna scala viene mostrata separatamente. Tieni presenti queste differenze quando confronti i Tracks e interpreti i loro colori.



NoForeignLand


Se hai un account NoForeignLand, Trakkit può inviare automaticamente la tua posizione per aggiornare la tua localizzazione sul sito NoForeignLand.

Per abilitare questa funzionalità, aggiungi l’indirizzo di invio Trakkit (qualcosa come nfl_xxxxx@trakkit.org) assegnato a te in Boat > Mails & Tag > NoForeignLand alle impostazioni di sincronizzazione email del tuo account NoForeignLand.

Una volta registrato questo indirizzo su NoForeignLand, clicca “Activate” in Trakkit. La tua posizione verrà quindi inviata via email a intervalli regolari. La sincronizzazione può essere disattivata qui in qualsiasi momento.

⚠️ Nota che NoForeignLand non usa i timestamp GNSS; invece, il timestamp registrato corrisponde al momento della sincronizzazione. Gli aggiornamenti di posizione vengono eseguiti al massimo ogni 6 ore.




💻 Companion App


Una companion app è un’applicazione di terze parti che raccoglie e invia Data a Trakkit.

Il codice basato su Python di "joli_compagnon," l’applicazione companion standard di Trakkit, è liberamente disponibile e può essere facilmente adattato al tuo setup. Può essere scaricato da Trakkit.org > About > Download Tools.

Puoi configurare una soluzione di tracking completa e autonoma usando un semplice Raspberry Pi o qualsiasi altro mini-computer. L’intero processo di configurazione è descritto nelle seguenti guide: DIY Tracker with USB GPS e DIY Tracker with NMEA Gateway.

Questa è la soluzione preferita per il tracciamento in tempo reale.