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 au large.

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 d’exemples de données 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 à l’aide d’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 à : 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 marche ?

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 au sein desquelles 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.

Structure de base :

  • 1 User peut avoir plusieurs Boats
  • 1 Boat appartient à 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 boat est la première étape nécessaire pour importer des données et associer des tracks.


📝 Champs disponibles


  • Name (obligatoire) : identifie le boat.
  • Maxspeed : en nœuds. Utilisé pour détecter d’éventuelles anomalies de points GPS (p. ex. vitesses irréalistes).
  • Info : 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 boat (et à son LiveTrack s’il est défini). Il est généralement recommandé d’utiliser le nom du boat. <boatname>.trakkit.org
  • Email : adresse depuis laquelle les emails de tracking seront envoyés. Ceci est remplacé si un TAG valide est inclus dans l’objet 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 de votre boat. Vous pouvez les utiliser pour envoyer des données, accéder au serveur SFTP, ou créer votre propre expéditeur de données. Pour envoyer des données 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 boat pour la première fois, un test track et un jeu d’exemples de Data 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 test track et ses données 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 de donner 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 boat en données. Boat > Mails & Tag > Add Tag Si l’accès à un système est compromis ou indisponible, supprimez simplement le tag associé.

Pour alimenter en 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

⚠️ Assurez-vous de vous souvenir de ce mot de passe, car il ne peut pas être récupéré. Si le mot de passe 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 personnes pour donner 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 mots de passe peuvent être utilisés pour accéder au serveur SFTP, le Tag servant d’identifiant.




📈 Data


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


Qu’est-ce que DATA ?


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

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 trafic fichier NMEA 0183, enregistré avec des apps comme OpenCPN ou QtVlm ou une app compagnon.
  • Un fichier TEXT classique contenant des informations de position GPS, comme ceux envoyés par email avec des appareils tels que Iridium Go :

I am here Lat+28.851240 Lon-13.794377 Alt+009ft GPS Sats seen 10 2023-01-17 00:34UTC

Ou une ligne suivant ce motif :

[±]Latitude [±]Longitude YYYY-MM-DD HH:MM[:SS[.sss]] [Timezone] [AWA:XXX] [AWS:XX.X] [COG:XXX] [SOG:XX.X] ...

NB : Latitude et Longitude sont en degrés décimaux. La date, l’heure et le fuseau horaire peuvent être combinés dans un format ISO unique : 2025-11-10T14:26:05Z. Plusieurs lignes sont autorisées dans un message texte ou un fichier attaché.

Exemple de format texte accepté :

-38.1052 -12.277 20210210 102345                                # UTC implicit
46.238 -0.5687 2021-02-10 10:23:45 UTC
-38.1052 -12.277 20210210 102345 UTC+2                          # If, for some mysterious reason, your navigation system isn’t set to UTC…
46.238 -0.5687 2021-02-10 10:23:45 UTC COG:125 SOG:9.2
-38.1052 -12.277 2021-02-10T10:23:45Z                           # ISO format UTC
46.238 -0.5687 2021-02-10T10:23:45+02:00 AWA:120 AWS:23.5       # ISO format UTC+2


Comment envoyer des DATA :


Vous pouvez envoyer des Data de différentes manières à différents moments. Avec une connexion internet en mer, vous pouvez envoyer les 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’envoi choisie, toutes les Data peuvent être compressées en : .zip .gzip .z .xz .7z .tar .tgz


📤 Par import direct de Data sur Trakkit.org :

L’une des façons les plus simples est de vous connecter à Trakkit.org, DATA>UPLOAD et d’importer votre fichier GPX, NMEA ou TEXT exporté depuis une application de navigation ou un appareil GNSS.


📡 Par SFTP :

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

Les identifiants & l’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’envoi : 1 connexion toutes les 3 minutes. Taille maximale de fichier : 50 MB par import. Ne pas respecter ces recommandations peut entraîner des restrictions d’accès à l’import, voire un bannissement définitif 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 suivre 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 (BOATS > Mails & Tags), 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 Boat correct.

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 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 prévaut 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 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 des Data

Pour supprimer des données :

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


---

🗺️ 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 sur 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 boat auquel la trace doit être associée.
  • TrackName : nom affiché de la trace.
  • Color : choisissez la couleur de la trace. En plus des couleurs fixes standard, vous pouvez choisir un mode multicolore pour votre trace basé sur la vitesse du boat (SOG) ou la vitesse du vent apparent (AWS). SOG est calculé automatiquement, mais pour AWS vous devez l’avoir fourni dans vos données, typiquement en important des phrases NMEA.
  • Default Layer : la couche d’avant-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 (les points orange).
  • WPP : intervalle en secondes pour les points de trace (précision du Track). Attention : régler une précision trop élevée peut ralentir drastiquement le rendu, le chargement et la visualisation de la trace. Faites preuve de bon sens et ajustez la précision selon le type de navigation : « 60 pour la navigation côtière, 300 pour le large, et 600 pour les longues traversées » sont de bonnes lignes directrices. Pour le suivi en temps réel (LiveTrack), cette valeur ne doit jamais être inférieure à 300 secondes. Une fois la trace et la navigation terminées, vous pouvez régénérer la trace finale avec une précision plus élevée si nécessaire.
  • Published : cochez ceci si vous souhaitez lister la trace dans la "TRACK LIST" visible sur la page de votre boat à l’adresse https://.trakkit.org
  • Rappel : supprimer un Track ne supprime pas les Data.

Nous vous conseillons vivement de définir les dates/heures de début et de fin de votre track afin 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 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 la section de votre 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 plus tard en interne.

Visualiser le suivi en temps réel

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

Vous pouvez voir la position de votre boat directement à :
https://boatname.trakkit.org

Où 'boatname' est le nom donné dans Direct URL.

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

La page de suivi en temps réel par défaut affiche des informations de navigation et des boutons donnant accès à la Live Weather Map, à la Track List (pour les tracks marqués Public), et à la vue plein écran. 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 comme 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 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 temps réel (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 afin de 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 au moment 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 de "joli_compagnon," l’application compagnon standard de Trakkit, est disponible librement 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 avec un simple Raspberry Pi ou tout autre mini-ordinateur. Le processus complet de configuration est décrit dans les guides suivants : DIY Tracker with USB GPS et DIY Tracker with NMEA Gateway.

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