OsmAnd GPX

Introductie

GPX (GPS Exchange Format) is een veelgebruikte, op XML gebaseerde standaard voor het opslaan van GPS-gegevens, inclusief tracks, routes en waypoints. OsmAnd ondersteunt het GPX-formaat voor het importeren, exporteren en aanpassen van GPS-gegevens voor navigatie, waardoor zowel beginnende als gevorderde gebruikers hun ervaring kunnen optimaliseren.

Wat maakt OsmAnd GPX uniek?

OsmAnd breidt het standaard GPX 1.1-formaat uit door zijn eigen aangepaste osmand: XML-naamruimte te introduceren. Deze naamruimte maakt het mogelijk om extra gegevens op te slaan, zoals:

Visuele instellingen van de track (kleur, breedte, pijlen).
Groepering en iconen van waypoints.
Gedetailleerde routeattributen, inclusief berekende routes en activiteitstypes.

Wat leert u in deze gids?

Dit artikel geeft een uitgebreid overzicht van de GPX-bestandsstructuur en -functies in OsmAnd. U leert:

Hoe u tracks en waypoints kunt aanpassen met GPX-tags.
Geavanceerde functies zoals HTML-beschrijvingen, sensorgegevens en activiteitstypes.
Hoe u berekende routes kunt exporteren en hun volledige functionaliteit kunt behouden.
GPX-bestanden converteren naar OBF-formaat voor geoptimaliseerde opslag en geavanceerde zoekmogelijkheden.

Overzicht van de GPX-structuur

GPX-bestanden in OsmAnd organiseren gegevens hiërarchisch in de volgende elementen:

<gpx> - het root-element van het bestand.
<trk> - vertegenwoordigt tracks, die het volgende bevatten:
- <trkseg> - segmenten van de track, die verder zijn onderverdeeld in <trkpt> (trackpunten).
<rte> - vertegenwoordigt routes, inclusief waypoints en belangrijke punten.
<wpt> - vertegenwoordigt individuele waypoints.

GPX-importgedrag

Bij het importeren van een GPX-bestand maakt OsmAnd één trackobject aan op basis van het bestand:

De naam van de geïmporteerde track is afgeleid van de naam van het GPX-bestand. Het <name>-element binnen <trk> wordt niet gebruikt als de primaire tracknaam tijdens de import.
Als een GPX-bestand meerdere <trk>-elementen bevat, importeert OsmAnd deze als segmenten van dezelfde track. In dat geval kunnen de <name>-waarden worden gebruikt als labels voor de bijbehorende segmenten binnen de track.

Trackaanpassing

Parameters voor trackweergave

Deze sectie beschrijft hoe OsmAnd tracks op de kaart weergeeft en de aanpassingsopties die beschikbaar zijn om hun uiterlijk aan te passen. De hieronder beschreven parameters worden toegepast binnen de <gpx>-tag en hebben invloed op alle tracks in een GPX-bestand.

Tag Name	Description / Values
`<color>`	- Definieert de kleur van de tracklijn op de kaart. - String: HEX-kleurcode `#RRGGBB` of `#AARRGGBB`
`<width>`	- Specificeert de breedte van de tracklijn. - String: `“thin”`, `“medium"`, `“bold”` (gedefinieerd door het `“currentTrackWidth”`-attribuut), of een geheel getal (1-24)
`<show_arrows>`	- Schakelt richtingspijlen langs de track in of uit. - Bool: `"true"` / `"false"`
`<show_start_finish>`	- Toont of verbergt markeringen voor het begin en einde van de track. - Bool: `"true"` / `"false"`
`<split_type>`	- Specificeert het type segmentatie voor de track. - String: `"no_split"`, `"distance"`, `"time"`
`<split_interval>`	- Stelt het interval in voor tracksegmentatie op basis van het geselecteerde type. - Double: Geheel getal (meters voor `"distance"`, seconden voor `"time"`)
`<line_3d_visualization_by_type>`	- Specificeert het type 3D-visualisatie voor de track. - String: `"none"`, `"altitude"`, `"shared_string_speed"`, `"map_widget_ant_heart_rate"`, `"map_widget_ant_bicycle_cadence"`, `"map_widget_ant_bicycle_power"`, `"shared_string_temperature"`, `"shared_string_speed"`, `"fixed_height"`
`<line_3d_visualization_wall_color_type>`	- Definieert het muurkleurtype voor 3D-visualisatie. - String: `"none"`, `"solid"`, `"downward_gradient"`, `"upward_gradient"`, `"altitude"`, `"slope"`, `"speed"`
`<line_3d_visualization_position_type>`	- Stelt de positie van de 3D-visualisatie in ten opzichte van de track. - String: `"top"`, `"bottom"`, `"top_bottom"`
`<vertical_exaggeration_scale>`	- Vermenigvuldiger om de waarde van het `line_3d_visualization_by_type`-attribuut te schalen. - Float: Standaard: 1.0
`<elevation_meters>`	- Specificeert een vaste hoogte in meters voor `"fixed_height"` in `<line_3d_visualization_by_type>`. - Float: Standaard: `1000`
`<coloring_type>`	- Bepaalt de kleurmethode voor de track. - String: `"solid"`, `"speed"`, `"altitude"`, `"slope"`, `"routeInfo_roadClass`, `"routeInfo_surface"`, `"routeInfo_smoothness"`
`<color_palette>`	- Specificeert het kleurenschema voor de track. - String: `"default"` / door gebruiker gedefinieerde schema's

