📖 Comment ça marche ?

1. L'objectif

Cette application suit en quasi temps réel la flotte de voiliers participant à la Croisière Bleue. Elle est avant tout destinée à l'équipe portuaire pour anticiper les arrivées, organiser l'accueil des équipages et planifier l'occupation des places.

Tout fonctionne sans inscription, sans application à installer : la carte est un site web accessible depuis n'importe quel navigateur.

Un bouton ☀️ / 🌙 en bas à droite de la carte bascule entre le mode clair (pratique en plein soleil sur le ponton) et le mode sombre. Le choix est mémorisé d'une session à l'autre.

Une échelle nautique est affichée en bas à droite de la carte (graduée en milles nautiques) pour estimer rapidement les distances à l'œil.

2. D'où viennent les positions

Chaque voilier de plus d'une certaine taille embarque un petit boîtier appelé AIS, qui émet en continu sa position, sa vitesse et son cap. Ces signaux sont captés par les bateaux alentour, par les stations côtières et par des satellites, puis agrégés par des services de suivi maritime publics.

L'application interroge deux sources en parallèle : MyShipTracking (mise à jour toutes les 5 minutes) et VesselFinder (cycle complet puis pause de 10 minutes). Pour chaque bateau, c'est la position la plus récente entre les deux sources qui est affichée.

Pour chacun, elle récupère :

• Sa position (latitude / longitude)
• Sa vitesse et son cap au moment de la dernière émission
• Le nom du voilier et son pavillon
• L'heure à laquelle il a émis cette position pour la dernière fois
• Le cas échéant, le port dans lequel il se trouve

3. À quelle fréquence ça se met à jour

Trois rythmes différents s'enchaînent :

En haut du panneau Prochains arrivés, un indicateur « actualisé il y a … » affiche en permanence l'heure de la dernière mise à jour réussie. Si la donnée a l'air bloquée, c'est par là qu'on s'en aperçoit. Les sous-sections « ⚓ À l'arrêt », « 🏁 Arrivés », « ❓ AIS silencieux » et « ⚠ Introuvables » affichent en plus leur propre compteur (n) dans leur en-tête.

Deux dates à distinguer

Deux horodatages différents coexistent dans l'application, à deux endroits différents :

