Ga naar hoofdinhoud

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:

  1. Hoe u tracks en waypoints kunt aanpassen met GPX-tags.
  2. Geavanceerde functies zoals HTML-beschrijvingen, sensorgegevens en activiteitstypes.
  3. Hoe u berekende routes kunt exporteren en hun volledige functionaliteit kunt behouden.
  4. 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.

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.

TagnaamBeschrijving / Waarden
<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

Voorbeeld:

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

TypeBeschrijvingGebruiksscenario
<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 de gebruikersinterface

GPX-extensietags worden onderaan het contextmenu van de track weergegeven. Zowel <metadata> als <gpx> <extensions> worden vermeld. Weergavetags worden uit de lijst weggelaten. Ondersteund sinds 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-tagStandaardDoel
<icon>(geen)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".

Voorbeeld:

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

Voorbeeld:

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

Voorbeeld:

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

  • < &lt;
  • > &gt;
  • & &amp;

Voorbeeld:

<metadata>
<desc>
&lt;p&gt;
De eerste paragraaf wordt weergegeven als &lt;b&gt;korte&lt;/b&gt; beschrijving.
HTML-tags worden verwijderd in korte beschrijvingen.
&lt;/p&gt;
&lt;p&gt;
&lt;h3&gt;Tweede paragraaf&lt;/h3&gt;
&lt;b&gt;Hallo, wereld!&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>

Belangrijke opmerkingen:

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

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.

Voorbeelden (Metadatalink met afbeelding):

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

Voorbeelden (Waypointlink met afbeelding):

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

Ondersteunde sensorgegevenstags:

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

Voorbeeld:

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

Ondersteunde attributen:

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

Voorbeeld:

  <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>
// Lijst van segmentpunten. De volgorde van de punten komt overeen met de volgorde en lengte van de routesegmenten (<route><segment length="x" ... />).
// De waarde van het "length"-attribuut komt overeen met het aantal punten in dit segment van de route.
<trkpt ... ></trkpt>
<extensions>
// Lijst van routesegmenten
<route>
<segment ... />
</route>
// Eigenschappen van segmenten die in de route zijn opgenomen.
// Deze gegevens worden overgenomen van offline kaarten tijdens de initiële berekening van een route.
<types>
<type ... />
</types>
</extensions>
</trkseg>
</trk>

// Lijst van tussenliggende routepunten. Als er meerdere routes zijn, komt de volgorde van de rte-lijst overeen met de volgorde van de routesegmenten.
<rte>
<rtept ... />
// Voor routes die zijn gebouwd met "Plan een route", worden de parameters van de belangrijkste punten opgeslagen.
// Als rtept niet het eerste en laatste is, zal er daarvoor (met dezelfde idx) een trkpt zijn met dezelfde gegevens.
<extensions>
// Routeprofieltype voor het volgende segment (auto, fiets, voetganger, enz.).
<profile>...</profile>
// De index van het punt in het gpx-segment dat overeenkomt met het eerste punt van de berekende route voor dit segment.
// Als rtept niet het eerste en laatste is, zal er daarvoor (met dezelfde idx) een trkpt zijn met dezelfde gegevens.
<trkpt_idx>...</trkpt_idx>
</extensions>
</rtept>
</rte>

Belangrijke eigenschappen:

  • trkpt_idx van het eerste rtept in trkseg is 0. Dus, als er twee trksegs zijn, zullen er twee rtepts zijn met trkpt_idx = 0
  • trkpt_idx van het laatste rtept in trkseg is gelijk aan het aantal trkpts in trkseg min 1. Bijvoorbeeld, als trkseg 12 trkpts heeft, moet de trkpt_idx van het laatste rtept 11 zijn.
  • Aangrenzende routesegmenten overlappen: het einde van het vorige segment en het begin van het volgende segment is hetzelfde trkpt.
  • Er is een uitzondering wanneer aangrenzende routesegmenten niet overlappen (niet hetzelfde trkpt delen). Dit gebeurt wanneer er een rtept "tussen" routesegmenten is. Het einde van het vorige routesegment is één trkpt, en het begin van het volgende routesegment is een ander rtept. Maar deze twee trkpts zijn volledig gelijk qua lat, lon en andere parameters.
  • Overlapping van routesegmenten kan worden gedetecteerd via length en startTrkptIdx (de laatste wordt alleen gebruikt voor het gemak van menselijke lezing):
    • Als de som van startTrkptIdx en length van het vorige routesegment gelijk is aan de startTrkptIdx van het volgende routesegment, overlappen de routesegmenten niet.
    • Als de som één minder is, dan overlappen de routesegmenten wel.
  • Er kunnen rechte routesegmenten zijn. Deze zijn gemarkeerd met id="-1". Ze kunnen in twee gevallen verschijnen:
    • Het is een route met meerdere profielen en de gebruiker heeft een rechte lijn geselecteerd.
    • De gebruiker heeft een rtept te ver van de dichtstbijzijnde weg geplaatst, dus OsmAnd heeft een rechte lijn gemaakt tussen het rtept en de weg.
  • trkpts = length - (segments - 1) + (rtepts - 2), waarbij:
    • trkpts - aantal trkpts binnen trkseg
    • length - som van alle lengths van routesegmenten binnen trkseg
    • segments - aantal routesegmenten binnen trkseg
    • rtepts - aantal rtepts die eigendom zijn van trkseg

