❓ Trakkit.org – FAQ

⚠️ Cette FAQ est une traduction automatique générée à partir de la documentation officielle Trakkit.
Elle est fournie uniquement à titre informatif.

🌍 Questions générales

Qu’est-ce que Trakkit.org ?

Trakkit.org est une interface web pour un moteur de rendu de traces dédié à la voile de loisir et hauturière.
Il vous permet de créer, visualiser et partager des traces de navigation de bateau.


Trakkit collecte-t-il des données personnelles ?

⚠️ Non. Trakkit.org ne collecte aucune donnée personnelle.
Vous êtes entièrement responsable de ce que vous choisissez de publier en ligne.


Trakkit est-il gratuit ?

Oui. La création d’un compte et la gestion des bateaux, Data et tracks sont gratuites.


🚀 Bien démarrer

Comment commencer à utiliser Trakkit ?

  1. Créez un compte gratuit
  2. Créez un Boat (seul le nom du bateau est requis)
  3. Un jeu de Data d’exemple et un track de test sont créés automatiquement
  4. Visitez : https://.trakkit.org
  5. Téléversez votre propre fichier .gpx via DATA > Upload
  6. Créez un track via TRACK > Add Track

Que devient la Data d’exemple ?

Le jeu de Data d’exemple et le track de test sont supprimés automatiquement lorsque vous téléversez votre première Data réelle.


Qu’est-ce qu’un lien TTR ?

Chaque track reçoit un identifiant unique appelé TTR ID (ou TRACK ID).
Vous pouvez partager votre track avec :

https://trakkit.org/ttr/

Remarque :
Selon le moteur de rendu, Trakkit peut ajuster dynamiquement l’URL affichée dans votre navigateur.

Pour accéder de manière fiable à un track, utilisez toujours le format canonique :

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


🛥️ Boats

Qu’est-ce qu’un Boat dans Trakkit ?

Un Boat est le conteneur principal pour vos données de navigation et vos tracks.
Vous devez créer un Boat avant d’envoyer des données.


Que se passe-t-il lorsque je crée un Boat ?

  • Un track de test est généré automatiquement
  • Une Data d’exemple y est associée
  • Vous pouvez tester immédiatement la visualisation

Qu’est-ce que la Direct URL ?

La Direct URL fournit un accès public à :

  • La position actuelle du bateau
  • Sa trace en direct (si activée)

Exemple :

https://boatname.trakkit.org


Qu’est-ce que Active LiveTrack ?

Active LiveTrack permet l’affichage en temps réel du déplacement de votre bateau.
Pour l’activer :

  • Créez un track
  • Définissez sa date de fin dans le futur (p. ex. 01/01/2050)
  • Sélectionnez-le dans Boat > Edit > Active LiveTrack

📈 Data

Qu’est-ce que Data ?

Data est un ensemble de points GPS et d’informations de navigation optionnelles (AWA, AWS, COG, SOG, etc.).


Quels formats de fichiers sont pris en charge ?

  • .gpx
  • .nmea
  • .txt
  • Positions en texte via email
  • Formats compressés : .zip, .gzip, .z, .xz, .7z, .tar, .tgz

Puis-je téléverser des données manuellement ?

Oui.
Allez dans DATA > Upload et téléversez vos fichiers .gpx, .nmea ou .txt.


Puis-je envoyer des données automatiquement ?

Oui. Vous pouvez envoyer des données via :

  • Email à spool@trakkit.org
  • SFTP (recommandé pour l’automatisation)
  • Applications companion
  • Systèmes satellites (p. ex. Iridium Go)

Puis-je combiner différentes sources de données ?

Oui. La Data peut provenir de plusieurs sources à des moments différents :

  • Emails satellite en temps réel en mer
  • Téléversement GPX complet au port
  • Journaux NMEA issus d’un logiciel de navigation

La suppression d’un Track supprime-t-elle la Data ?

Non.
Supprimer un track ne supprime pas la Data.

Pour supprimer la Data, utilisez :

  • DATA > Delete
  • Suppression par plage de dates ou BatchID

✉️ Data par email

Comment envoyer des données par email ?

Envoyez-les à :

spool@trakkit.org

Vous devez soit :

  • Inclure un Tag dans l’objet de l’email

OU

  • Lier votre adresse email à votre Boat

Quelle est la priorité : Tag ou email de l’expéditeur ?

Le Tag est prioritaire sur l’adresse email de l’expéditeur.


Quel format doivent suivre les données de position ?

Un point par ligne :

Latitude Longitude YYYY-MM-DD HH:MM[:SS] [Fuseau horaire] [Champs optionnels]

Exemple :

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