• Données AIS (ligne AIS du popup d'un bateau) : la dernière fois que le bateau lui-même a émis sa position. Ça peut dater de quelques minutes à plusieurs heures.
• Actualisé (en-tête du panneau Prochains arrivés) : la dernière fois que l'application est allée vérifier. Ce sera typiquement il y a moins de 5 minutes.

Si la donnée AIS est ancienne mais que l'« actualisé » est récent, cela veut dire que le bateau n'émet pas — pas que l'application est en panne.

4. Les bateaux fantômes 👻

Quand un bateau n'a pas émis sa position depuis plusieurs minutes, sa position réelle a forcément bougé entre-temps. L'afficher figé à son dernier point connu serait trompeur.

L'application calcule donc une position estimée, surnommée fantôme : on prolonge la trajectoire du bateau depuis sa dernière position connue, en supposant qu'il a gardé son cap et sa vitesse.

Comment on les reconnaît

• La position réelle (la dernière vraiment émise) reste affichée en flèche pleine, libellé clair. (Le bateau a forcément un cap et une vitesse valides pour qu'un fantôme existe.)
• La position estimée apparaît à côté, en flèche pointillée légèrement transparente.
• Une ligne en pointillés relie les deux : c'est la trajectoire supposée pendant le silence.
• Dans le panneau Prochains arrivés, le bateau est suivi du symbole 👻.

Le popup du fantôme

Cliquer sur la flèche pointillée d'un fantôme ouvre un popup distinct de celui de la position réelle. Son en-tête grisé affiche 👻 nom du bateau (position estimée) et la première ligne « Projeté depuis » indique depuis combien de temps la trajectoire est extrapolée. Les autres indicateurs (SOG, COG, VMC, ETA, ETG, DTG) sont calculés à partir de la position estimée — utile pour répondre rapidement à la question : « si le bateau a tenu son cap, où en est-il et quand arrive-t-il ? ».

Quand est-ce qu'on projette ?

On ne crée un fantôme que si les conditions suivantes sont réunies :

• Le bateau était en mouvement à sa dernière émission (au moins 0,3 nœud, donc pas à l'arrêt ni au mouillage).
• On connaît son cap.
• Sa dernière position date d'au moins 5 minutes.
• Sa dernière position date de moins de 2 h : au-delà, l'incertitude devient trop grande et on arrête de projeter (le bateau bascule alors dans les AIS silencieux).

5. Les bateaux AIS silencieux ❓

Quand un bateau n'a plus émis depuis plus de 2 heures, on considère que sa position connue ne dit plus où il est réellement. Il a pu virer, ralentir, mouiller, repartir dans une autre direction… Le projeter (« fantôme ») n'a plus de sens : l'écart possible avec la réalité devient trop grand pour qu'on puisse le classer dans la course.

Concrètement, qu'est-ce qui change ?

• Il sort du panneau « Prochains arrivés » et de son classement par distance.
• Il apparaît dans une nouvelle section repliable « ❓ AIS silencieux », en bas du panneau, triée par âge AIS croissant (le plus récent d'abord).
• Sur la carte, sa dernière position connue est affichée par un point grisé en pointillés avec un libellé plus discret — le cap n'étant plus fiable, une flèche n'aurait pas de sens.
• Aucun fantôme ni ligne de projection ne sont dessinés pour lui.
• Son popup affiche un bandeau « ⚠ Position non fiable » et masque l'ETA/ETG (sans intérêt tant qu'on n'a pas de signal frais).

Dès qu'un de ces bateaux émet à nouveau une position fraîche, il réintègre automatiquement le classement — il n'y a rien à faire manuellement.

6. Les bateaux introuvables ⚠

Pour certains MMSIs, la fiche sur le service de suivi n'existe pas (erreur 404) ou ne contient pas les coordonnées attendues. Le serveur n'a donc aucune position à afficher pour ces bateaux.

Concrètement, qu'est-ce qui change ?

• Ces bateaux n'apparaissent pas sur la carte (pas de position connue).
• Ils sont listés dans une section repliable « ⚠ Introuvables », tout en bas du panneau, affichant leur nom (issu de vessels.csv) et leur MMSI.

Cette situation est différente des AIS silencieux : un bateau AIS silencieux a une dernière position connue (simplement trop ancienne), alors qu'un bateau introuvable n'en a aucune dans la base de données du service AIS.

7. Les bateaux à l'arrêt ⚓

Un bateau AIS actif peut être immobile : au mouillage, en escale ou en attente d'entrée au port. Tant que ses données AIS restent fraîches (moins de 2 h), il n'est pas silencieux — mais sa vitesse est nulle ou quasi nulle (≤ 0,1 nœud).

Concrètement, qu'est-ce qui change ?

• Ces bateaux sont retirés du classement « Prochains arrivés » : sans vitesse, aucune ETA ne peut être calculée.
• Ils apparaissent dans une section repliable « ⚓ À l'arrêt », juste en dessous de la liste principale, triée par distance croissante à l'arrivée.
• Sur la carte, ils sont représentés par un point plein (et non une flèche), car leur cap n'a pas de valeur opérationnelle.
• Leur popup affiche les indicateurs normaux, mais ETA, ETG et VMC s'affichent — faute de vitesse.

Dès qu'un bateau repart et dépasse 0,1 nœud, il réintègre automatiquement le classement principal.

8. Les prochains arrivés

Le panneau « Prochains arrivés » trie tous les bateaux en course par heure d'arrivée estimée (ETA). Le premier de la liste est celui dont l'ETA est la plus proche, calculée à partir de sa VMC actuelle (voir § 9).

Quelques règles

• Les trois premiers reçoivent les médailles 🥇 🥈 🥉. Les suivants apparaissent simplement avec leur rang.
• Quand un bateau a un fantôme, c'est sa position estimée (et non sa dernière position connue) qui sert au calcul de l'ETA.
• Les bateaux sans ETA calculable (cap inconnu ou VMC négative) apparaissent en fin de liste, triés par distance.
• Les bateaux à l'arrêt (vitesse ≤ 0,1 kt) sont retirés de ce classement et regroupés dans la section « ⚓ À l'arrêt » juste en dessous. Sur la carte, ils apparaissent sous forme de point plutôt que de flèche.
• Les bateaux silencieux depuis plus de 2 h sont retirés du classement (cf. AIS silencieux).
• Les bateaux déjà arrivés quittent le classement et basculent automatiquement dans la section repliable « 🏁 Arrivés », juste en dessous.
• Cliquer sur une ligne du panneau recentre la carte sur le bateau concerné, ouvre son popup, et replie automatiquement le panneau pour libérer la vue.
• Le panneau et toutes ses sous-sections sont repliés par défaut au chargement de la carte. Un clic sur l'en-tête principal ou sur une sous-section les déploie ou les replie indépendamment (« À l'arrêt », « Arrivés », « AIS silencieux », « Introuvables »).
• Au tout premier chargement, la carte se cadre automatiquement sur les bateaux en course uniquement : les bateaux AIS silencieux sont ignorés pour le cadrage, leur dernière position connue ne reflétant plus leur localisation réelle.

Ce que chaque ligne affiche

• À gauche : la médaille (🥇 🥈 🥉) ou le rang #N, et la pastille colorée propre au bateau (la même couleur sert à dessiner sa flèche sur la carte).
• Au centre : le nom du bateau (suivi de 👻 si la position est estimée), et en sous-ligne sa distance restante jusqu'à l'arrivée suivie de sa vitesse actuelle (par exemple 12,3 mn · 5,2 kt).
• À droite : la durée restante (ETG) jusqu'à l'arrivée, par exemple 2j 13h 45min. Pour la date d'arrivée précise, ouvrir le popup du bateau (cf. § 9).

9. L'heure d'arrivée estimée

Pour chaque bateau, deux indicateurs temporels sont affichés :

Le calcul utilise la VMC (Velocity Made on Course) : la composante de la vitesse du bateau effectivement dirigée vers l'arrivée. On projette le vecteur vitesse sur le relèvement vers l'arrivée : VMC = SOG × cos(COG − relèvement vers l'arrivée). L'ETG vaut alors DTG / VMC.

La valeur de la VMC est désormais affichée directement dans le popup de chaque bateau (entre le COG et l'ETA), en nœuds. Une VMC négative ou nulle signifie que le bateau s'éloigne de l'arrivée ou navigue perpendiculairement ; dans ce cas l'ETA et l'ETG affichent —.

Si le cap (COG) n'est pas disponible dans les données AIS, ou si la VMC est nulle ou négative (le bateau s'éloigne de l'arrivée ou navigue perpendiculairement), aucune ETA n'est affichée.

Ce qu'affiche le popup d'un bateau

Cliquer sur la flèche d'un bateau ouvre un popup avec :

• En en-tête : l'icône ⛵ (❓ si AIS silencieux, 👻 si position estimée), le nom du bateau, et en sous-titre son modèle s'il est connu depuis vessels.csv (sinon MMSI · pavillon).
• Au corps : les indicateurs SOG, COG, VMC, ETA, ETG, DTG et l'âge de la dernière émission AIS. Pour un bateau AIS silencieux, seul l'âge AIS est affiché et un bandeau d'avertissement remplace les autres indicateurs.
• En pied : un lien « Suivre sur MyShipTracking → » ou « Suivre sur VesselFinder → » selon la source qui a fourni la position la plus récente. Il ouvre la fiche du bateau sur le service correspondant pour vérifier la donnée brute ou consulter l'historique.

10. L'arrivée

Une fois qu'un bateau est arrivé, on ne veut plus le voir polluer le classement : il ne court plus. Dès qu'il entre dans la zone d'arrivée, il sort automatiquement du classement « Prochains arrivés » et apparaît dans la section repliable « 🏁 Arrivés », juste en dessous, triée du plus récemment signalé au plus ancien. Cette section s'affiche dès qu'au moins un bateau est arrivé et reste visible même si le dernier signal AIS du bateau date de plus de 3 h.

Une zone d'arrivée est dessinée sur la carte (le polygone rouge légèrement transparent) — comme ça tout le monde voit exactement où finit la course.

11. Glossaire