EN FR

Bienvenue sur Trakkit.org

Trakkit.org est l’interface front-end d’un moteur de rendu de tracks destiné à la navigation de plaisance et à la navigation hauturière.

Il permet de :

  • Créer, visualiser et partager des tracks de navigation
  • Les intégrer dans des applications ou des sites web
  • Partager des tracks via un simple lien Internet
  • Activer le suivi en temps réel grâce à l’envoi automatique de données NMEA, GPX, TEXT par email ou SFTP

Trakkit.org ne collecte aucune donnée personnelle.

🚀 Démarrage rapide

  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 automatiquement créés
  4. Testez le track d’exemple en visitant : https://<boatname>.trakkit.org
  5. Importez vos propres données via un fichier .GPX : DATA > Upload
  6. Créez un track : TRACK > Add Track afin de choisir quelle partie des données afficher
  7. Un identifiant TTR est attribué, et le track peut être partagé à l’adresse : https://trakkit.org/ttr/<TRACK-ID-TTR>

NB : Le jeu de données d’exemple est automatiquement supprimé dès que vous commencez à importer vos propres données.

📚 Documentation générale

Tout dans Trakkit.org repose sur trois objets :

  • Boat
  • Data
  • Track

Les Data sont associées à un boat.
Un track correspond à un segment de données compris entre deux dates.

🔧 Comment ça fonctionne ?

Il est essentiel de comprendre que dans Trakkit, les Data ne sont pas liées aux tracks. Les Data peuvent être envoyées en continu. Les tracks définissent simplement des plages de dates pendant lesquelles les Data correspondantes sont visibles. Supprimer un track n’affecte pas les Data. Les Data ne sont visibles que si un track est défini pour les rendre visibles. Les mêmes Data peuvent apparaître dans plusieurs tracks.

  1. Envoyez vos positions GPS à spool@trakkit.org (par exemple via Iridium Go)
  2. Définissez un track avec une date de début et une date de fin
  3. Partagez le lien : https://trakkit.org/ttr/<YOUR_TTR> (remplacez <YOUR_TTR> par l’identifiant de votre track, disponible dans la liste de vos tracks)
  4. Optionnellement, importez un fichier complet GPX ou NMEA après votre navigation

Note : Trakkit a été initialement conçu pour Iridium Go, mais tout appareil capable d’envoyer des emails GPS est pris en charge.

Structure de base

  • 1 user peut posséder plusieurs boats
  • 1 boat appartient à un seul user
  • 1 boat peut avoir autant de tracks que nécessaire
  • Plusieurs tracks peuvent utiliser les mêmes Data

🛥️ Boat

La création d’un boat est la première étape nécessaire pour importer des Data et associer des tracks.

⚙️ Track et Data d’exemple

Lors de la création d’un boat pour la première fois :

  • Un track de test est automatiquement généré
  • Un jeu de Data d’exemple est associé à ce track

Cela permet de vérifier rapidement les paramètres du boat et le rendu visuel.

Note : Ce track de test et ses Data seront automatiquement supprimés lors du premier import de Data réelles.

📝 Champs disponibles

  • Name (obligatoire) : identifie le boat
  • Maxspeed : utilisé pour détecter d’éventuelles anomalies GPS (ex. vitesses irréalistes)
  • Info : champ optionnel purement informatif
  • Active livetrack : active le suivi en temps réel avec affichage de l’historique
    Un track dédié doit être créé au préalable via le menu Track, puis sélectionné ici.
    Pour être éligible au LiveTrack, le track doit avoir une date de fin dans le futur (ex. 01/01/2050).
  • Direct URL : adresse web publique donnant accès à la position actuelle du boat et à son livetrack s’il est défini
  • Email : adresse depuis laquelle les emails de tracking seront envoyés. Elle peut être surchargée si un TAG valide est présent dans l’objet de l’email
  • Noforeignland Email : si vous avez un compte NoForeignLand, enregistrez ici l’adresse utilisée pour l’envoi des positions
  • Tags : les tags sont des alias du boat. Ils peuvent être utilisés pour envoyer des Data, accéder au serveur SFTP ou créer votre propre système d’envoi de Data.
    Pour envoyer des Data via le serveur SFTP, créez un mot de passe de tag :
    Boat > Tags & Mails > Edit Tag > Create Password

