EN DE ES FR IT NL

Bienvenue sur Trakkit.org

Trakkit.org est l’interface front-end d’un moteur de rendu de traces pour la navigation de plaisance et la voile hauturière.

Il vous permet de :

  • Créer, visualiser et partager des traces de navigation.
  • Les intégrer dans des applications ou des sites web.
  • Partager des traces via un simple lien web ou directement depuis la page d’accueil du site.
  • Activer le suivi en temps réel grâce à des envois automatiques de données NMEA, GPX ou TEXT via email ou SFTP.
  • Mettre à jour automatiquement votre position sur NoForeignLand.

Trakkit.org ne collecte aucune donnée personnelle.

🚀 Démarrage rapide

Pour vous aider à démarrer et à vous familiariser rapidement, suivez ces étapes :

  1. Créez un compte (gratuit)
  2. Créez un Boat
  3. Un jeu de données d’exemple et un Track de test ont été créés automatiquement.
  4. Testez le Track d’exemple en visitant : https://<boatname>.trakkit.org
  5. Importez vos propres données en utilisant un fichier .GPX classique : DATA > Upload
  6. Créez une trace : TRACK > Add Track pour choisir quelle partie des données vous souhaitez afficher
  7. Un TTR ID est attribué, et la trace peut être partagée à 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 s’articule autour de trois objets :

  • Boat
  • Data
  • Track

Les Data sont liées à un Boat. Un Track est un segment de Data entre deux dates.

🔧 Comment ça fonctionne ?

Il est essentiel de comprendre que, dans Trakkit, les données ne sont pas liées aux traces. Les Data peuvent être envoyées en continu. Les Tracks ne font que définir des plages de dates au sein desquelles les données 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.

Structure de base :

  • 1 User peut avoir plusieurs Boats
  • 1 Boat n’appartient qu’à 1 seul utilisateur
  • 1 Boat peut avoir autant de Tracks que nécessaire
  • Plusieurs Tracks peuvent utiliser les mêmes Data
  • Supprimer un Track n’affecte pas les Data



🛥️ Boat


Créer un bateau est la première étape nécessaire pour importer des données et associer des traces.


📝 Champs disponibles


  • Name (requis) : Identifie le bateau.
  • Maxspeed : En nœuds. Utilisé pour détecter d’éventuelles anomalies de points GPS (p. ex. vitesses irréalistes).
  • Info : Un champ optionnel, purement informatif. Mettez ce que vous voulez.
  • Active LiveTrack : Le Track qui sera affiché en suivi en temps réel. 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 (p. ex. 1/1/2050). Si le champ est laissé vide, seule l’icône de dernière position connue sera affichée en suivi en temps réel.
  • Direct URL : Une adresse web publique donnant un accès direct à la position actuelle du bateau (et à son LiveTrack si défini). Il est généralement recommandé d’utiliser le nom du bateau. <boatname>.trakkit.org
  • Email : Adresse à partir de laquelle les emails de tracking seront envoyés. Ceci est surchargé si un TAG valide est inclus dans l’objet (subject) de l’email.
  • Noforeignland Email : Si vous avez un compte NoForeignLand, ajoutez cette adresse email comme expéditeur de tracking dans les paramètres de votre compte NFL, et votre position sur NFL sera automatiquement mise à jour depuis Trakkit.org.
  • Tags : Les Tags sont des alias pour votre Boat. Vous pouvez les utiliser pour envoyer des Data, accéder au serveur SFTP, ou créer votre propre expéditeur de données. Pour envoyer des Data via notre serveur SFTP, créez un mot de passe de Tag (Boat > Tags & Mails > Edit Tag > Create Password).

Test Track : Lors de la création d’un bateau pour la première fois, un Track de test et un jeu de Data d’exemple sont générés automatiquement. Cela vous permet de vous familiariser rapidement avec les paramètres du Boat et la visualisation des Tracks. Ce Track de test et ses Data seront automatiquement supprimés lors du premier import de données réelles.