Example:

<gpx version="1.1" creator="OsmAnd~ 5.0.0" xmlns="https://www.topografix.com/GPX/1/1" xmlns:osmand="https://osmand.net/docs/technical/osmand-file-formats/osmand-gpx" xmlns:gpxtpx="https://www8.garmin.com/xmlschemas/TrackPointExtensionv1.xsd" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://www.topografix.com/GPX/1/1 https://www.topografix.com/GPX/1/1/gpx.xsd">
...
  <extensions>
    <osmand:color>#4e4eff</osmand:color>
    <osmand:width>bold</osmand:width>
    <osmand:show_arrows>true</osmand:show_arrows>
    <osmand:split_type>distance</osmand:split_type>
    <osmand:split_interval>2000.0</osmand:split_interval>
  </extensions>
</gpx>

Tag 'coloring_type'

De <coloring_type>-tag in OsmAnd stelt gebruikers in staat om de trackkleuring aan te passen op basis van specifieke data-attributen, wat een visuele manier biedt om belangrijke informatie langs de track te interpreteren.

Type	Description	Use Case
`<solid>`	De hele track wordt weergegeven met een enkele, effen kleur die is gespecificeerd door de `color`-tag.	Gebruik wanneer een uniforme kleur nodig is voor duidelijke zichtbaarheid.
`<speed>`	De track wordt gekleurd in een verloop op basis van de snelheden bij elk trackpunt (`<trkpt>`). Hogere snelheden worden weergegeven door verschillende kleuren.	Ideaal voor activiteiten zoals fietsen of autorijden om snelheidsveranderingen te visualiseren.
`<altitude>`	De track wordt gekleurd volgens de hoogtegegevens bij elke `<trkpt>`. Er wordt een verloop toegepast dat verschillende hoogtebereiken aangeeft.	Handig voor wandel- of bergroutes om hoogteverschillen te benadrukken.
`<slope>`	De track wordt gekleurd op basis van de helling/daling tussen opeenvolgende trackpunten. Positieve gradiënten duiden op hellingen omhoog, terwijl negatieve gradiënten op hellingen omlaag duiden.	Geschikt voor fietsers of wandelaars die de moeilijkheidsgraad van de track analyseren.
`<routeInfo_roadClass>`	Kleurt de tracksegmenten op basis van de OpenStreetMap (OSM) wegclassificatie (bijv. snelweg, woonstraat).	Helpt bij het onderscheiden van verschillende wegtypes bij het volgen van een route.
`<routeInfo_surface>`	Kleurt de tracksegmenten op basis van het OSM-oppervlaktetype (bijv. verhard, grind, onverhard).	Handig voor het bepalen van de trackcondities tijdens activiteiten zoals off-road rijden.
`<routeInfo_smoothness>`	Kleurt de track volgens de OSM-gladheidsclassificaties, die de ruwheid of gladheid van het pad aangeven (bijv. uitstekend, slecht).	Nuttig voor het evalueren van de begaanbaarheid van de track voor specifieke voertuigen.

GPX tags in UI

GPX extensions tags displayed at the bottom of Track context menu. Both <metadata> and <gpx> <extensions> are listed. Appearance tags are excluded from the listing. Supported since OsmAnd Android 5.0.