📈 Data

Une fois un boat créé, vous pouvez alimenter Trakkit.org avec des Data pour ce boat.

Les Data sont un ensemble de points GPS et d’informations capteurs optionnelles (AWA, AWS, etc.) associées à un boat.

Comment envoyer des Data

L’une des méthodes les plus simples consiste à aller dans DATA > UPLOAD et à importer vos tracks .GPX exportés depuis une tablette ou un traceur GPS.

Pour tout envoi automatique de Data via une application compagnon, email ou SFTP, vous devez d’abord créer un Tag ou associer une adresse email à ce boat dans BOAT > Mails & Tag.

Vous pouvez envoyer des Data de différentes manières à différents moments, en temps réel ou différé.

Les Data peuvent :

  • Provenir de différentes sources
  • Être importées manuellement via DATA > UPLOAD
  • Être envoyées automatiquement par email, application compagnon ou SFTP
  • Être associées à plusieurs emails ou Tags pour un même boat
  • Être visibles uniquement via des tracks
  • Ne jamais être supprimées lors de la suppression d’un track

✉️ Envoi des Data par email

Les emails doivent être envoyés à spool@trakkit.org

Vous devez soit inclure un TAG dans l’objet de l’email, soit associer votre adresse email au boat sur Trakkit.org.

Les fichiers peuvent être joints ou inclus en texte brut.
Les archives compressées sont acceptées : ZIP, GZIP, TAR, 7z.

📡 Serveur SFTP pour l’envoi de Data

Trakkit met à disposition un serveur SFTP, recommandé pour les transferts automatisés et les fichiers volumineux.

Les identifiants et l’adresse du serveur sont fournis lors de la création d’un mot de passe de tag :
Boat > Mails & Tags > Create Tag Password

Formats acceptés

  • Fichiers Data : .gpx, .nmea, .txt
  • Archives : .tar, .zip, .z, .xz, .7z, .gz

Règles d’utilisation

  • Fréquence maximale : 1 fichier toutes les 3 minutes
  • Taille maximale : 30 Mo par fichier

Les fichiers doivent être nommés :

TAG_YYYYMMDD_HHMMSS.data

Il est recommandé d’envoyer d’abord le fichier avec l’extension .part, puis de le renommer en .data une fois le transfert terminé.

🏷️ Tags

Les Tags sont des alias permettant d’identifier un boat et de contrôler l’accès.

  • Un boat peut avoir autant de tags que nécessaire
  • Un tag peut être supprimé à tout moment
  • Les tags peuvent être partagés pour donner accès à un groupe
  • Les tags peuvent être utilisés pour envoyer des Data par email depuis n’importe quelle adresse
  • Les tags avec mot de passe servent d’identifiant pour l’accès SFTP

🗺️ TRACKS

Un Track dans Trakkit est une tranche temporelle nommée au sein d’un ensemble de Data.

Vous définissez une date de début, une date de fin et un nom.
Les Data correspondantes sont affichées si elles existent.

Supprimer un track ne supprime jamais les Data.

Visualisation d’un Track

  • Lien direct : https://trakkit.org/ttr/<TRACK-ID>
  • Intégration possible via iframe dans un site web
  • Les tracks sont rendus de manière statique et mis à jour lors de l’import de nouvelles Data

Visualisation du suivi en temps réel

L’URL directe du boat est accessible à :

https://boatname.trakkit.org

Si un track est activé pour le LiveTrack, celui-ci sera affiché automatiquement.

💻 Companion App: Joli_Compagnon

Une companion app est une application tierce chargée de collecter et d’envoyer des Data vers Trakkit.

Le code Python de référence de Joli_Compagnon, le companion app de Trakkit.org, est librement disponible sur GitHub ou Trakkit.org et peut être adapté à vos besoins.

Un tag avec mot de passe est requis pour l’envoi des Data.

C’est la solution recommandée pour le suivi en temps réel.