EN DE ES FR IT NL

Benvenuto su Trakkit.org

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

Ti 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 Data 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 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 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 su: 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 tracks. I Data possono essere inviati in modo continuo. I Tracks definiscono semplicemente intervalli di date entro cui 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ù tracks.

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


Creare una boat è il primo passo necessario per importare dati e associare tracks.


📝 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: il track che verrà visualizzato nel tracciamento in tempo reale. Deve essere creato prima un track dedicato tramite il menu Track, poi selezionato qui. Per essere idoneo a 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 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 subject 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 tags sono alias della 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 > Mails & Tags > Edit Tag > Create Password).

Test Track: quando crei una boat per la prima volta, vengono generati automaticamente un test track e un set di data di esempio. Questo ti permette di familiarizzare rapidamente con i parametri della boat e la visualizzazione del track. Questo test track 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 l’accesso a uno specifico gruppo di persone. Eliminare un tag rimuoverà l’accesso per quel gruppo, ma chiunque utilizzi un tag diverso continuerà ad avere accesso.

In genere, si crea un tag separato per ogni sistema che alimenta di data la boat. Boat > Mails & Tag > Add Tag Se l’accesso a un sistema diventa compromesso o non disponibile, elimina semplicemente il tag associato.

Per inviare data tramite dispositivi companion o usare il server SFTP, devi creare un tag con una 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 tags che vuoi per una determinata boat.
  • I tags 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 tags 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 tags 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 data per questa Boat.


Che cos’è DATA?


I Data sono una raccolta di punti GPS e informazioni sensore opzionali (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
  • Traffico in un file NMEA 0183, registrato usando app come OpenCPN o QtVlm o una companion app.
  • Un normale file TEXT contenente informazioni di posizione GPS, come quelli inviati via email con dispositivi come Iridium Go:

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

Oppure una riga con questo pattern:

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

NB: latitudine e longitudine sono in gradi decimali. Data, ora e timezone possono essere combinati in un unico formato ISO: 2025-11-10T14:26:05Z. Sono consentite più righe nel messaggio di testo o nel file allegato.

Esempio di formato text accettabile:

-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


Come inviare DATA:


Puoi inviare Data in modi diversi e in momenti diversi. Con una connessione internet in mare, puoi inviare data in tempo reale. Altrimenti, salva 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 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 un’app di navigazione o da un dispositivo GNSS.


📡 Tramite SFTP:

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

Credenziali & indirizzo del server vengono 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 file: 50 MB per upload. Il mancato rispetto di queste raccomandazioni può comportare limitazioni dell’accesso all’upload o persino un ban permanente da Trakkit.org. Nota che 50 MB di data 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.

➡️ In caso di upload manuale, è 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 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 mail devono essere inviate a spool@trakkit.org

Devi includere un Tag nell’oggetto della tua email (BOATS > Mails & Tags), oppure collegare il tuo indirizzo email alla boat su Trakkit.org prima dell’invio via mail. Questo consente a Trakkit.org di associare i data alla Boat corretta.

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, i DATA verranno assegnati alla boat associata a quel Tag.
  • In caso di informazioni in conflitto, il Tag ha priorità sull’email.
  • Puoi inviare i data come allegato oppure scriverli nel corpo del messaggio

Nota: l’email non è il metodo consigliato, poiché la maggior parte dei provider limita rigidamente la dimensione dei messaggi e degli allegati e potrebbe rifiutarli senza preavviso. Questo metodo va 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.


---

🗺️ TRACKS:

A differenza di altri sistemi di navigazione, un Track in Trakkit è semplicemente una porzione temporale 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, in caso affermativo, li mostrerà.

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 associare il track.
  • TrackName: nome visualizzato del track.
  • 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 l’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, 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 traccia (precisione del Track). Attenzione: impostare una precisione troppo alta può rallentare drasticamente il rendering, il caricamento e la visualizzazione del track. Usa il buon senso e regola la precisione in base al tipo di navigazione: “60 per la navigazione costiera, 300 per la navigazione d’altura e 600 per lunghe traversate” sono buone linee guida. Per il tracciamento in tempo reale (LiveTrack), questo non dovrebbe mai essere impostato sotto i 300 secondi. Una volta terminati track e navigazione, puoi rigenerare il track finale con maggiore precisione se necessario.
  • Published: seleziona questa opzione se vuoi elencare il track nella "TRACK LIST" visibile sulla pagina della tua boat su https://.trakkit.org
  • Promemoria: eliminare un Track non elimina i Data.

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

Visualizzare un Track

  • Link diretto: https://trakkit.org/ttr/<TRACK-ID>
  • Dalla home page con TRACK-ID
  • I tracks vengono renderizzati in modo statico e vengono aggiornati automaticamente solo quando vengono importati nuovi data
  • Può essere rigenerato manualmente (TRACK > Regen)

Puoi integrare un link responsive nella tua pagina o sito web usando la URL diretta fornita nella sezione 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, la URL visualizzata 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.

Visualizzare il tracciamento in tempo reale

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

Puoi vedere direttamente la posizione della tua boat su:
https://boatname.trakkit.org

Dove 'boatname' è il nome assegnato 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 live tracking mostra informazioni di navigazione e pulsanti che danno accesso alla Live Weather Map, alla Track List (per i tracks contrassegnati come Public) e alla vista Full Screen. Nota che i data meteo live sono forniti da un servizio terzo, possono non essere disponibili per cause fuori dal nostro controllo e non ne è garantita l’accuratezza.

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

Puoi incorporare la vista live tracking (o qualsiasi altro track) direttamente in un iframe sul 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>



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 tipo 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 di sincronizzazione. Gli aggiornamenti della posizione vengono effettuati 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 per "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 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.