Aide & documentation

Annexe : ce que contient un fichier GPX de PitStopper

Un fichier GPX de PitStopper n'est pas du « GPX tout simple ». C'est un fichier GPX 1.1 valide que n'importe quelle appli peut ouvrir, mais il contient des informations en plus pour lesquelles la norme GPX n'a pas de place : la couleur et la largeur du tracé, les instructions de navigation, les icônes et couleurs des POI, et les horaires estimés. Cette page liste ces ajouts, l'option d'export qui contrôle chacun et l'endroit exact où il se trouve dans le XML. Utile si vous écrivez vos propres outils, comparez des fichiers, ou vous demandez pourquoi une autre appli en montre plus (ou moins) que prévu.

Le GPX en bref

Un fichier GPX, c'est du XML : des éléments imbriqués les uns dans les autres, dans un ordre fixé par la norme GPX 1.1. Voici ceux qui comptent ici.

Comme la norme laisse <sym>, <type> et <cmt> ouverts, une grande partie de ce qui rend un fichier PitStopper utile, ce sont des valeurs sur lesquelles les autres applis s'accordent, pas de nouveaux éléments. Tout le reste va dans <extensions>.

Quelle appli les lit ?

Nous ne tenons pas de liste. Les applis changent ce qu'elles lisent d'une version à l'autre, souvent sans le dire, et un tableau deviendrait faux tout en ayant l'air d'une référence. Cette page s'en tient à ce que contient un fichier et où. Pour voir ce que contient un de vos fichiers, ouvrez-le dans l'inspecteur GPX ; pour ce qu'une appli lit, sa propre documentation fait foi (certaines sont liées sous Venant des applis elles-mêmes). Si une appli lit notre fichier autrement que vous ne l'attendiez, dites-le-nous.

Où se trouve chaque ajout

Les options se trouvent dans Exporter → Exporter un fichier, avec GPX sélectionné (voir Export GPX). « Toujours » signifie que c'est écrit sans option.

Photos et pièces jointes dans un .gpz

Un waypoint, une trace ou une route désigne sa photo par un <link> standard dont le href est un chemin dans l'archive ; l'image se trouve dans le zip à ce chemin. Un arrêt d'un .gpz créé dans Locus Map ressemble à ceci :

<wpt lat="51.0411449" lon="3.9846805">
  <ele>6.49</ele>
  <time>2026-10-07T06:06:14.000Z</time>
  <name>Kapel</name>
  <link href="files/screenshot_20260504-175910.png"></link>   <!-- the photo, in the zip -->
  <sym>Scenic Area</sym>                                   <!-- the icon: "Scenic Area.png" in the zip root -->
</wpt>

• Lecture - le chemin est résolu depuis la racine de l'archive (casse exacte d'abord, puis n'importe quelle casse). Seuls les fichiers désignés par un lien sont extraits. Une image (vérifiée d'après son contenu : JPEG, PNG, WebP ou GIF) est une photo ; tout autre fichier (PDF, document, audio, vidéo, page web) est gardé comme pièce jointe, octets intacts, proposé au téléchargement et jamais affiché. Limites : 10 Mo par fichier, 40 Mo au total.
• Conservation - les octets d'origine, stockés une seule fois par image (d'après un SHA-256 de son contenu) dans la base de données du navigateur, avec le lien laissé exactement tel qu'écrit.
• Écriture - un export .gpz remet chaque photo et pièce jointe à son chemin, sous files/, avec le même <link> (sur le <trk>, après son nom, pour celles d'une trace). Si deux photos différentes revendiquent le même chemin, la seconde reçoit -2. Une photo hors de files/ y est déplacée, pour ne pas croiser une icône (les icônes sont à la racine de l'archive). Un simple .gpx omet les liens relatifs ; les liens http, https et mailto sont toujours écrits.
• Aussi sur ce waypoint - <ele> devient l'altitude de l'arrêt et <time> son heure, et les deux sont réécrits ; l'image du <sym> devient l'icône de l'arrêt (voir Icônes dans un .gpz).