Waypointaanpassing

Deze sectie legt uit hoe OsmAnd het aanpassen van waypoints in GPX-bestanden mogelijk maakt door gebruik te maken van iconen, kleuren en groepering.

Waypoint-iconen

De volgende tags bepalen het uiterlijk van waypoint-iconen in OsmAnd:

GPX tag	Default	Purpose
`<icon>`	(none)	Specificeert het icoon voor het waypoint (bijv. `historic_castle`).
`<color>`	`"red"`	Stelt de kleur van het icoon in met een HEX-code (bijv. `#FF0000`) of kleurnaam (bijv. `"blue"`).
`<background>`	`"circle"`	Definieert de achtergrondvorm van het icoon. Mogelijke waarden: `"circle"`, `"square"`, `"octagon"`.

Example:

<wpt lat="52.5163" lon="13.3779">
  <name>Brandenburg Gate</name>
  <extensions>
    <osmand:color>#FF5020</osmand:color>
    <osmand:icon>city_gate</osmand:icon>
    <osmand:background>square</osmand:background>
  </extensions>
</wpt>

Waypointgroepen

Waypoints in OsmAnd kunnen worden gesorteerd in groepen op basis van hun type. Deze groepering stelt de gebruiker in staat om meerdere waypoints onder specifieke categorieën te organiseren, wat de duidelijkheid en leesbaarheid van de kaart verbetert.

Definitie van puntgroep. De <type>-tag binnen het <wpt>-element specificeert de groep van het punt (bijv. "castle", "aqueduct").
Groepsconfiguratie. De <osmand:points_groups>-extensie in het <gpx>-element definieert de instellingen voor elke groep, inclusief de name, color, icon en background voor alle waypoints in die groep.

Example:

<gpx>
  <wpt lat="1.234" lon="5.678">
    <name>Look up to see the water</name>
    <type>aqueduct</type>
  </wpt>
  <wpt lat="5.678" lon="1.234">
    <name>Beware of ghosts</name>
    <type>castle</type>
  </wpt>
  <wpt lat="66.666" lon="66.666">
    <name>The house of Beetlejuice</name>
    <type>castle</type>
  </wpt>
  <extensions>
    <osmand:points_groups>
      <group name="castle" color="#FF0000" icon="historic_castle" background="circle"/>
      <group name="aqueduct" color="#0000FF" icon="bridge_structure_arch" background="circle"/>
    </osmand:points_groups>
  </extensions>
</gpx>

Geavanceerde GPX-functies

Activiteitstype

Vanaf OsmAnd versie 4.9 kunt u uw tracks classificeren op activiteitstype voor verdere analyse en organisatie in mappen.

De lijst met ondersteunde activiteitstypes is beschikbaar in het activities.json-bestand. Elke activiteit wordt geïdentificeerd door zijn unieke ID en opgeslagen binnen de <metadata>-extensies van het GPX-bestand.

Example:

  <metadata>
    <extensions>
      <osmand:activity>off_road_motorcycling_dirt_biking</osmand:activity>
    </extensions>
  </metadata>

HTML in beschrijvingen

HTML-tags kunnen worden gebruikt binnen de <desc>-tags in de <metadata>- of <wpt>-elementen om opgemaakte beschrijvingen voor tracks of waypoints te bieden.

Om conflicten met de XML-syntaxis te vermijden, vervangt u speciale tekens als volgt:

< → <
> → >
& → &

Example:

<metadata>
  <desc>
    &lt;p&gt;
        The first paragraph will be displayed as &lt;b&gt;brief&lt;/b&gt; description.
        HTML tags are stripped in brief descriptions.
    &lt;/p&gt;
    &lt;p&gt;
      &lt;h3&gt;Second paragraph&lt;/h3&gt;
        &lt;b&gt;Hello, world!&lt;/b&gt;&lt;br/&gt;
        &lt;img src="..."/&gt;&lt;br/&gt;
        &lt;a href="..."&gt;url&lt;/a&gt;&lt;br/&gt;
        &lt;table&gt; ... &lt;/table&gt;
    &lt;/p&gt;
  </desc>
</metadata>

Important notes:

OsmAnd verwijdert alle HTML-tags bij het genereren van korte beschrijvingen, waardoor alleen platte tekst overblijft.
U kunt tags zoals <b>, <i>, <p>, <br/>, <a>, <img> en meer gebruiken voor aanpassing.

