EN DE ES FR IT NL

Benvenuti su Trakkit.org

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

Permette di:

  • Creare, visualizzare e condividere tracce di navigazione.
  • Integrarle in applicazioni o siti web.
  • Condividere le 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 iniziare e prendere rapidamente confidenza, segui questi passaggi:

  1. Crea un account (gratuito)
  2. Crea una Boat
  3. Un set di dati di esempio e una Track di test sono stati creati automaticamente.
  4. Testa la Track di esempio visitando: https://<boatname>.trakkit.org
  5. Carica i tuoi dati usando un normale file .GPX: DATA > Upload
  6. Crea una traccia: TRACK > Add Track per scegliere quale parte dei dati vuoi visualizzare
  7. Viene assegnato un TTR ID e la traccia può essere condivisa 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. Una track è un segmento di data tra due date.

🔧 Come funziona?

È essenziale capire che in Trakkit i Data non sono legati alle Track. I Data possono essere inviati in modo continuo. Le Track definiscono semplicemente gli intervalli di date entro i quali i Data corrispondenti sono visibili. Eliminare una Track non influisce sui Data. I Data sono visibili solo se esiste una Track che li rende 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 tutte le Tracks necessarie
  • Più Tracks possono usare gli stessi Data
  • Eliminare una Track non influisce sui Data



🛥️ Boat


Creare una boat è il primo passo necessario per importare Data e associare Track.


📝 Campi disponibili


  • Name (obbligatorio): identifica la boat.
  • Maxspeed: in nodi. Usato per rilevare potenziali anomalie dei punti GPS (es. velocità irrealistiche).
  • Info: un campo opzionale, puramente informativo. Inserisci ciò che vuoi.
  • Active LiveTrack: la track che verrà visualizzata nel tracciamento in tempo reale. Una track dedicata deve essere creata in precedenza tramite il menu Track, poi selezionata qui. Per essere idonea al LiveTrack, la track deve avere una data di fine nel futuro (es. 1/1/2050). Se il campo è lasciato vuoto, nel tracciamento in tempo reale verrà visualizzata 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 si consiglia di 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 del tracking nelle impostazioni del tuo account NFL e la tua posizione su NFL sarà 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 sender di Data. 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 una track di test e un set di Data di esempio. Questo ti permette di prendere rapidamente confidenza con i parametri della boat e la visualizzazione delle track. Questa track di test e i suoi Data verranno eliminati automaticamente al primo import di dati reali.


🏷️ Tag


I Tag 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 rimuove l’accesso per quel gruppo, ma chiunque usi un tag diverso avrà comunque accesso.

Tipicamente, crei un tag separato per ogni sistema che alimenta di Data la boat. Boat > Mails & Tag > Add Tag Se l’accesso a un sistema diventa corrotto 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 preferisci.
  • ALLOWED TO SEND MAIL: seleziona questa casella se vuoi usare il Tag per inviare Data via email.

Per alimentare i 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, poiché 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 inserendo il tag nell’oggetto. In questo caso, non condividere il tag con nessuno.
  • I tag con password possono essere usati per accedere al server SFTP, con il Tag come nome utente.




📈 Data


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


Che cos’è DATA?


I Data sono una raccolta di punti GPS e informazioni opzionali dei sensori (AWA, AWS, ecc.) per una boat.

I Data possono assumere diverse forme:

  • Un file GPX generato da un dispositivo GPS o esportato da app come Navionics Boating
  • Un file di traffico NMEA 0183, registrato usando app come OpenCPN o QtVlm o una app companion.
  • Un file TEXT CSV che usa il punto e virgola (;) come separatore, con i nomi dei campi nella prima riga.

Campi obbligatori: - Date (formato ISO 8601 - i valori senza timezone si intendono in UTC) - LAT - LON (in gradi decimali)

Campi opzionali: Possono essere forniti campi aggiuntivi, come: AWA, AWS, COG, SOG, ecc.

Alcuni campi opzionali possono essere ignorati dal parser a seconda della versione.

Campi attualmente supportati: 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) sarà ignorato, poiché Trakkit è progettato per acquisire solo dati grezzi prodotti direttamente dai sistemi di navigazione di bordo.

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

Per ragioni storiche e per compatibilità con i formati testuali legacy di Iridium GO, i vecchi formati TEXT di Trakkit restano supportati ma sono deprecati e non dovrebbero essere usati per nuovi sviluppi. Da ora in poi deve essere usato solo il formato CSV.


Come inviare DATA:


Puoi inviare Data in modi diversi in momenti diversi. Con una connessione Internet in mare, puoi inviare data in tempo reale. Altrimenti, salva semplicemente un file GPX, NMEA o TEXT dal tuo GPS o sistema di navigazione e caricalo più tardi quando torni online. L’ordine, la data e l’ora di 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 di 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 un’app di navigazione o da un dispositivo GNSS.