Pour voir à quoi cela ressemble dans PitStopper, voir Photos et pièces jointes dans un .gpz.

Espaces de noms

Un exemple commenté

Un export raccourci avec la plupart des options activées : un marqueur de distance, un café étoilé, et une trace avec un virage, un rond-point et un changement de revêtement.

<gpx version="1.1" creator="PitStopper.net"
  xmlns="http://www.topografix.com/GPX/1/1"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:gpxx="http://www.garmin.com/xmlschemas/GpxExtensions/v3"
  xmlns:gpx_style="http://www.topografix.com/GPX/gpx_style/0/2"
  xsi:schemaLocation="http://www.topografix.com/GPX/1/1 https://www.topografix.com/GPX/1/1/gpx.xsd">
  <metadata>...</metadata>

  <wpt lat="51.041" lon="3.99">                     <!-- a distance marker -->
    <time>2026-10-05T08:04:00Z</time>               <!-- estimated times -->
    <name>1 km</name><desc>1 km</desc><sym>Dot</sym><type>km_marker</type>
  </wpt>

  <wpt lat="51.0455" lon="3.9902">                  <!-- a starred cafe -->
    <time>2026-10-05T08:02:00Z</time>
    <name>Cafe Centr L20m</name>                    <!-- short name + "on your left, 20 m" -->
    <cmt>coffee. Closes early Sunday</cmt>          <!-- type + your note -->
    <desc>Full name: Cafe Centraal. Cafes. Hours: Mo-Sa 08:00-18:00</desc>
    <src>OpenStreetMap</src>
    <link href="https://www.openstreetmap.org/node/11">...</link>
    <sym>Restaurant</sym>                           <!-- Garmin symbol -->
    <type>FOOD</type>                               <!-- course-point type -->
    <extensions>
      <xsi:gpx>
        <color>#FFFF00</color>                      <!-- starred colour (else the category colour) -->
        <background>square</background>             <!-- starred shape -->
        <icon>amenity_cafe</icon>                   <!-- OsmAnd icon -->
      </xsi:gpx>
    </extensions>
  </wpt>

  <trk>
    <name>My ride</name>
    <extensions>                                    <!-- line colour and width -->
      <gpxx:TrackExtension><gpxx:DisplayColor>DarkBlue</gpxx:DisplayColor></gpxx:TrackExtension>
      <gpx_style:line><gpx_style:color>1976D2</gpx_style:color><gpx_style:width>5</gpx_style:width></gpx_style:line>
      <xsi:gpx><color>#1976D2</color><width>5</width></xsi:gpx>
    </extensions>
    <trkseg>
      <trkpt lat="51.05" lon="3.99"><ele>3</ele>
        <extensions><xsi:gpx><route_information>paved</route_information></xsi:gpx></extensions>
      </trkpt>
      <trkpt lat="51.0455" lon="3.99"><ele>4</ele>
        <cmt>High Street</cmt><sym>left</sym>       <!-- turn left onto High Street -->
      </trkpt>
      <trkpt lat="51.041" lon="3.99"><ele>5</ele>
        <sym>roundabout_e3</sym>                    <!-- roundabout, third exit -->
        <extensions><xsi:gpx><route_information>unpaved</route_information></xsi:gpx></extensions>
      </trkpt>
    </trkseg>
  </trk>
</gpx>

Venant des applis elles-mêmes

Là où les applis décrivent elles-mêmes ce qu'elles prennent en charge. Ce sont leurs mots, tels qu'ils étaient quand nous les avons lus ; les applis évoluent, vérifiez donc dans l'appli elle-même.

