Hilfe & Dokumentation

Anhang: Was in einer GPX-Datei von PitStopper steckt

Eine GPX-Datei von PitStopper ist kein "schlichtes GPX". Sie ist eine gültige GPX-1.1-Datei, die jede App öffnen kann, trägt aber zusätzliche Informationen, für die der GPX-Standard keinen Platz hat: Farbe und Breite der Routenlinie, Abbiegehinweise, POI-Symbole und -Farben sowie geschätzte Zeiten. Diese Seite listet die Ergänzungen auf, welche Exportoption sie jeweils steuert und wo genau sie im XML stehen. Praktisch, wenn du eigene Werkzeuge schreibst, Dateien vergleichst oder dich fragst, warum eine andere App mehr (oder weniger) zeigt als erwartet.

GPX in Kürze

Eine GPX-Datei ist XML: ineinander verschachtelte Elemente in einer Reihenfolge, die der GPX-1.1-Standard festlegt. Hier die, auf die es ankommt.

Weil der Standard <sym>, <type> und <cmt> offen lässt, besteht vieles, was eine PitStopper-Datei nützlich macht, aus Werten, auf die sich andere Apps geeinigt haben, nicht aus neuen Elementen. Alles andere kommt in <extensions>.

Welche App liest das?

Eine Liste führen wir nicht. Apps ändern von Version zu Version, was sie lesen, oft ohne es zu sagen, und eine Tabelle dazu wäre schnell veraltet, sähe aber weiter wie eine Referenz aus. Diese Seite beschränkt sich darauf, was eine Datei enthält und wo. Um zu sehen, was eine deiner Dateien enthält, öffne sie im GPX-Inspektor; was eine App liest, steht in ihrer eigenen Dokumentation (einige sind unter Aus den Apps selbst verlinkt). Liest eine App unsere Datei anders als erwartet, sag uns bitte Bescheid.

Wo jede Ergänzung steht

Die Optionen findest du unter Exportieren → Datei exportieren, mit ausgewähltem GPX (siehe GPX exportieren). "Immer" heißt, dass es ohne Option geschrieben wird.

Fotos und Anhänge in einer .gpz

Ein Wegpunkt, Track oder eine Route nennt sein Foto mit einem Standard-<link>, dessen href ein Pfad im Archiv ist; das Bild liegt im Zip unter diesem Pfad. Ein Stopp aus einer in Locus Map erstellten .gpz sieht so aus:

<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>

• Gelesen - der Pfad wird ab der Wurzel des Archivs aufgelöst (zuerst mit exakter Groß-/Kleinschreibung, dann beliebig). Entpackt werden nur Dateien, die ein Link nennt. Ein Bild (geprüft am Inhalt: JPEG, PNG, WebP oder GIF) ist ein Foto; jede andere Datei (PDF, Dokument, Audio, Video, Webseite) wird byte-genau als Anhang aufbewahrt, zum Herunterladen angeboten und nie angezeigt. Grenzen: 10 MB pro Datei, 40 MB insgesamt.
• Aufbewahrt - die Originalbytes, einmal pro Bild gespeichert (über einen SHA-256 des Inhalts) in der eigenen Datenbank des Browsers, mit dem Link genau so, wie er geschrieben war.
• Geschrieben - ein .gpz-Export legt jedes Foto und jeden Anhang wieder unter seinem Pfad in files/ ab, mit demselben <link> (beim Foto eines Tracks im <trk>, nach dessen Namen). Beanspruchen zwei verschiedene Fotos denselben Pfad, bekommt das zweite ein -2 angehängt. Ein Foto außerhalb von files/ wird dorthin verschoben, damit es keinem Symbol in die Quere kommt (Symbole liegen in der Wurzel des Archivs). Eine einfache .gpx lässt relative Links weg; Links mit http, https und mailto werden immer geschrieben.
• Außerdem an diesem Wegpunkt - <ele> wird zur Höhe des Stopps und <time> zu seiner eigenen Zeit, und beide werden zurückgeschrieben; das Bild zu <sym> wird zum Symbol des Stopps (siehe Symbole in einer .gpz).

Wie das in PitStopper aussieht, steht unter Fotos und Anhänge in einer .gpz.

Namensräume

Ein kommentiertes Beispiel

