❓ Trakkit.org – FAQ

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

🌍 Questions générales

Qu’est-ce que Trakkit.org ?

Trakkit.org est une interface web (front-end) pour un moteur de rendu de Track dédié à la voile de loisir et à la navigation hauturière.
Elle vous permet de créer, visualiser et partager des tracks de navigation de Boat.


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 Boat, Data et Track sont gratuites.


🚀 Bien démarrer

Comment commencer à utiliser Trakkit ?

  1. Créez un compte gratuit
  2. Créez un Boat (seul le nom du Boat est requis)
  3. Un jeu de données 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 les données d’exemple ?

Le jeu de données d’exemple et le Track de test sont supprimés automatiquement lorsque vous téléversez vos premières vraies données.


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 via :

https://trakkit.org/ttr/

Note :
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 de vos Data de navigation et de vos Track.
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
  • Des données d’exemple y sont associées
  • Vous pouvez immédiatement tester la visualisation

Qu’est-ce que l’URL directe ?

L’URL directe fournit un accès public à :

  • La position actuelle du Boat
  • Son live track (si activé)

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 Boat.
Pour l’activer :

  • Créez un Track
  • Définissez sa date de fin dans le futur (par 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 dans les emails
  • 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 vers spool@trakkit.org
  • SFTP (recommandé pour l’automatisation)
  • Applications companion
  • Systèmes satellites (par ex. Iridium Go)

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

Oui. Les Data peuvent provenir de plusieurs sources à différents moments :

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

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

Non.
La suppression d’un Track ne supprime pas les données.

Pour supprimer des données, utilisez :

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

✉️ Email Data

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

Lequel est prioritaire : Tag ou email de l’expéditeur ?

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


Quel format les données de position doivent-elles suivre ?

Un point par ligne :

Latitude Longitude YYYY-MM-DD HH:MM[:SS] [Timezone] [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 spécifié, UTC est supposé.


📡 SFTP Upload

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 Data 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 et le port du serveur SFTP sont affichés en même temps que le mot de passe.
  • Vous pouvez téléverser des fichiers manuellement en utilisant un client SFTP tel que 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 entièrement terminé.


🏷️ Tags

Qu’est-ce qu’un Tag ?

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

  • L’affectation des 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 boats ?

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 révoqué immédiatement.
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 lui-même les données.


Plusieurs tracks peuvent-ils utiliser les mêmes données ?

Oui.
Les tracks ne sont que des vues sur des données existantes.


Que se passe-t-il si je crée un track avant de téléverser des données ?

Rien ne sera affiché tant que des données correspondantes ne seront pas téléversées.
Le track se mettra à jour automatiquement à l’arrivée des données.


Que sont 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.


📡 Live Tracking

Comment activer le live tracking ?

  1. Définissez une URL directe
  2. Créez un Track avec une date de fin dans le futur
  3. Sélectionnez-le comme Active LiveTrack

Comment intégrer le live tracking 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 Data 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é

Les données sont-elles visibles automatiquement ?

Non.
Les Data deviennent visibles uniquement lorsqu’un Track définit un intervalle de temps qui les 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 de manière permanente.


🧭 Résumé

Trakkit est construit autour de trois objets principaux :

  • Boat
  • Data
  • Track

Les Data sont continues.
Les tracks sont des vues.
Les tags contrôlent l’accès.
Le live tracking est optionnel.

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