🏷️ Tags


Les Tags sont des alias alternatifs utilisés pour identifier un Boat. L’objectif principal d’un Tag est d’accorder l’accès à un groupe de personnes spécifique. Supprimer un Tag supprimera l’accès pour ce groupe, mais toute personne utilisant un autre Tag conservera l’accès.

En général, vous créez un Tag distinct pour chaque système qui alimente le bateau en données. Boat > Mails & Tag > Add Tag Si l’accès à un système devient corrompu ou indisponible, supprimez simplement le Tag associé.

Champs disponibles :

  • INFO : Un champ purement informatif pour vous aider à vous souvenir de l’usage de ce Tag. Saisissez ce que vous voulez.
  • ALLOWED TO SEND MAIL : Cochez cette case si vous souhaitez utiliser le Tag pour envoyer des données par email.

Pour alimenter les données via des appareils compagnons ou utiliser le serveur SFTP, vous devez créer un Tag avec un mot de passe :
Boat > Mails & Tag > Edit > Create Password

⚠️ Veillez à bien mémoriser ce mot de passe, car il ne peut pas être récupéré. S’il est perdu, vous devrez en créer un nouveau.

  • Vous pouvez créer autant de tags que vous le souhaitez pour un Boat donné.
  • Les Tags peuvent être partagés avec des groupes ou des individus pour accorder l’accès.
  • Un tag peut être supprimé à tout moment sans impact sur les Boats, Tracks ou Data.
  • Les Tags peuvent être utilisés pour envoyer des données par email depuis n’importe quelle adresse email, en mettant simplement le tag dans l’objet. Dans ce cas, ne partagez le tag avec personne.
  • Les Tags avec mot de passe peuvent être utilisés pour accéder au serveur SFTP, le Tag servant de nom d’utilisateur.




🗺️📍 Data


Une fois un Boat créé, vous pouvez alimenter Trakkit.org avec des données pour ce Boat.


Qu’est-ce que DATA ?


Les Data sont un ensemble de points GPS et d’informations capteurs optionnelles (AWA, AWS, etc.) pour un bateau.

Les Data peuvent prendre plusieurs formes :

  • Un fichier GPX généré par un appareil GPS ou exporté depuis des apps comme Navionics Boating
  • Un fichier NMEA 0183 contenant du trafic directement émis par votre système de navigation (les messages GNSS de GPS, Galileo et GLONASS sont reconnus). Méthode recommandée lorsqu’elle est utilisée avec l’app companion pour le suivi en temps réel.
  • Un fichier TEXT CSV utilisant un point-virgule (;) comme séparateur, avec les noms de champs sur la première ligne tels qu’utilisés par les exports courants d’apps comme OpenCPN ou QtVlm

Champs obligatoires : - Date (format ISO 8601 — les valeurs sans fuseau horaire sont supposées être en UTC) - LAT - LON (en degrés décimaux)

Champs optionnels : Des champs additionnels peuvent être fournis : AWS, AWA, COG, SOG, TWA, TWS, MTW, MTA, HDG, TWD, CTW, MBP, STW, DEPTH, RPM, ELEV. Vitesses en nœuds, angles en degrés, profondeur en mètres, température en Celsius. Tout champ marqué (calc) sera ignoré, car Trakkit est conçu pour ingérer uniquement des données brutes directement produites par les systèmes de navigation embarqués. Les champs non reconnus sont ignorés.

Exemple de CSV DATA valide :

  Date;LAT;LON;SOG;COG;AWA;AWS;DEPTH;MTW
  2026-04-21T08:00:00Z;44.8500;-55.2167;5.2;145;32;14.5;120;12.4
  2026-04-21T08:05:00Z;44.8485;-55.2135;5.4;147;30;15.0;118;12.5
  2026-04-21T08:10:00Z;44.8470;-55.2103;5.6;149;29;15.6;115;12.5