Ein gekürzter Export mit den meisten Optionen eingeschaltet: eine Entfernungsmarkierung, ein favorisiertes Café und ein Track mit einer Abbiegung, einem Kreisverkehr und einem Belagwechsel.

<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>

Aus den Apps selbst

Wo die Apps ihre eigene Unterstützung beschreiben. Das sind ihre Worte, so wie sie dastanden, als wir sie gelesen haben; Apps ändern sich, also prüf es in der App selbst.

• OsmAnd - OsmAnd-GPX-Format: Wegpunkt-<icon>, <background> (Kreis, Quadrat, Achteck; das Achteck wird als Kreis gezeichnet) und <color>
• Cruiser - Abbiegehinweise im Trackpunkt-<sym> und route_information (befestigt, unbefestigt); Wegpunktfarben; Garmin-Symbolnamen; .gpz-Dateien öffnen
• Locus Map - Symbole passend zu Garmin-Symbolnamen; Abbiegehinweise im BRouter-"Locus-Stil" (BRouter-Profilanleitung, turnInstructionMode)
• Organic Maps und CoMaps - ihr GPX-Leser (Organic Maps, CoMaps) übernimmt <color> und Garmins DisplayColor für Tracks und Wegpunkte, mit fester Trackbreite
• gpx.studio - sein GPX-Leser versteht Farbe und Breite aus gpx_style
• GPX Viewer - "Color from file" für Tracks; Symbole aus einer .gpz
• Garmin - das Schema GpxExtensions v3: DisplayColor bei Tracks und Routen (für Wegpunkte gibt es keins)
• Die Reihenfolge der Farben - der Bericht eines Locus- und Cruiser-Nutzers dazu, erst Garmin, dann gpx_style, dann xsi:gpx zu schreiben

Die eigenen Elemente von PitStopper

Für einige Dinge, die PitStopper speichert, gibt es in keiner bestehenden GPX-Erweiterung ein Element. Dafür fügen wir eigene hinzu, im Block <xsi:gpx>, den Cruiser, OsmAnd und Locus Map bereits lesen. Die Regel ist einfach: Eine App, die ein Element nicht kennt, überspringt es, sie machen also nie eine Datei kaputt. Wir halten sie wenige, schlicht und hier dokumentiert, damit jede App sie ebenfalls lesen kann.

<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>

Sie stehen vor <color> und <width>, in Zeichenreihenfolge: das Band unten, die Linie oben. Ein KML-Export hält dieselbe Reihenfolge ein und schreibt das Placemark des Bands vor das der Route. Die Korridor-Elemente hat einer unserer Nutzer vorgeschlagen (Oktober 2026), damit ein Band keinen zweiten Track braucht. Der GPX-Inspektor benennt beide Elemente, prüft, ob <physicalColor> eine gültige Farbe ist, und zeigt den Korridor in seiner Übersicht und unter "In and out".

Gut zu wissen

