❓ Trakkit.org – FAQ

⚠️ Questa FAQ è una traduzione automatica generata dalla documentazione ufficiale di Trakkit.
È fornita solo a scopo informativo.

🌍 Domande generali

Che cos’è Trakkit.org?

Trakkit.org è un front-end web per un motore di rendering dei tracciati dedicato alla vela da diporto e d’altura.
Ti consente di creare, visualizzare e condividere i tracciati di navigazione della barca.


Trakkit raccoglie dati personali?

⚠️ No. Trakkit.org non raccoglie alcun dato personale.
Sei pienamente responsabile di ciò che scegli di pubblicare online.


Trakkit è gratuito?

Sì. Creare un account e gestire barche, dati e tracciati è gratuito.


🚀 Per iniziare

Come inizio a usare Trakkit?

  1. Crea un account gratuito
  2. Crea una barca (è richiesto solo il nome della barca)
  3. Vengono creati automaticamente un dataset di esempio e un tracciato di test
  4. Visita: https://.trakkit.org
  5. Carica il tuo file .gpx tramite DATA > Upload
  6. Crea un tracciato tramite TRACK > Add Track

Che cosa succede ai dati di esempio?

Il dataset di esempio e il tracciato di test vengono eliminati automaticamente quando carichi i tuoi primi dati reali.


Che cos’è un link TTR?

A ogni tracciato viene assegnato un ID univoco chiamato TTR ID (o TRACK ID).
Puoi condividere il tuo tracciato usando:

https://trakkit.org/ttr/

Nota:
A seconda del motore di rendering, Trakkit può adattare dinamicamente l’URL visualizzato nel browser.

Per accedere in modo affidabile a un tracciato, usa sempre il formato canonico:

https://trakkit.org/ttr/<TRACK-ID>


🛥️ Boat

Che cos’è una Boat in Trakkit?

Una Boat è il contenitore principale per i tuoi dati di navigazione e i tuoi tracciati.
Devi creare una boat prima di inviare i dati.


Che cosa succede quando creo una boat?

  • Viene generato automaticamente un tracciato di test
  • I dati di esempio vengono associati ad essa
  • Puoi testare subito la visualizzazione

Che cos’è la Direct URL?

La Direct URL fornisce accesso pubblico a:

  • La posizione attuale della boat
  • Il suo tracciato live (se abilitato)

Esempio:

https://boatname.trakkit.org


Che cos’è Active LiveTrack?

Active LiveTrack consente la visualizzazione in tempo reale del movimento della tua boat.
Per abilitarlo:

  • Crea un tracciato
  • Imposta la data di fine nel futuro (es. 01/01/2050)
  • Selezionalo in Boat > Edit > Active LiveTrack

📈 Data

Che cos’è Data?

Data è una raccolta di punti GPS e informazioni di navigazione opzionali (AWA, AWS, COG, SOG, ecc.).


Quali formati di file sono supportati?

  • .gpx
  • .nmea
  • .txt
  • Posizioni testuali via email
  • Formati compressi: .zip, .gzip, .z, .xz, .7z, .tar, .tgz

Posso caricare i dati manualmente?

Sì.
Vai su DATA > Upload e carica i tuoi file .gpx, .nmea o .txt.


Posso inviare i dati automaticamente?

Sì. Puoi inviare i dati tramite:

  • Email a spool@trakkit.org
  • SFTP (consigliato per l’automazione)
  • App companion
  • Sistemi satellitari (es. Iridium Go)

Posso combinare diverse fonti di dati?

Sì. I dati possono provenire da più fonti in momenti diversi:

  • Email satellitari in tempo reale in mare
  • Caricamento GPX completo in porto
  • Log NMEA da software di navigazione

Eliminare un Track elimina i Data?

No.
Eliminare un tracciato non elimina i dati.

Per eliminare i dati, usa:

  • DATA > Delete
  • Elimina per intervallo di date o BatchID

✉️ Data via email

Come invio i dati via email?

Inviali a:

spool@trakkit.org

Devi:

  • Includere un Tag nell’oggetto dell’email

OPPURE

  • Collegare il tuo indirizzo email alla tua boat

Cosa ha la priorità: Tag o email del mittente?

Il Tag ha la priorità sull’indirizzo email del mittente.


Quale formato devono seguire i dati di posizione?

Un punto per riga:

Latitudine Longitudine YYYY-MM-DD HH:MM[:SS] [Fuso orario] [Campi opzionali]