Pour des raisons historiques et de compatibilité avec les anciens formats texte Iridium GO, les anciens formats TEXT de Trakkit restent supportés mais sont dépréciés, ne sont plus documentés et ne doivent pas être utilisés pour de nouveaux développements. Désormais, seul le format CSV doit être utilisé.


Comment envoyer des DATA :


Vous pouvez envoyer des Data de différentes manières et à différents moments. Avec une connexion internet en mer, vous pouvez envoyer des données en temps réel. Sinon, enregistrez simplement un fichier GPX, NMEA ou TEXT depuis votre GPS ou votre système de navigation et importez-le plus tard lorsque vous serez de nouveau en ligne. L’ordre, la date et l’heure de transmission des données n’ont pas d’importance ; seuls les horodatages contenus dans les données sont pertinents. Importer plusieurs fois les mêmes données n’affecte pas et ne corrompt pas vos Data. Voici les différentes façons d’envoyer vos données :

Quelle que soit la méthode d’import choisie, toutes les Data peuvent être compressées en : .zip .gzip .z .xz .7z .tar .tgz


📤 Par import direct de Data vers Trakkit.org :

L’une des méthodes les plus simples consiste à vous connecter à Trakkit.org, DATA>UPLOAD et à importer votre fichier GPX, NMEA ou TEXT exporté depuis une app de navigation ou un appareil GNSS.


📡 Par SFTP :

Vous pouvez envoyer vos fichiers vers le serveur SFTP de Trakkit, qui est la méthode recommandée pour les transferts automatisés et les fichiers volumineux.

Identifiants & adresse du serveur sont fournis lorsque vous demandez un mot de passe de Tag sur Trakkit.org : BOATS > Mails & Tags > Create Tag Password

Restrictions (politique d’usage raisonnable) : Fréquence maximale d’import : 1 connexion toutes les 3 minutes. Taille maximale de fichier : 50 MB par import. Le non-respect de ces recommandations peut entraîner des restrictions d’accès à l’import, voire un bannissement permanent de Trakkit.org. Notez que 50 MB de données compressées peuvent stocker plus de 24 heures de trafic NMEA complet.

Une fois connecté, importez simplement vos données dans le répertoire /upload.

Les fichiers importés doivent respecter ce format : TAG_YYYYMMDD_HHMMSS.data

Note : TAG doit correspondre à l’identifiant Tag utilisé pour la connexion.

➡️ En cas d’import manuel, il est fortement recommandé d’importer d’abord le fichier avec l’extension .part (p. ex. TAG_YYYYMMDD_HHMMSS.gz.part) puis de le renommer en .data une fois le transfert terminé. Cela garantit que le fichier ne sera pas traité avant la fin complète de l’import. Compressez vos fichiers pour économiser la bande passante (p. ex., .zip, .gzip, .z, gz, .xz, .7z, .tar, .tgz).

Vous pouvez utiliser le script Python sftp_send.py, disponible sur Trakkit.org dans About > Downloads, qui automatise les imports tout en respectant les paramètres recommandés.


✉️ Par Mail :

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

Vous devez soit inclure un Tag dans l’objet de votre email, soit lier votre adresse email à votre Boat sur Trakkit.org avant l’envoi par mail. Cela permet à Trakkit.org d’associer les données au bon Boat.

Si vous utilisez un Tag dans l’objet de votre email, vous devez d’abord autoriser ce Tag à envoyer du mail (BOATS > Mails & Tags > Edit > Allowed to send mail). Les emails reçus avec un Tag non autorisé seront ignorés, même si l’adresse email de l’expéditeur est déjà liée.

Règles d’affectation :

  • Si l’email de l’expéditeur est lié à un BOAT sur Trakkit.org, les DATA seront affectées à ce boat.
  • Si un alias TAG autorisé à envoyer du mail est spécifié dans l’objet de l’email, les DATA seront affectées au boat associé à ce Tag.
  • En cas d’informations contradictoires, le Tag prime sur l’email.
  • Vous pouvez envoyer les données en pièce jointe ou les écrire dans le corps du message