• Farben kommen herein und gehen hinaus. Lädst du eine GPX-Datei, behält ein Track seine Farbe, Breite und Transparenz, gelesen zuerst aus gpx_style, dann aus xsi:gpx, dann aus Garmins Farbnamen; auch ein KML-Linienstil wird gelesen. Beim Export wird dasselbe Aussehen in allen drei Formen geschrieben, sodass eine in einer App gefärbte Route auch in den anderen gefärbt ankommt. Garmin kann nur die nächstliegende seiner 16 Farben übernehmen, ohne Breite. Die eigenen Linieneinstellungen von Locus Map in gpx_style:line (etwa ein Linienmuster) bleiben erhalten und werden zurückgeschrieben, wobei die Kopie von Farbe und Breite für Locus an deine angeglichen wird.
• Die Transparenz legst du pro Route in den Routeneinstellungen oder unter Routen verwalten fest: deckend, 25%, 50% oder 75% transparent oder vollständig transparent. Vollständig transparent heißt "in anderen Apps ausgeblendet": Es wird als Garmins Transparent und mit einer Deckkraft von 0 exportiert, während PitStopper die Route weiter gestrichelt zeichnet, damit du sie siehst.
• Die Breite stellst du in den Routeneinstellungen mit einem Schieberegler ein, von 1 bis 24 px, und eine Vorschau darüber zeigt die Linie mit Farbe, Transparenz und Strichelung, bevor du speicherst. Unter Routen verwalten gibt es vier Schnellbreiten. Die Breite wird in allen drei Formen geschrieben.
• Ein Korridor (Routeneinstellungen) zeichnet ein durchsichtiges Band in der Routenfarbe, so und so viele Meter zu beiden Seiten, das beim Zoomen seine Breite im Gelände behält. Er reist in jedem Format mit, das ihn aufnehmen kann, und kommt auch wieder herein: in GPX und .gpz als <physicalWidth> am Track (siehe Die eigenen Elemente von PitStopper); in KML und .kmz als zweite Linie unter der Route mit gx:physicalWidth, der Form, die Google Earth und Locus Map zeichnen. Öffnet PitStopper eine KML, wird diese zweite Linie wieder zum Korridor der Route, nicht zu einer eigenen Route. FIT hat dafür keine Form.
• Die Trackfarbe wird auf drei Arten geschrieben, weil jede App-Familie eine andere liest: zuerst Garmins gpxx, dann gpx_style, dann xsi:gpx, die Reihenfolge, die laut einem Locus- und Cruiser-Nutzer manche Leser brauchen (siehe die Quellen oben).
• Wie ein Abschnitt geroutet wurde, steht im <src> des Trackpunkts: beeline für eine Luftlinie, osm für einen beliebigen Weg. Diese beiden bedeuten in jedem Router dasselbe und lohnen sich daher: Cruiser lässt einen beeline-Abschnitt beim Neuberechnen der Route gerade (es hat kein Profil für beliebige Wege und ignoriert osm). Locus Map liest noch keins von beiden; sein Entwickler wurde gefragt. Cruiser schreibt dort außerdem den Namen seines Profils hinein (fastest, curvy und so weiter); PitStopper behält diese unverändert, aber andere Router zeichnen daraus nicht dieselbe Straße. (Von einem Locus- und Cruiser-Nutzer, November 2026.)
• Mehrere Routen in einer Datei ("Kombiniert", die Voreinstellung) ergeben einen <trk> pro Route, jeden in seiner eigenen Farbe. "Getrennte Dateien" ergibt ein Zip mit GPX-Dateien zu je einer Route.
• Symbole kommen herein und gehen hinaus. Eine .gpz aus einer anderen App bringt das PNG für jedes <sym> mit, das ihre Stopps nutzen (Bilder, die kein Stopp nutzt, bleiben draußen); PitStopper bietet an, die Stopps damit zu zeichnen, und schreibt denselben Symbolnamen und das Originalbild zurück, wenn ein Stopp mit einem solchen Symbol in einer .gpz mit Symbolen exportiert wird. Der eigene Ankerpunkt der Datei (hscc in der Referenzdatei von Cruiser) bleibt erhalten, wenn sich ihre Stopps auf einen einig sind, und das <scale> jedes Stopps zeichnet sein Symbol entsprechend größer oder kleiner.
• Locus Map und .gpz-Symbole (aus dem Test eines Nutzers mit der Beta von Locus Map, Oktober 2026): Es liest aus einer .gpz neben PNG auch SVG-Symbole und nimmt das SVG, wenn beide da sind. Es zeichnet jedes .gpz-Symbol mit der Mitte der Unterkante auf dem Punkt (hsbc), egal welchen Ankerpunkt die Datei verlangt, und nutzt <anchor> oder Farbe eines Wegpunkts noch nicht. Unsere eigenen, mittig gestalteten Symbole sitzen in Locus daher knapp über dem Ort; deine eigenen Symbole haben standardmäßig unten mittig, was Locus ohnehin macht.
• Ein importierter Stopp behält seine eigenen <extensions> aus der Originaldatei, anstelle von Symbol, Farbe und Form, die PitStopper hinzufügen würde. Aus der Datei einer anderen App behält er auch seine eigenen Einträge in <desc>, <cmt> und <link>.
• Nur POIs exportieren schreibt keine Farben, fügt aber trotzdem das OsmAnd-Symbol und die Form der Markierung hinzu.
• Zeiten werden nie erfunden: Geschätzte Zeiten brauchen eine Startzeit, und ein Track mit aufgezeichneten Zeiten behält sie, egal was die Option sagt.
• FIT und KML transportieren dieselben Informationen auf ihre eigene Art: FIT als Course Points, KML als Stile und Ordner. Siehe FIT exportieren und KML exportieren.