Link-tag

Gebruik de <link>-tag om URL's te koppelen aan metadata, auteursinformatie of waypoints in OsmAnd GPX-bestanden. Deze tag kan ook een afbeelding weergeven wanneer de URL naar een afbeeldingsbestand verwijst.

Examples (Metadata link with image):

<metadata>
  <link href="https://osmand.net/img/logo.png">
    <text>OsmAnd Logo</text>
  </link>
</metadata>

Examples (Waypoint link with image):

<wpt lat="52.5163" lon="13.3779">
  <link href="https://osmand.net/img/logo.png" />
</wpt>

Sensorgegevenstags

U kunt uw tracks verrijken met gegevens van fitnesssensoren, zoals hartslagmeters of temperatuursensoren. OsmAnd gebruikt het TrackPointExtension-schema van Garmin om deze gegevens op te slaan, waardoor het compatibel is met platforms zoals Strava en Garmin Basecamp.

Supported Sensor Data Tags:

hr - hartslag (in slagen per minuut).
cad - fietscadans (in omwentelingen per minuut).
atemp - omgevingstemperatuur (in graden Celsius).
power - fietsvermogen (in watt).

Example:

<extensions>
  <gpxtpx:TrackPointExtension>
    <gpxtpx:hr>145</gpxtpx:hr>
    <gpxtpx:cad>80</gpxtpx:cad>
    <gpxtpx:atemp>22</gpxtpx:atemp>
    <gpxtpx:power>250</gpxtpx:power>
  </gpxtpx:TrackPointExtension>
</extensions>

Trackpuntgegevens

Elk <trkpt> (trackpunt) in het GPX-bestand kan extra attributen bevatten om gegevens zoals snelheid, koers en hoogte vast te leggen.

Supported attributes:

speed - snelheid op het trackpunt (in meters per seconde).
heading - bewegingsrichting (0-359 graden).
ele - hoogte boven zeeniveau (in meters).
time - tijdstempel voor het trackpunt.

Example:

  <trkpt lat="52.397799" lon="4.575998">
    <ele>203</ele>
    <time>2019-05-08T10:36:43Z</time>
    <hdop>3</hdop>
    <extensions>
      <heading>273</heading>
      <speed>5.02</speed>
    </extensions>
  </trkpt>

Berekende route(s)

In OsmAnd kunt u een route berekenen en alle gegevens opslaan in GPX, zodat later alle navigatiefuncties beschikbaar zijn als u de GPX-navigatie uitvoert. De OsmAnd GPX bevat dan routesegmenten, afslagen, wegnamen, wegtypes, beperkingen, enz. De route kan volledig worden hersteld alsof deze zojuist is berekend, zelfs als de betreffende offline kaarten niet aanwezig zijn.

Een GPX-bestand kan meerdere routes bevatten. Elk daarvan bevindt zich in een specifiek segment onder trkseg / extensions. Een GPX-bestand wordt in deze vorm opgeslagen bij het exporteren van een geconstrueerde route of bij het opslaan van een track die uit meerdere afzonderlijke segmenten bestaat via de functionaliteit Plan een route.

Plan een route voegt ook een (of meerdere, afhankelijk van het aantal afzonderlijke segmenten/tracks) rte-blok toe aan het GPX-bestand, dat de belangrijkste routepunten (rtept) bevat.

GPX-structuur:

<trk>
  <trkseg>
    // List of segment points. The order of the points corresponds to the order and length of the route segments (<route><segment length="x" ... />).
    // The value of the "length" attribute corresponds to the number of points in this segment of the route.
    <trkpt ... ></trkpt>
    <extensions>
      // List of route segments
      <route>
        <segment ... />
      </route>
      // Properties of segments included in the route.
      // This data is taken from offline maps during the initial construction of a route.
      <types>
        <type ... />
      </types>
    </extensions>
  </trkseg>
</trk>

// List of intermediate route points. If there are multiple routes, the order of the rte list matches the order of the route segments.
<rte>
  <rtept ... />
    // For routes built with the "Plan route", the parameters of key points are saved.
    // If rtept is not first and last, before it (with the same idx) trkpt will be with the same data.
    <extensions>
      // Route profile type for next segment (car, bicycle, pedestrian, etc.).
      <profile>...</profile>
      // The index of the point in the gpx segment that corresponds to the first point of the calculated route for this segment.
      // If rtept is not first and last, before it (with the same idx) trkpt will be with the same data.
      <trkpt_idx>...</trkpt_idx>
    </extensions>
  </rtept>