Note : L’email n’est pas la méthode recommandée, car la plupart des fournisseurs limitent strictement la taille des messages et des pièces jointes et peuvent les rejeter sans préavis. Cette méthode doit être réservée aux petites données texte ou aux trackers à faible bande passante tels qu’Iridium GO. Compressez vos fichiers pour économiser la bande passante (p. ex., .zip, .gzip, .z, .xz, .7z, .tar, .tgz).


🗑️ Suppression de Data

Pour supprimer des données :

  • Utilisez le menu Data > Delete
  • Supprimez par plage de dates ou par BatchID
  • Chaque import a un BatchID ; supprimer un batch ne supprime que ce lot de données
  • Supprimer un track ne supprime pas les data.


🗂️ Batches

À chaque import de données, un Batch ID est attribué. Toutes les données importées lors d’une même opération partagent le même Batch ID.

Par exemple, si vous importez 10 000 points de position d’un coup, ils auront tous le même Batch ID.

L’objectif principal du Batch ID est d’identifier les données importées ensemble depuis le même appareil et de permettre de supprimer l’import complet en une seule opération. Cela peut être utile en cas d’appareils défectueux ou de données corrompues.

Note : Importer plusieurs fois les mêmes données est pris en charge et ne nécessite pas de suppression manuelle via le Batch ID.

Les Batch IDs sont conservés pendant au moins un an après leur création. Passé ce délai, les données sont considérées comme valides et le Batch ID peut être supprimé.


🗺️ TRACKS :

Contrairement à d’autres systèmes de navigation, un Track dans Trakkit est simplement une tranche temporelle nommée au sein d’un ensemble de Data.

Vous définissez les dates/heures de début et de fin et vous lui donnez un nom.

Trakkit vérifiera si des Data correspondantes sont disponibles pour cet intervalle et les affichera le cas échéant.

Si aucune donnée n’est disponible, rien ne sera affiché. Plus tard, si des Data correspondant à l’intervalle du Track sont importées, le Track sera automatiquement mis à jour.

Un Track peut aussi être mis à jour manuellement via TRACK > Regen.

  • BoatName : Le bateau auquel le track doit être associé.
  • TrackName : Nom affiché du track.
  • Color : Choisissez la couleur du track. En plus des couleurs fixes standards, vous pouvez choisir un mode multicolore pour votre track basé sur la vitesse du bateau (SOG) ou la vitesse du vent apparent (AWS). SOG est calculé automatiquement, mais pour AWS vous devez l’avoir fournie dans vos données, typiquement en important des phrases NMEA.
  • Default Layer : La couche de premier plan de la carte à utiliser. La valeur par défaut est OSM SRTM Topographic. Notez que la disponibilité des tuiles peut varier, en particulier pour celles fournies par des agences américaines (NASA, NOAA, etc.), en raison de restrictions de financement affectant ces services aux États-Unis.
  • WPO : Intervalle en minutes pour les points de progression (points orange).
  • WPP : Intervalle en secondes pour les points de track (précision du Track). Attention : définir une précision trop élevée peut ralentir fortement le rendu, le chargement et la visualisation du track. Faites preuve de bon sens et ajustez la précision selon le type de track : « 60 pour la navigation côtière, 300 pour la navigation hauturière, et 600 pour les longues traversées » sont de bonnes lignes directrices. Pour le suivi en temps réel (LiveTrack), ce paramètre ne doit jamais être inférieur à 300 secondes. Une fois la trace et la navigation terminées, vous pouvez régénérer le track final avec une meilleure précision si nécessaire.
  • Published : Cochez ceci si vous souhaitez lister le track dans la « TRACK LIST » visible sur la page de votre bateau à https://.trakkit.org
  • Rappel : Supprimer un Track ne supprime pas les Data.