Voorbeeld:

<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-tagStandaardDoel
<name>(geen)Naam die over de tracklijn wordt weergegeven.
colorredPrimaire kleur (HEX of tekst).
colour, displaycolor(geen)Alternatieve manieren om color te overschrijven.
shield_waycolor(geen)Overschrijft de color van de tracklijn voor het schild.
translucent_line_colorsnoStel in op yes voor semi-transparante kleuren.
widththinLijnbreedte: "thin", "medium", "bold", "1-24", of "roadstyle"

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

Voorbeeld:

<gpx>
<metadata>
<name>
Tracknaam 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 schilden in 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-tagDoel
shield_bgDefinieert het achtergrondicoon voor het schild.
shield_fgSpecificeert het eerste voorgrondicoon (bijv. een pijl of stip).
shield_fg_2Specificeert het tweede voorgrondicoon (optioneel).
shield_textStelt de korte tekst in die over het schild wordt weergegeven (bijv. route-ref).
shield_textcolorBepaalt de kleur van de schildtekst (optioneel).
shield_waycolorOverschrijft de standaard trackkleur voor de lijn van het schild (optioneel).
refWordt gebruikt als fallback-tekst als shield_text niet is opgegeven.

Voorbeeld:

<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-tagStandaardDoel
icon(geen)Specificeert het icoon voor het waypoint (gebruikt standaard OsmAnd waypoint-editor iconen).
colorredStelt de icoonkleur in met een HEX-code (bijv. #ffaa00) of een ondersteunde kleurnaam (beperkte opties).
backgroundcircleDefinieert de vorm van het icoon. Ondersteunde waarden: circle, square, octagon.

Gedrag van background-vormen:

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

Verbeteringen met extra elementen:

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

Voorbeeld:

<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-tagLocatieDoel
<name><metadata>De primaire naam van de GPX-track.
refGPX <extensions>Een korte identificatie, vaak afgeleid van de OSM ref-tag.
shield_textGPX <extensions>Tekst die op schilden wordt weergegeven (kan ook worden gebruikt met ref).
name_-_langGPX/WPT <extensions>Gelokaliseerde name:lang (bijv. name_-_en voor Engels, vervang : -> _-_)
<name><wpt>De naam van het waypoint.

Voorbeeld:

<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-tagLocatieDoel
osmand:activity<metadata>Hoofdtag van OsmAnd om het activiteitstype (ID) op te slaan.
osmand:routeGPX <extensions>Alternatieve OSM-manier om het activiteitstype te definiëren.

Voorbeelden van het organiseren van tracks op activiteitstype:

  1. 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>
  2. 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-tagDoel
distanceTotale afstand afgelegd door alle tracksegmenten.
start_ele, ele_graphHoogtegegevens uit GPX, verpakt in een compacte binaire array.
min_ele, avg_ele, max_eleAnalyse van minimale, gemiddelde en maximale hoogte.
diff_ele_up, diff_ele_downTotaal hoogteverschil omhoog en omlaag over de track.
max_speed, avg_speed, min_speedSnelheidsanalyse van de track, inclusief maximale, gemiddelde en minimale snelheid.
time_span, time_span_no_gapsTotale tijd voor de track, met en zonder rekening te houden met onderbrekingen.
time_moving, time_moving_no_gapsTotale 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-tagDoel
route_idEen unieke identificatie voor het GPX-bestand, die kaart- en POI-gegevens koppelt (formaat: /[A-Z]+[0-9]+/ bijv. OSM12345).
route_typeIdentificatie van de activiteitengroep (id) afgeleid van poi/activities.json
route_activity_typeIdentificatie van het activiteitstype (binnen de groep) (id) afgeleid van poi/activities.json
name, ref, descriptionLokaliseerbare en doorzoekbare attributen (lang="true" in POI-types)
filenameDe naam van het oorspronkelijke GPX-bestand dat is gebruikt om deze track te genereren.
track_colorKaartsectie trackkleur afgeleid van shield_waycolor, color, colour, of displaycolor
extensions_extra_tagsWillekeurige extra tags voor <gpx><extensions> in JSON-formaat.
metadata_extra_tagsWillekeurige extra tags voor <metadata><extensions> in JSON-formaat.
wpt_extra_tagsWillekeurige extra tags voor waypoints <wpt><extensions> in JSON-formaat.
route_track_pointWaypoints uit het GPX-bestand gebruiken dit type in POI-gegevens.
route_bbox_radiusSpecificeert de standaardradius voor het zoeken naar delen van de track binnen de POI-sectie
route_shortlink_tilesSpecificeert een door komma's gescheiden lijst van OSM Shortlink-tegels om het lezen van geometriegegevens te versnellen (optioneel)
route_segment_indexSpecificeert een volgnummer van het geometriesegment dat aan dit punt is gekoppeld (optioneel)
route_nameDe routenaam, gebruikt door de interne searchPoiByName (verouderd)