</rte>

Belangrijke eigenschappen:

trkpt_idx of first rtept in trkseg is 0. So, if there are two trksegs, there will be two rtepts with trkpt_idx = 0
trkpt_idx of last rtept in trkseg is equal to number of trkpts in trkseg minus 1. For example, if trkseg has 12 trkpts, trkpt_idx of last rtept should be 11
Neighbouring route segments of are overlapping: the end of previous segment and start of next segment is the one and same trkpt.
There is exception when neighbouring route segments don't overlap (don't share the same trkpt). It happens when there is rtept "between" route segments. End of previous route segment is one trkpt, and start of next route segment is another rtept. But these two trkpts are totally equal by lat, lon and other params.
Route segment overlapping can be detected via length and startTrkptIdx (the latter is used only for convenience of human reading):
- If sum of startTrkptIdx and length of prevous route segment equals startTrkptIdx of next route segment, route segments are not overlapping
- If sum is less by one, then route segments are overlapping
There can be straight route segments. They are marked with id="-1". They can appear in two cases:
- It is multiprofile route, and user selected straight line
- User placed rtept too far away from closest road, so osmand made straight line between rtept and road
trkpts = length - (segments - 1) + (rtepts - 2), where:
- trkpts - amount of trkpts inside trkseg
- length - sum of all lengths of route segments inside trkseg
- segments - amount of route segments inside trkseg
- rtepts - amount of rtepts owned by trkseg

Example:

<gpx version="1.1" creator="OsmAndRouterV2" xmlns="http://www.topografix.com/GPX/1/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.topografix.com/GPX/1/1 http://www.topografix.com/GPX/1/1/gpx.xsd">
  <metadata>
    <name>Fri 06 Nov 2020</name>
  </metadata>
  <trk>
    <name>Fri 06 Nov 2020</name>
    <trkseg>
      <trkpt lat="52.3639849" lon="4.8900533">
        <ele>0.801</ele>
      </trkpt>
      <trkpt lat="52.3636917" lon="4.8922849">
        <ele>0.998</ele>
      </trkpt>
      <trkpt lat="52.3636885" lon="4.892309">
        <ele>1</ele>
      </trkpt>
      <trkpt lat="52.3636426" lon="4.8922902">
        <ele>0.963</ele>
      </trkpt>
      <trkpt lat="52.363564" lon="4.8922607">
        <ele>0.899</ele>
      </trkpt>

      ....

      <extensions>
        <route>
          <segment id="7372058" length="3" segmentTime="178.44" speed="1.11" turnType="C" types="0,1,2,3,4,5,6" names="57" />
          <segment id="334164679" length="5" segmentTime="86.11" speed="1.11" turnType="TR" turnAngle="91.88" types="7,8,0,9,10,11,12,13,6" pointTypes=";;14,15;16,17,18;" names="58" />
          <segment id="334603581" length="6" segmentTime="75.5" speed="1.11" types="19,20,21,7,8,0,22,9,10,11,12,13,23,6" pointTypes=";14;16,24;16,24;14;" names="58" />
          <segment id="446707354" length="3" segmentTime="8.32" speed="1.11" turnType="TSLL" turnAngle="-25.44" types="19,25,21,7,8,22,9,1,11,12,13,6" names="58" />
          ...
        </route>
        <types>
          <type t="lit" v="yes" />
          <type t="oneway" v="yes" />
          <type t="highway" v="unclassified" />
          <type t="surface" v="paving_stones" />
          <type t="maxspeed" v="30" />
          ...
        </types>
      </extensions>
    </trkseg>
  </trk>

  <rte>
    <rtept lat="52.3639945" lon="4.8900532">
      <extensions>
        <profile>pedestrian</profile>
        <trkpt_idx>0</trkpt_idx>
      </extensions>
    </rtept>
    <rtept lat="52.3612797" lon="4.8911677">
      <extensions>
        <profile>pedestrian</profile>
        <trkpt_idx>24</trkpt_idx>
      </extensions>
    </rtept>
    <rtept lat="52.356996" lon="4.8912071">
      <extensions>
        <profile>pedestrian</profile>
        <trkpt_idx>89</trkpt_idx>
      </extensions>
    </rtept>
    <rtept lat="52.3542374" lon="4.8947024">
      <extensions>
        <profile>pedestrian</profile>
        <trkpt_idx>121</trkpt_idx>
      </extensions>
    </rtept>
  </rte>
