EN DE ES FR IT NL

❓ 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 le tracce di navigazione di una barca.

Trakkit raccoglie dati personali?

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

Trakkit è gratuito?

Sì. Creare un account e gestire Boat, Data e Track è gratuito.

🚀 Per iniziare

Come inizio a usare Trakkit?

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

Cosa succede ai dati di esempio?

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

Che cos’è un link TTR?

Ogni track riceve un ID univoco chiamato TTR ID (o TRACK ID).
Puoi condividere la tua track 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 una track, 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 le tue track.
Devi creare una Boat prima di inviare i dati.

Cosa succede quando creo una Boat?

  • Viene generata automaticamente una track di test
  • Vengono associati dei dati di esempio
  • Puoi testare subito la visualizzazione

Che cos’è la Direct URL?

La Direct URL fornisce accesso pubblico a:

  • La posizione corrente della barca
  • La sua live track (se abilitata)

Esempio:

https://boatname.trakkit.org

Che cos’è Active LiveTrack?

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

  • Crea una track
  • Imposta la data di fine nel futuro (es. 01/01/2050)
  • Selezionala in Boat > Edit > Active LiveTrack

📈 Data

Che cos’è Data?

Data è un insieme 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 data manualmente?

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

Posso inviare data automaticamente?

Sì. Puoi inviare data tramite:

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

Posso combinare diverse sorgenti di data?

Sì. Data può provenire da più sorgenti in momenti diversi:

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

Eliminare una Track elimina Data?

No.
Eliminare una track non elimina i data.

Per eliminare data, usa:

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

✉️ Data via email

Come invio data 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 priorità: Tag o email del mittente?

Il Tag ha priorità rispetto all’indirizzo email del mittente.

Quale formato devono seguire i data di posizione?

Un punto per riga:

Latitude Longitude YYYY-MM-DD HH:MM[:SS] [Timezone] [Optional fields]

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 data via SFTP

  • Richiedi una password del tag in: Boat > Mails & Tags > Password
  • Salva subito la password. Non può essere recuperata dopo essere stata visualizzata (se necessario puoi richiederne una nuova).
  • 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 data
  • 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’è una Track?

Una Track è semplicemente una porzione temporale dei data.

Definisce:

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

Non memorizza data in sé.

Più track possono usare gli stessi data?

Sì.
Le track sono solo viste dei data esistenti.

Cosa succede se creo una track prima di caricare data?

Non verrà mostrato nulla finché non verranno caricati data corrispondenti.
La track si aggiornerà automaticamente quando arrivano i data.

Che cosa sono WPP e WPO?

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

Valori WPP consigliati:

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

Come rigenero una track?

Vai su:

TRACK > Regen

Come posso rendere pubblica una track?

Seleziona l’opzione Published quando modifichi la track.

🗺️ Visualizzazione delle track

Come visualizzo una 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 una track con una data di fine nel futuro
  3. Selezionala come Active LiveTrack

Come incorporo il live tracking nel mio sito?

Esempio HTML:

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

💻 App companion

Che cos’è una Companion App?

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

  • Raccoglie data 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 e visibilità

I data sono automaticamente visibili?

No.
I data diventano visibili solo quando una Track definisce un intervallo temporale che li copre.

Dovrei nascondere i timestamp di partenza e arrivo?

Sì.
È fortemente consigliato impostare gli orari di inizio e fine della 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 data sono continui.
Le track sono viste.
I tag controllano l’accesso.
Il live tracking è opzionale.

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