❓ 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?
- Crea un account gratuito
- Crea una barca (è richiesto solo il nome della barca)
- Vengono creati automaticamente un dataset di esempio e un tracciato di test
- Visita: https://
.trakkit.org - Carica il tuo file .gpx tramite DATA > Upload
- 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?
- Imposta una Direct URL
- Crea un track con una data di fine futura
- 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.