Si aucun fuseau horaire n’est précisé, UTC est utilisé par défaut.


📡 Téléversement SFTP

Pourquoi utiliser SFTP ?

SFTP est la méthode recommandée pour les transferts automatisés.


Quelles sont les restrictions ?

  • Fréquence maximale : 1 fichier toutes les 3 minutes
  • Taille maximale de fichier : 20 MB

Comment envoyer des données via SFTP

  • Demandez un mot de passe de tag dans : Boat > Mails & Tags > Password
  • Enregistrez le mot de passe immédiatement. Il ne peut pas être récupéré une fois affiché (vous pouvez en demander un nouveau si nécessaire).
  • L’adresse du serveur SFTP et le port sont affichés avec le mot de passe.
  • Vous pouvez téléverser des fichiers manuellement avec un client SFTP comme FileZilla, ou utiliser les scripts d’automatisation fournis par JoliCompanion.

Comment nommer les fichiers ?

TAG_YYYYMMDD_HHMMSS.data

Téléversez d’abord sous :

TAG_YYYYMMDD_HHMMSS.part

Puis renommez en .data une fois le téléversement complètement terminé.


🏷️ Tags

Qu’est-ce qu’un Tag ?

Un Tag est un alias pour un Boat.
Il permet :

  • L’affectation de Data
  • Le contrôle d’accès
  • L’authentification SFTP

Puis-je créer plusieurs Tags ?

Oui. Vous pouvez créer autant de tags que vous le souhaitez pour un Boat.


Un Tag peut-il être lié à plusieurs bateaux ?

Non. Un tag ne peut appartenir qu’à un seul Boat.


Que se passe-t-il si je supprime un Tag ?

L’accès via ce tag est immédiatement révoqué.
Les autres tags restent valides.


Les Tags peuvent-ils être utilisés pour SFTP ?

Oui.

  • Tag = nom d’utilisateur
  • Mot de passe requis

Les mots de passe ne peuvent pas être récupérés.


🗺️ Tracks

Qu’est-ce qu’un Track ?

Un Track est simplement une tranche temporelle de Data.

Il définit :

  • Une date/heure de début
  • Une date/heure de fin
  • Un nom

Il ne stocke pas la Data elle-même.


Plusieurs tracks peuvent-ils utiliser la même Data ?

Oui.
Les tracks ne sont que des vues de Data existante.


Que se passe-t-il si je crée un track avant de téléverser de la Data ?

Rien ne s’affichera tant qu’aucune Data correspondante n’aura été téléversée.
Le track se mettra à jour automatiquement à l’arrivée des données.


Qu’est-ce que WPP et WPO ?

  • WPP (Track precision) : intervalle en secondes entre les points de track affichés
  • WPO (Progress points) : intervalle en minutes entre les marqueurs de progression orange

Valeurs WPP recommandées :

  • 10 secondes → Régates
  • 60 secondes → Navigation côtière
  • 300 secondes → Navigation hauturière

Comment régénérer un track ?

Allez dans :

TRACK > Regen


Comment rendre un track public ?

Cochez l’option Published lors de l’édition du track.


🗺️ Visualiser les tracks

Comment visualiser un track ?

Lien direct :

https://trakkit.org/ttr/

Ou saisissez le Track ID sur la page d’accueil.


📡 Suivi en direct

Comment activer le suivi en direct ?

  1. Définissez une Direct URL
  2. Créez un track avec une date de fin future
  3. Sélectionnez-le comme Active LiveTrack

Comment intégrer le suivi en direct sur mon site web ?

Exemple HTML :

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

💻 Applications Companion

Qu’est-ce qu’une application Companion ?

Une application companion est une application tierce qui :

  • Collecte des données de navigation
  • Les envoie automatiquement à Trakkit

Existe-t-il une implémentation de référence pour une application Companion ?

Oui.
Le code de base Python de JoliCompanion est disponible sur Trakkit.org et GitHub. Il peut être adapté à votre configuration.


🔐 Data & visibilité

La Data est-elle automatiquement visible ?

Non.
La Data devient visible uniquement lorsqu’un Track définit un intervalle de temps qui la couvre.


Dois-je masquer les horodatages de départ et d’arrivée ?

Oui.
Il est fortement recommandé de définir les heures de début et de fin du track afin que vos points exacts de départ et d’arrivée ne soient pas visibles en permanence.


🧭 Résumé

Trakkit est construit autour de trois objets principaux :

  • Boat
  • Data
  • Track

La Data est continue.
Les tracks sont des vues.
Les tags contrôlent l’accès.
Le suivi en direct est optionnel.

Simple, flexible, et conçu pour une vraie navigation hauturière.