</gpx>

GPX-collecties in OBF

Met OsmAnd kunt u meerdere GPX-bestanden converteren naar één OBF-bestand. Dit maakt het mogelijk om duizenden GPX-tracks op te slaan in een compact, geoptimaliseerd formaat, terwijl functies zoals speciale kaarticonen, aanpassing van de trackweergave en zoekfunctionaliteit behouden blijven. Dit voorkomt een limiet van grote lokale GPX-bestanden die doorgaans niet meer dan 500.000 punten in totaal kunnen verwerken, hoewel sommige functies van GPX-tracks kunnen ontbreken in vergelijking met het weergeven van een OBF-bestand.

Stappen om GPX naar OBF te converteren:

Log in op OsmAnd Web Map *→ Tracks → Selecteer een map → Menu (⋮) → Downloaden als OBF-collectie
Het resulterende <.obf>-bestand kan worden geïmporteerd in OsmAnd (vereist OsmAnd Android 5.0+).

Stijl van de tracklijn

Pas tracklijnen aan met de volgende tags:

GPX tag	Default	Purpose
`<name>`	(none)	Naam die over de tracklijn wordt weergegeven.
`color`	`red`	Primaire kleur (HEX of tekst).
`colour`, `displaycolor`	(none)	Alternatieve manieren om `color` te overschrijven.
`shield_waycolor`	(none)	Overschrijft de `color` van de tracklijn voor het schild.
`translucent_line_colors`	`no`	Stel in op `yes` voor semi-transparante kleuren.
`width`	`thin`	Lijnbreedte: `"thin"`, `"medium"`, `"bold"`, `"1-24"`, of `"roadstyle"`

Ondersteunde kleuren: black, blue, brown, darkyellow, gray, green, lightblue, lightgreen, orange, purple, red, white, yellow.

Example:

<gpx>
  <metadata>
    <name>
      Track name located in Metadata
    </name>
  </metadata>
  <trk>
    ...
  </trk>
  <extensions>
    <osmand:color>yellow</osmand:color>
    <osmand:width>roadstyle</osmand:width>
    <osmand:translucent_line_colors>yes</osmand:translucent_line_colors>
  </extensions>
</gpx>

Schilden voor tracklijnen

Schilden zijn iconen of symbolen die langs de tracklijn worden weergegeven. OsmAnd ondersteunt OSMC-symboolstijl, die kunnen bestaan uit:

Achtergrondicoon - de hoofdvorm (bijv. cirkel of vierkant).
Voorgrondiconen - tot twee kleinere symbolen die over de achtergrond worden geplaatst.
Tekst - korte beschrijvingen of identificaties, afgeleid van de shield_text- of ref-tags.

Als er geen schildeigenschappen zijn gedefinieerd, gebruikt OsmAnd een automatisch geschaald geel schild voor de track.

Tags voor schilden:

GPX tag	Purpose
`shield_bg`	Definieert het achtergrondicoon voor het schild.
`shield_fg`	Specificeert het eerste voorgrondicoon (bijv. een pijl of stip).
`shield_fg_2`	Specificeert het tweede voorgrondicoon (optioneel).
`shield_text`	Stelt de korte tekst in die over het schild wordt weergegeven (bijv. route-ref).
`shield_textcolor`	Bepaalt de kleur van de schildtekst (optioneel).
`shield_waycolor`	Overschrijft de standaard trackkleur voor de lijn van het schild (optioneel).
`ref`	Wordt gebruikt als fallback-tekst als `shield_text` niet is opgegeven.

Example:

<gpx>
  <trk>
    <name>Sample Route</name>
  </trk>
  <extensions>
    <osmand:shield_text>ABC</osmand:shield_text>
    <osmand:shield_fg>osmc_red_dot</osmand:shield_fg>
    <osmand:shield_bg>osmc_white_bg</osmand:shield_bg>
    <osmand:shield_waycolor>red</osmand:shield_waycolor>
    <osmand:shield_textcolor>black</osmand:shield_textcolor>
  </extensions>
</gpx>

Weergave van waypoints