Nous vous conseillons fortement de régler les dates/heures de début et de fin de votre track de façon à ce que vos points exacts de départ et d’arrivée ne soient pas affichés de manière permanente

Visualiser un Track

  • Lien direct : https://trakkit.org/ttr/<TRACK-ID>
  • Depuis la page d’accueil avec le/la TRACK-ID
  • Les tracks sont rendus de manière statique et ne sont rafraîchis automatiquement que lorsque de nouvelles données sont importées
  • Peut être régénéré manuellement (TRACK > Regen)

Vous pouvez intégrer un lien responsive dans votre propre page ou site web en utilisant l’URL directe fournie dans votre section Boat :

    <div class="iframe-container">
      <iframe src="https://trakkit.org/ttr/<TRACK-ID>"
              title="My Track on Trakkit"></iframe>
    </div>

Note : Selon le moteur de rendu utilisé pour générer un track, l’URL affichée peut varier. Cependant, vous devez toujours utiliser le format https://trakkit.org/ttr/<TRACK-ID> pour accéder à un track, même si Trakkit le renomme ou le redirige ensuite en interne.

Visualiser le suivi en temps réel

Dans Boat > Edit > Direct URL, choisissez une URL pour votre bateau (généralement le nom du bateau).

Vous pouvez visualiser directement la position de votre bateau à :
https://boatname.trakkit.org

où « boatname » est le nom défini dans Direct URL.

Si un LiveTrack est activé (Boat > Edit > Active LiveTrack), la trace du bateau sera également affichée. Sinon, seule la dernière position connue sera affichée.

La page de suivi en direct par défaut affiche des infos de navigation et des boutons donnant accès à la Live Weather Map, à la Track List (pour les tracks marqués Public), et à la vue Full Screen. Veuillez noter que les données météo en direct sont fournies par un service tiers, peuvent être indisponibles indépendamment de notre volonté, et ne sont pas garanties exactes.

Vous préférerez probablement utiliser une vue plein écran sans le panneau de données à l’intérieur des frames intégrées dans votre propre site web ou vos pages web. Vous pouvez ouvrir une vue plein écran directement en utilisant l’URL suivante : https://trakkit.org/live/simple/boatname

Vous pouvez intégrer la vue de suivi en direct (ou tout autre track) directement dans une iframe sur votre propre site web ou page personnelle.
Par exemple, pour intégrer https://boatname.trakkit.org, utilisez le HTML suivant :

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



NoForeignLand


Si vous avez un compte NoForeignLand, Trakkit peut envoyer automatiquement votre position pour mettre à jour votre localisation sur le site NoForeignLand.

Pour activer cette fonctionnalité, ajoutez l’adresse d’envoi Trakkit (quelque chose comme nfl_xxxxx@trakkit.org) qui vous est attribuée dans Boat > Mails & Tag > NoForeignLand aux paramètres de synchronisation email de votre compte NoForeignLand.

Une fois cette adresse enregistrée sur NoForeignLand, cliquez sur « Activate » dans Trakkit. Votre position sera alors envoyée par email à intervalles réguliers. La synchronisation peut être désactivée ici à tout moment.

⚠️ Veuillez noter que NoForeignLand n’utilise pas les horodatages GNSS ; à la place, l’horodatage enregistré correspond à l’heure de la synchronisation. Les mises à jour de position sont effectuées au maximum toutes les 6 heures.



💻 Companion App


Une companion app est une application tierce qui collecte et envoie des données vers Trakkit.

Le code basé sur Python pour "joli_compagnon," l’application companion standard de Trakkit, est librement disponible et peut être facilement adapté à votre configuration. Il peut être téléchargé depuis Trakkit.org > About > Download Tools.

Vous pouvez mettre en place une solution de tracking complète et autonome à l’aide d’un simple Raspberry Pi ou de tout autre mini-ordinateur. Le processus complet d’installation est décrit dans les guides suivants : DIY Tracker with USB GPS et DIY Tracker with NMEA Gateway.

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