📡 Tramite SFTP:

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

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

Limitazioni (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 all’accesso di 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 alla credenziale Tag usata 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 processato prima che l’upload sia terminato completamente. 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 raccomandate.


✉️ Tramite email:

Le email devono essere inviate a spool@trakkit.org

Devi includere un Tag nell’oggetto dell’email, oppure collegare il tuo indirizzo email alla tua boat su Trakkit.org prima di inviare via mail. Questo permette 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 all’invio di mail, i DATA verranno assegnati alla boat associata a quel Tag.
  • In caso di informazioni in conflitto, prevale il Tag rispetto all’email.
  • Puoi inviare i data come allegato oppure scriverli nel corpo del messaggio

Nota: l’email non è il metodo raccomandato, poiché molti provider limitano rigidamente la dimensione di messaggi e allegati e potrebbero 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 una track non elimina i data.


🗂️ Batch

Ogni volta che vengono caricati dei data, 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 consentire l’eliminazione dell’intero upload in un’unica operazione. Questo può essere utile in caso di dispositivi difettosi o data corrotti.

Nota: il caricamento ripetuto degli stessi data è supportato e non richiede l’eliminazione manuale tramite Batch ID.

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


🗺️ TRACKS:

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

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

Trakkit verificherà se esistono Data corrispondenti per quell’intervallo e li mostrerà in tal caso.

Se non ci sono data disponibili, non verrà mostrato nulla. In seguito, se vengono caricati Data che corrispondono all’intervallo della track, la Track sarà aggiornata automaticamente.

Una Track può anche essere aggiornata manualmente tramite TRACK > Regen.

  • BoatName: la boat a cui associare la track.
  • TrackName: nome visualizzato della track.
  • Color: scegli il colore della track. Oltre ai colori fissi standard, puoi scegliere una modalità multicolore per la tua track basata sulla velocità della boat (SOG) o sulla velocità del vento apparente (AWS). Il SOG è calcolato automaticamente, ma per AWS devi averlo fornito nei tuoi data, tipicamente caricando frasi NMEA.
  • Default Layer: il layer di primo piano della mappa da usare. Il default è OSM SRTM Topographic. Nota che la disponibilità delle tile può variare, soprattutto per quelle fornite da agenzie statunitensi (NASA, NOAA, ecc.), a causa di restrizioni di finanziamento che influenzano questi servizi negli Stati Uniti.
  • WPO: intervallo in minuti per i punti di avanzamento (i punti arancioni).
  • WPP: intervallo in secondi per i punti della track (precisione della Track). Attenzione: impostare una precisione troppo alta può rallentare drasticamente il rendering, il caricamento e la visualizzazione della track. Usa buon senso e regola la precisione in base al tipo di track: “60 per navigazione costiera, 300 per navigazione d’altura e 600 per lunghe traversate” sono buone linee guida. Per il tracciamento in tempo reale (LiveTrack), non dovrebbe mai essere impostato sotto i 300 secondi. Una volta terminata la track e la navigazione, puoi rigenerare la track finale con maggiore precisione se necessario.
  • Published: seleziona questa opzione se vuoi elencare la track nella "TRACK LIST" visibile nella pagina della tua boat su https://.trakkit.org
  • Promemoria: eliminare una Track non elimina i Data.

Consigliamo vivamente di impostare data/ora di inizio e fine della tua track in modo che i tuoi punti esatti di partenza e arrivo non siano mostrati permanentemente

Visualizzazione di una Track

  • Link diretto: https://trakkit.org/ttr/<TRACK-ID>
  • Dalla home page con TRACK-ID
  • Le track vengono renderizzate in modo statico e vengono aggiornate automaticamente solo quando vengono importati nuovi data
  • Possono essere rigenerate 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 una track, l’URL visualizzato può variare. Tuttavia, dovresti sempre usare il formato https://trakkit.org/ttr/<TRACK-ID> per accedere a una track, anche se Trakkit in seguito la rinomina o la 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 su:
https://boatname.trakkit.org

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

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

La pagina di live tracking predefinita mostra info di navigazione e pulsanti che danno accesso alla Live Weather Map, alla Track List (per le track contrassegnate come Public) e alla vista Full Screen. Nota che i dati meteo live sono forniti da un servizio di terze parti, possono non essere disponibili al di fuori del nostro controllo e non è garantito che siano 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 live tracking (o qualsiasi altra track) direttamente in un iframe sul tuo sito web o pagina personale.
Ad 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>



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 che questo indirizzo è stato registrato 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 all’ora 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’app companion standard di Trakkit, è liberamente disponibile e può essere facilmente adattato alla tua configurazione. 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 setup è 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.