Esempio:

41.7267 -49.9469 2024-04-15 02:40:00 UTC AWA:120 AWS:24.5 COG:145 SOG:10.5

Se non è specificato alcun fuso orario, si assume UTC.


📡 Upload SFTP

Perché usare SFTP?

SFTP è il metodo consigliato per i trasferimenti automatizzati.


Quali sono le limitazioni?

  • Frequenza massima: 1 file ogni 3 minuti
  • Dimensione massima del file: 20 MB

Come inviare i dati via SFTP

  • Richiedi una password del tag in: Boat > Mails & Tags > Password
  • Salva subito la password. Non può essere recuperata dopo la visualizzazione (puoi richiederne una nuova se necessario).
  • L’indirizzo e la porta del server SFTP vengono mostrati insieme alla password.
  • Puoi caricare i file manualmente usando un client SFTP come FileZilla, oppure usare gli script di automazione forniti da JoliCompanion.

Come devono essere nominati i file?

TAG_YYYYMMDD_HHMMSS.data

Carica prima come:

TAG_YYYYMMDD_HHMMSS.part

Poi rinomina in .data una volta completato l’upload.


🏷️ Tag

Che cos’è un Tag?

Un Tag è un alias per una boat.
Consente:

  • Assegnazione dei dati
  • Controllo degli accessi
  • Autenticazione SFTP

Posso creare più Tag?

Sì. Puoi creare tutti i tag che vuoi per una boat.


Un Tag può essere collegato a più boat?

No. Un tag può appartenere solo a una boat.


Cosa succede se elimino un Tag?

L’accesso tramite quel tag viene revocato immediatamente.
Gli altri tag restano validi.


I Tag possono essere usati per SFTP?

Sì.

  • Tag = nome utente
  • Password richiesta

Le password non possono essere recuperate.


🗺️ Track

Che cos’è un Track?

Un Track è semplicemente una porzione temporale dei dati.

Definisce:

  • Una data/ora di inizio
  • Una data/ora di fine
  • Un nome

Non memorizza i dati in sé.


Più track possono usare gli stessi dati?

Sì.
I track sono solo viste dei dati esistenti.


Cosa succede se creo un track prima di caricare i dati?

Non verrà mostrato nulla finché non vengono caricati dati corrispondenti.
Il track si aggiornerà automaticamente quando arrivano i dati.


Che cosa sono WPP e WPO?

  • WPP (Track precision): intervallo in secondi tra i punti del track visualizzati
  • WPO (Progress points): intervallo in minuti tra i marcatori di avanzamento arancioni

Valori WPP consigliati:

  • 10 secondi → Regate
  • 60 secondi → Navigazione costiera
  • 300 secondi → Navigazione d’altura

Come rigenero un track?

Vai su:

TRACK > Regen


Come posso rendere pubblico un track?

Seleziona l’opzione Published quando modifichi il track.


🗺️ Visualizzare i track

Come visualizzo un track?

Link diretto:

https://trakkit.org/ttr/

Oppure inserisci il Track ID nella homepage.


📡 Live Tracking

Come abilito il live tracking?

  1. Imposta una Direct URL
  2. Crea un track con una data di fine futura
  3. Selezionalo come Active LiveTrack

Come incorporo il live tracking sul mio sito web?

Esempio HTML:

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

💻 App companion

Che cos’è una Companion App?

Una companion app è un’applicazione di terze parti che:

  • Raccoglie i dati di navigazione
  • Li invia automaticamente a Trakkit

Esiste un’implementazione di riferimento per una Companion App?

Sì.
Il codice base Python di JoliCompanion è disponibile su Trakkit.org e GitHub. Può essere adattato alla tua configurazione.


🔐 Data & visibilità

I dati sono automaticamente visibili?

No.
I dati diventano visibili solo quando un Track definisce un intervallo temporale che li include.


Dovrei nascondere i timestamp di partenza e arrivo?

Sì.
È fortemente consigliato impostare gli orari di inizio e fine del track in modo che i tuoi punti esatti di partenza e arrivo non siano permanentemente visibili.


🧭 Riepilogo

Trakkit è costruito attorno a tre oggetti principali:

  • Boat
  • Data
  • Track

I dati sono continui.
I track sono viste.
I tag controllano l’accesso.
Il live tracking è opzionale.

Semplice, flessibile e progettato per la vera vela d’altura.