• OsmAnd - format GPX d'OsmAnd : <icon> de waypoint, <background> (cercle, carré, octogone - l'octogone est dessiné comme un cercle) et <color>
• Cruiser - navigation guidée dans le <sym> du point de trace et route_information (revêtu, non revêtu) ; couleurs des waypoints ; noms d'icônes Garmin ; ouverture des fichiers .gpz
• Locus Map - icônes correspondant aux noms de symboles Garmin ; navigation guidée dans le « style Locus » de BRouter (guide des profils BRouter, turnInstructionMode)
• Organic Maps et CoMaps - leur lecteur GPX (Organic Maps, CoMaps) prend <color> et le DisplayColor de Garmin pour les traces et les waypoints, avec une largeur de trace fixe
• gpx.studio - son lecteur GPX gère la couleur et la largeur gpx_style
• GPX Viewer - « Color from file » pour les traces ; icônes de symboles depuis un .gpz
• Garmin - le schéma GpxExtensions v3 : DisplayColor sur les traces et les routes (il n'y en a pas pour les waypoints)
• L'ordre des couleurs - le retour d'un utilisateur de Locus et Cruiser sur l'écriture de Garmin, puis gpx_style, puis xsi:gpx

Les éléments propres à PitStopper

Quelques informations que garde PitStopper n'ont d'élément dans aucune extension GPX existante. Pour celles-là, nous ajoutons les nôtres, dans le bloc <xsi:gpx> que Cruiser, OsmAnd et Locus Map lisent déjà. La règle est simple : une appli qui ne connaît pas un élément l'ignore, ils ne cassent donc jamais un fichier. Nous les gardons peu nombreux, simples et documentés ici, pour que n'importe quelle appli puisse les lire aussi.

<trk>
  <name>Morning ride</name>
  <extensions>
    <xsi:gpx>
      <physicalWidth>40</physicalWidth>        <!-- the band, under: 40 m, 20 m either side -->
      <physicalColor>#401976D2</physicalColor> <!-- the line colour, 25% -->
      <color>#1976D2</color>                  <!-- the line, on top -->
      <width>4</width>
    </xsi:gpx>
  </extensions>
  <trkseg>...</trkseg>
</trk>

Ils viennent avant <color> et <width>, dans l'ordre de dessin : la bande dessous, le tracé dessus. Un export KML garde le même ordre et écrit le placemark de la bande avant celui de l'itinéraire. Les éléments de corridor ont été suggérés par un de nos utilisateurs (octobre 2026), pour qu'une bande n'ait pas besoin d'une seconde trace. L'inspecteur GPX nomme les deux éléments, vérifie que <physicalColor> est une couleur valide, et affiche le corridor dans son résumé et dans « In and out ».

Bon à savoir

• Les couleurs entrent autant qu'elles sortent. Quand vous chargez un fichier GPX, une trace garde la couleur, la largeur et la transparence qu'on lui avait données, lues d'abord dans gpx_style, puis xsi:gpx, puis le nom de couleur Garmin ; un style de ligne KML est lu aussi. À l'export, le même rendu est écrit sous les trois formes, donc un itinéraire coloré dans une appli arrive coloré dans les autres. Garmin ne peut prendre que la plus proche de ses 16 couleurs, sans largeur. Les réglages de ligne propres à Locus Map dans gpx_style:line (comme un motif de ligne) sont gardés et réécrits, avec la copie de Locus de la couleur et de la largeur alignée sur les vôtres.
• La transparence se règle par itinéraire dans Paramètres de l'itinéraire ou le gestionnaire d'itinéraires : opaque, transparent à 25%, 50% ou 75%, ou totalement transparent. Totalement transparent veut dire « masqué dans les autres applis » (exporté en Transparent Garmin et avec une opacité de 0), tandis que PitStopper dessine toujours l'itinéraire, en pointillés, pour que vous le voyiez.
• La largeur se règle dans Paramètres de l'itinéraire avec un curseur, de 1 à 24 px, et un aperçu au-dessus montre le tracé avec sa couleur, sa transparence et ses pointillés avant d'enregistrer. Le gestionnaire d'itinéraires propose quatre largeurs rapides. La largeur est écrite sous les trois formes.
• Un corridor (Paramètres de l'itinéraire) dessine une bande translucide de la couleur de l'itinéraire, sur un certain nombre de mètres de chaque côté, en gardant sa largeur au sol quand vous zoomez. Il voyage dans tous les formats qui peuvent le porter, et revient à l'import : en GPX et .gpz sous forme de <physicalWidth> sur la trace (voir Les éléments propres à PitStopper) ; en KML et .kmz sous forme d'une seconde ligne sous l'itinéraire avec gx:physicalWidth, la forme que dessinent Google Earth et Locus Map. Quand PitStopper ouvre un KML, cette seconde ligne redevient le corridor de l'itinéraire, et non un itinéraire à part. FIT n'a pas de forme pour cela.
• La couleur de la trace est écrite de trois façons parce que chaque famille d'applis en lit une différente : gpxx de Garmin d'abord, puis gpx_style, puis xsi:gpx, l'ordre dont certains lecteurs ont besoin selon un utilisateur de Locus et Cruiser (voir les sources plus haut).
• La façon dont une section a été calculée voyage dans le <src> du point de trace : beeline pour une ligne droite, osm pour n'importe quel chemin. Ces deux valeurs veulent dire la même chose dans tous les calculateurs d'itinéraire, elles valent donc d'être gardées : Cruiser laisse une section beeline en ligne droite quand il recalcule l'itinéraire (il n'a pas de profil « n'importe quel chemin », il ignore donc osm). Locus Map ne lit encore ni l'un ni l'autre ; son développeur a été sollicité. Cruiser y écrit aussi le nom de son profil (fastest, curvy, etc.) ; PitStopper les garde tels quels, mais d'autres calculateurs n'en tireront pas la même route. (D'après un utilisateur de Locus et Cruiser, novembre 2026.)
• Plusieurs itinéraires dans un fichier (« Combiné », par défaut) donnent un <trk> par itinéraire, chacun dans sa couleur. « Fichiers séparés » donne un zip de fichiers GPX à un seul itinéraire.
• Les icônes entrent autant qu'elles sortent. Un .gpz d'une autre appli apporte le PNG de chaque <sym> utilisé par ses arrêts (les images qu'aucun arrêt n'utilise sont laissées de côté) ; PitStopper propose de dessiner les arrêts avec, et réécrit le même nom de symbole et l'image d'origine quand un arrêt qui en porte une est exporté dans un .gpz avec icônes. L'ancrage du fichier (hscc dans le fichier de référence de Cruiser) est gardé quand ses arrêts sont d'accord sur un seul, et le <scale> de chaque arrêt dessine son icône d'autant plus grande ou plus petite.
• Locus Map et les icônes .gpz (d'après les essais d'un utilisateur sur la bêta de Locus Map, octobre 2026) : il lit les icônes SVG d'un .gpz autant que les PNG, et quand les deux sont présentes il utilise le SVG. Il dessine chaque icône .gpz avec son bas-centre sur le point (hsbc), quel que soit l'ancrage demandé par le fichier, et n'utilise pas encore l'<anchor> ni la couleur d'un waypoint. Dans Locus, nos icônes, dessinées centrées, se trouvent donc juste au-dessus du lieu ; vos propres icônes sont par défaut ancrées en bas au centre, ce que fait Locus de toute façon.
• Un arrêt importé garde ses propres <extensions> du fichier d'origine, à la place de l'icône, de la couleur et de la forme qu'ajouterait PitStopper. Venant du fichier d'une autre appli, il garde aussi ses propres <desc>, <cmt> et <link>.
• Exporter uniquement les POI n'écrit aucune couleur, mais ajoute quand même l'icône OsmAnd et la forme du marqueur.
• Les horaires ne sont jamais inventés : les horaires estimés demandent une heure de départ, et une trace arrivée avec des temps enregistrés les garde quelle que soit l'option.
• FIT et KML portent les mêmes informations à leur façon : FIT sous forme de points de parcours, KML sous forme de styles et de dossiers. Voir Export FIT et Export KML.