Waypoint-iconen kunnen worden aangepast met de volgende tags:

GPX tag	Default	Purpose
`icon`	(none)	Specificeert het icoon voor het waypoint (gebruikt standaard OsmAnd waypoint-editor iconen).
`color`	`red`	Stelt de icoonkleur in met een HEX-code (bijv. `#ffaa00`) of een ondersteunde kleurnaam (beperkte opties).
`background`	`circle`	Definieert de vorm van het icoon. Ondersteunde waarden: `circle`, `square`, `octagon`.

Behavior of background shapes:

circle - toont het icoon met een cirkelvormige achtergrond.
square - toont het icoon met een vierkante achtergrond, standaard rood als er geen kleur is opgegeven.
octagon - wordt in OsmAnd behandeld als een cirkelvormige achtergrond.

Ondersteunde kleuren voor background=circle: blue, gray, green, lightblue, lightgreen, orange, purple, yellow.

Enhancements with additional elements:

U kunt opgemaakte beschrijvingen toevoegen aan waypoints met behulp van HTML-code. Hiermee kunt u gestileerde tekst, links of zelfs afbeeldingen opnemen.
Waypoints kunnen gekoppelde afbeeldingen weergeven met Link-als-Afbeelding.

Example:

<wpt lat="3.1415926" lon="42">
  <name>PI</name>
  <extensions>
    <osmand:icon>historic_archaeological_site</osmand:icon>
    <osmand:background>circle</osmand:background>
    <osmand:color>#ffaa00</osmand:color>
  </extensions>
</wpt>

Zoeken op naam en referenties

Tracks en waypoints kunnen worden gevonden met behulp van verschillende GPX-tags.

GPX tag	Location	Purpose
`<name>`	`<metadata>`	De primaire naam van de GPX-track.
`ref`	GPX `<extensions>`	Een korte identificatie, vaak afgeleid van de OSM `ref`-tag.
`shield_text`	GPX `<extensions>`	Tekst die op schilden wordt weergegeven (kan ook worden gebruikt met `ref`).
`name_-_lang`	GPX/WPT `<extensions>`	Gelokaliseerde `name:lang` (bijv. `name_-_en` voor Engels, vervang `:` -> `_-_`)
`<name>`	`<wpt>`	De naam van het waypoint.

Example:

<gpx>
  <metadata>
    <name>Xemxija Heritage Trail</name>
  </metadata>
  <extensions>
    <osmand:ref>XHT</osmand:ref>
  </extensions>
  <wpt lat="35.948477" lon="14.3806796">
    <name>Il-Mighba Rumana</name>
    <extensions>
      <osmand:name_-_en>The Roman Apiary</osmand:name_-_en>
    </extensions>
  </wpt>
</gpx>

Zoeken op activiteitstype

OsmAnd organiseert tracks in OBF-bestanden in Activiteitengroepen en Activiteitstypes. Deze classificaties helpen u bij het filteren van tracks als POI's of bij het maken van op activiteiten gebaseerde zoekfilters.

Hoe activiteitstypes werken:

Activiteitstypes en -groepen worden bepaald met behulp van de "id" en "tags" uit het activities.json-bestand.
OsmAnd gebruikt osmand:activity- of osmand:route-tags om activiteiten in GPX-bestanden te classificeren.

GPX tag	Location	Purpose
`osmand:activity`	`<metadata>`	Hoofdtag van OsmAnd om het activiteitstype (ID) op te slaan.
`osmand:route`	GPX `<extensions>`	Alternatieve OSM-manier om het activiteitstype te definiëren.

Examples of organizing tracks by activity type:

Dit classificeert de track onder de groep Motorrijden met het type Off-Road Motorrijden (Dirt Biking).

<metadata>
  <extensions>
    <osmand:activity>off_road_motorcycling_dirt_biking</osmand:activity>
  </extensions>
</metadata>

Dit organiseert de track onder de groep Fietsen met het type Mountainbiken.

<gpx>
  <extensions>
    <osmand:route>mtb</osmand:route>
  </extensions>
</gpx>

Zoekinformatie-tags

OBF-bestanden genereren en slaan automatisch kritieke trackstatistieken en -analyses op.

OBF tag	Purpose
`distance`	Totale afstand afgelegd door alle tracksegmenten.
`start_ele`, `ele_graph`	Hoogtegegevens uit GPX, verpakt in een compacte binaire array.
`min_ele`, `avg_ele`, `max_ele`	Analyse van minimale, gemiddelde en maximale hoogte.
`diff_ele_up`, `diff_ele_down`	Totaal hoogteverschil omhoog en omlaag over de track.
`max_speed`, `avg_speed`, `min_speed`	Snelheidsanalyse van de track, inclusief maximale, gemiddelde en minimale snelheid.
`time_span`, `time_span_no_gaps`	Totale tijd voor de track, met en zonder rekening te houden met onderbrekingen.
`time_moving`, `time_moving_no_gaps`	Totale bewegingstijd, met en zonder rekening te houden met onderbrekingen.

Interne tags

Sommige GPX-tags worden indirect gebruikt of opgeslagen in OBF-bestanden. Raadpleeg OsmGpxWriteContext.java voor details over de implementatie.

OBF tag	Purpose
`route_id`	Een unieke identificatie voor het GPX-bestand, die kaart- en POI-gegevens koppelt (formaat: `/[A-Z]+[0-9]+/` bijv. `OSM12345`).
`route_type`	Identificatie van de activiteitengroep (`id`) afgeleid van `poi/activities.json`
`route_activity_type`	Identificatie van het activiteitstype (binnen de groep) (`id`) afgeleid van `poi/activities.json`
`name`, `ref`, `description`	Lokaliseerbare en doorzoekbare attributen (`lang="true"` in POI-types)
`filename`	De naam van het oorspronkelijke GPX-bestand dat is gebruikt om deze track te genereren.
`track_color`	Kaartsectie trackkleur afgeleid van `shield_waycolor`, `color`, `colour`, of `displaycolor`
`extensions_extra_tags`	Willekeurige extra tags voor `<gpx><extensions>` in JSON-formaat.
`metadata_extra_tags`	Willekeurige extra tags voor `<metadata><extensions>` in JSON-formaat.
`wpt_extra_tags`	Willekeurige extra tags voor waypoints `<wpt><extensions>` in JSON-formaat.
`route_track_point`	Waypoints uit het GPX-bestand gebruiken dit type in POI-gegevens.
`route_bbox_radius`	Specificeert de standaardradius voor het zoeken naar delen van de track binnen de POI-sectie
`route_shortlink_tiles`	Specificeert een door komma's gescheiden lijst van OSM Shortlink-tegels om het lezen van geometriegegevens te versnellen (optioneel)
`route_segment_index`	Specificeert een volgnummer van het geometriesegment dat aan dit punt is gekoppeld (optioneel)
`route_name`	De routenaam, gebruikt door de interne `searchPoiByName` (verouderd)

Introductie​

Wat maakt OsmAnd GPX uniek?​

Wat leert u in deze gids?​

Overzicht van de GPX-structuur​

GPX-importgedrag​

Trackaanpassing​

Parameters voor trackweergave​

Tag 'coloring_type'​

GPX tags in UI​

Waypointaanpassing​

Waypoint-iconen​

Waypointgroepen​

Geavanceerde GPX-functies​

Activiteitstype​

HTML in beschrijvingen​

Link-tag​

Sensorgegevenstags​

Trackpuntgegevens​

Berekende route(s)​

GPX-structuur:​

Belangrijke eigenschappen:​

Example:​

GPX-collecties in OBF​

Stijl van de tracklijn​

Schilden voor tracklijnen​

Weergave van waypoints​

Zoeken op naam en referenties​

Zoeken op activiteitstype​

Zoekinformatie-tags​

Interne tags​

Introductie

Wat maakt OsmAnd GPX uniek?

Wat leert u in deze gids?

Overzicht van de GPX-structuur

GPX-importgedrag

Trackaanpassing

Parameters voor trackweergave

Tag 'coloring_type'

GPX tags in UI

Waypointaanpassing

Waypoint-iconen

Waypointgroepen

Geavanceerde GPX-functies

Activiteitstype

HTML in beschrijvingen

Link-tag

Sensorgegevenstags

Trackpuntgegevens

Berekende route(s)

GPX-structuur:

Belangrijke eigenschappen:

Example:

GPX-collecties in OBF

Stijl van de tracklijn

Schilden voor tracklijnen

Weergave van waypoints

Zoeken op naam en referenties

Zoeken op activiteitstype

Zoekinformatie-tags

Interne tags