GPX di OsmAnd

Introduzione

GPX (GPS Exchange Format) è uno standard ampiamente utilizzato basato su XML per la memorizzazione di dati GPS, inclusi tracce, percorsi e waypoint. OsmAnd supporta il formato GPX per l'importazione, l'esportazione e la personalizzazione dei dati GPS per la navigazione, consentendo sia agli utenti principianti che a quelli avanzati di ottimizzare la loro esperienza.

Cosa rende unico il GPX di OsmAnd?

OsmAnd estende il formato standard GPX 1.1 introducendo il proprio namespace XML personalizzato osmand:. Questo namespace consente di memorizzare dati aggiuntivi come:

• Impostazioni visive della traccia (colore, larghezza, frecce).
• Raggruppamento e icone dei waypoint.
• Attributi dettagliati del percorso, inclusi percorsi calcolati e tipi di attività.

Cosa imparerai in questa guida?

Questo articolo fornisce una panoramica completa della struttura dei file GPX e delle funzionalità in OsmAnd. Imparerai:

1. Come personalizzare tracce e waypoint utilizzando i tag GPX.
2. Funzionalità avanzate come descrizioni HTML, dati dei sensori e tipi di attività.
3. Come esportare percorsi calcolati e preservarne la piena funzionalità.
4. Convertire file GPX in formato OBF per uno storage ottimizzato e capacità di ricerca avanzate.

Panoramica della struttura GPX

I file GPX in OsmAnd organizzano i dati gerarchicamente nei seguenti elementi:

• <gpx> - l'elemento radice del file.
• <trk> - rappresenta le tracce, che contengono:
  • <trkseg> - segmenti della traccia, che sono ulteriormente suddivisi in <trkpt> (punti della traccia).
• <rte> - rappresenta i percorsi, inclusi waypoint e punti chiave.
• <wpt> - rappresenta i singoli waypoint.

Personalizzazione della traccia

Parametri di aspetto della traccia

Questa sezione descrive come OsmAnd visualizza le tracce sulla mappa e le opzioni di personalizzazione disponibili per regolarne l'aspetto. I parametri descritti di seguito vengono applicati all'interno del tag <gpx> e influenzano tutte le tracce incluse in un file GPX.

Nome del tag	Descrizione / Valori
<color>	- Definisce il colore della linea della traccia sulla mappa. - Stringa: Codice colore HEX #RRGGBB o #AARRGGBB
<width>	- Specifica la larghezza della linea della traccia. - Stringa: “thin”, “medium", “bold” (definito dall'attributo “currentTrackWidth”), o intero (1-24)
<show_arrows>	- Abilita o disabilita le frecce di direzione lungo la traccia. - Bool: "true" / "false"
<show_start_finish>	- Mostra o nasconde i marcatori per l'inizio e la fine della traccia. - Bool: "true" / "false"
<split_type>	- Specifica il tipo di segmentazione per la traccia. - Stringa: "no_split", "distance", "time"
<split_interval>	- Imposta l'intervallo per la segmentazione della traccia in base al tipo selezionato. - Double: Intero (metri per "distance", secondi per "time")
<line_3d_visualization_by_type>	- Specifica il tipo di visualizzazione 3D per la traccia. - Stringa: "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>	- Definisce il tipo di colore della parete per la visualizzazione 3D. - Stringa: "none", "solid", "downward_gradient", "upward_gradient", "altitude", "slope", "speed"
<line_3d_visualization_position_type>	- Imposta la posizione della visualizzazione 3D rispetto alla traccia. - Stringa: "top", "bottom", "top_bottom"
<vertical_exaggeration_scale>	- Moltiplicatore per scalare il valore dell'attributo line_3d_visualization_by_type. - Float: Predefinito: 1.0
<elevation_meters>	- Specifica un'elevazione fissa in metri per "fixed_height" in <line_3d_visualization_by_type>. - Float: Predefinito: 1000
<coloring_type>	- Determina il metodo di colorazione per la traccia. - Stringa: "solid", "speed", "altitude", "slope", "routeInfo_roadClass, "routeInfo_surface", "routeInfo_smoothness"
<color_palette>	- Specifica lo schema di colori per la traccia. - Stringa: "default" / schemi definiti dall'utente

Esempio:

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

Il tag <coloring_type> in OsmAnd consente agli utenti di personalizzare la colorazione della traccia in base a specifici attributi dei dati, fornendo un modo visivo per interpretare le informazioni chiave lungo la traccia.

Tipo	Descrizione	Caso d'uso
<solid>	L'intera traccia viene visualizzata con un unico colore solido specificato dal tag color.	Utilizzare quando è necessario un colore uniforme per una chiara visibilità.
<speed>	La traccia è colorata con un gradiente basato sui valori di velocità in ogni punto della traccia (<trkpt>). Le velocità più elevate sono rappresentate da colori distinti.	Ideale per attività come il ciclismo o la guida per visualizzare i cambiamenti di velocità.
<altitude>	La traccia è colorata in base ai dati di elevazione in ogni <trkpt>. Viene applicato un gradiente che indica diversi intervalli di altitudine.	Utile per escursioni o percorsi di montagna per evidenziare i cambiamenti di altitudine.
<slope>	La traccia è colorata in base alla pendenza/discesa tra punti di traccia consecutivi. I gradienti positivi indicano pendenze in salita, mentre i gradienti negativi indicano discese.	Adatto a ciclisti o escursionisti che analizzano la difficoltà della traccia.
<routeInfo_roadClass>	Colora i segmenti della traccia in base alla classificazione stradale di OpenStreetMap (OSM) (es. autostrada, strada residenziale).	Aiuta a distinguere tra diversi tipi di strada quando si segue un percorso.
<routeInfo_surface>	Colora i segmenti della traccia in base al tipo di superficie OSM (es. asfaltata, ghiaia, terra).	Utile per determinare le condizioni della traccia durante attività come il fuoristrada.
<routeInfo_smoothness>	Colora la traccia in base alle valutazioni di scorrevolezza di OSM, indicando la ruvidità o la levigatezza del percorso (es. eccellente, cattivo).	Utile per valutare la navigabilità della traccia per veicoli specifici.

Tag GPX nell'interfaccia utente

I tag delle estensioni GPX vengono visualizzati nella parte inferiore del menu contestuale della traccia. Vengono elencate sia le <extensions> di <metadata> che quelle di <gpx>. I tag di aspetto sono esclusi dall'elenco. Supportato da OsmAnd Android 5.0.

Personalizzazione dei waypoint

Questa sezione spiega come OsmAnd consente la personalizzazione dei waypoint nei file GPX utilizzando icone, colori e raggruppamenti.

Icone dei waypoint

I seguenti tag controllano l'aspetto delle icone dei waypoint in OsmAnd:

Tag GPX	Predefinito	Scopo
<icon>	(nessuno)	Specifica l'icona per il waypoint (es. historic_castle).
<color>	"red"	Imposta il colore dell'icona utilizzando un codice HEX (es. #FF0000) o un nome di colore (es. "blue").
<background>	"circle"	Definisce la forma dello sfondo dell'icona. Valori possibili: "circle", "square", "octagon".

Esempio:

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

Gruppi di waypoint

I waypoint in OsmAnd possono essere ordinati in gruppi in base al loro tipo. Questo raggruppamento consente all'utente di organizzare più waypoint in categorie specifiche, migliorando la chiarezza e la leggibilità della mappa.

• Definizione del gruppo di punti. Il tag <type> all'interno dell'elemento <wpt> specifica il gruppo del punto (es. "castle", "aqueduct").
• Configurazione del gruppo. L'estensione <osmand:points_groups> nell'elemento <gpx> definisce le impostazioni per ogni gruppo, inclusi name, color, icon e background per tutti i waypoint di quel gruppo.

Esempio:

<gpx>
  <wpt lat="1.234" lon="5.678">
    <name>Guarda in alto per vedere l'acqua</name>
    <type>aqueduct</type>
  </wpt>
  <wpt lat="5.678" lon="1.234">
    <name>Attenzione ai fantasmi</name>
    <type>castle</type>
  </wpt>
  <wpt lat="66.666" lon="66.666">
    <name>La casa di 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>

Funzionalità GPX avanzate

Tipo di attività

A partire dalla versione 4.9 di OsmAnd, è possibile classificare le tracce per tipo di attività per ulteriori analisi e organizzazione in cartelle.

L'elenco dei tipi di attività supportati è disponibile nel file activities.json. Ogni attività è identificata dal suo ID univoco e memorizzata all'interno delle estensioni <metadata> del file GPX.

Esempio:

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

HTML nelle descrizioni

I tag HTML possono essere utilizzati all'interno dei tag <desc> negli elementi <metadata> o <wpt> per fornire descrizioni formattate per tracce o waypoint.

Per evitare conflitti con la sintassi XML, sostituire i caratteri speciali come segue:

• < → <
• > → >
• & → &

Esempio:

<metadata>
  <desc>
    &lt;p&gt;
        Il primo paragrafo sarà visualizzato come descrizione &lt;b&gt;breve&lt;/b&gt;.
        I tag HTML vengono rimossi nelle descrizioni brevi.
    &lt;/p&gt;
    &lt;p&gt;
      &lt;h3&gt;Secondo paragrafo&lt;/h3&gt;
        &lt;b&gt;Ciao, mondo!&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>

Note importanti:

• OsmAnd rimuove tutti i tag HTML quando genera descrizioni brevi, lasciando testo semplice.
• È possibile utilizzare tag come <b>, <i>, <p>, <br/>, <a>, <img> e altri per la personalizzazione.

Tag Link

Utilizzare il tag <link> per associare URL a metadati, informazioni sull'autore o waypoint nei file GPX di OsmAnd. Questo tag può anche visualizzare un'immagine quando l'URL punta a un file di immagine.

Esempi (link metadati con immagine):

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

Esempi (link waypoint con immagine):

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

Tag dei dati dei sensori

È possibile arricchire le tracce con dati provenienti da sensori fitness, come cardiofrequenzimetri o sensori di temperatura. OsmAnd utilizza lo schema TrackPointExtension di Garmin per memorizzare questi dati, rendendoli compatibili con piattaforme come Strava e Garmin Basecamp.

Tag dei dati dei sensori supportati:

• hr - frequenza cardiaca (in battiti al minuto).
• cad - cadenza della bicicletta (in rivoluzioni al minuto).
• atemp - temperatura ambiente (in gradi Celsius).
• power - potenza della bicicletta (in watt).

Esempio:

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

Dettagli dei punti della traccia

Ogni <trkpt> (punto della traccia) nel file GPX può includere attributi aggiuntivi per catturare dati come velocità, direzione ed elevazione.

Attributi supportati:

• speed - velocità nel punto della traccia (in metri al secondo).
• heading - direzione del movimento (0-359 gradi).
• ele - altitudine sul livello del mare (in metri).
• time - timestamp per il punto della traccia.

Esempio:

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

Percorso/i calcolato/i

In OsmAnd è possibile calcolare un percorso e salvare tutti i dati in GPX, in modo che in seguito tutte le funzionalità di navigazione siano disponibili come navigazione GPX in esecuzione. Quindi, il gpx di OsmAnd conterrà segmenti di percorso, svolte, nomi di strade, tipi di strade, restrizioni, ecc. Il percorso può essere completamente ripristinato come se fosse appena stato costruito, anche in assenza delle rispettive mappe offline.

Un file gpx può contenere diversi percorsi. Ognuno di essi è contenuto in un segmento specifico sotto trkseg / extensions. Un file gpx viene salvato in questa forma quando si esporta un percorso costruito o quando si salva una traccia che consiste di più segmenti separati tramite la funzionalità Pianifica un percorso.

Pianifica un percorso aggiunge anche uno (o più, in base al numero di segmenti/tracce separati contenuti) blocchi rte al file gpx, contenenti i punti chiave del percorso (rtept).

Struttura Gpx:

<trk>
  <trkseg>
    // Elenco dei punti del segmento. L'ordine dei punti corrisponde all'ordine e alla lunghezza dei segmenti del percorso (<route><segment length="x" ... />).
    // Il valore dell'attributo "length" corrisponde al numero di punti in questo segmento del percorso.
    <trkpt ... ></trkpt>
    <extensions>
      // Elenco dei segmenti del percorso
      <route>
        <segment ... />
      </route>
      // Proprietà dei segmenti inclusi nel percorso.
      // Questi dati sono presi dalle mappe offline durante la costruzione iniziale di un percorso.
      <types>
        <type ... />
      </types>
    </extensions>
  </trkseg>
</trk>

// Elenco dei punti intermedi del percorso. Se ci sono più percorsi, l'ordine dell'elenco rte corrisponde all'ordine dei segmenti del percorso.
<rte>
  <rtept ... />
    // Per i percorsi costruiti con "Pianifica percorso", vengono salvati i parametri dei punti chiave.
    // Se rtept non è il primo e l'ultimo, prima di esso (con lo stesso idx) ci sarà un trkpt con gli stessi dati.
    <extensions>
      // Tipo di profilo del percorso per il segmento successivo (auto, bicicletta, pedone, ecc.).
      <profile>...</profile>
      // L'indice del punto nel segmento gpx che corrisponde al primo punto del percorso calcolato per questo segmento.
      // Se rtept non è il primo e l'ultimo, prima di esso (con lo stesso idx) ci sarà un trkpt con gli stessi dati.
      <trkpt_idx>...</trkpt_idx>
    </extensions>
  </rtept>
</rte>

Proprietà importanti:

• trkpt_idx del primo rtept in trkseg è 0. Quindi, se ci sono due trkseg, ci saranno due rtept con trkpt_idx = 0
• trkpt_idx dell'ultimo rtept in trkseg è uguale al numero di trkpt in trkseg meno 1. Ad esempio, se trkseg ha 12 trkpt, trkpt_idx dell'ultimo rtept dovrebbe essere 11
• I segmenti di percorso vicini si sovrappongono: la fine del segmento precedente e l'inizio del segmento successivo sono lo stesso trkpt.
• C'è un'eccezione quando i segmenti di percorso vicini non si sovrappongono (non condividono lo stesso trkpt). Succede quando c'è un rtept "tra" i segmenti di percorso. La fine del segmento di percorso precedente è un trkpt, e l'inizio del segmento di percorso successivo è un altro rtept. Ma questi due trkpt sono totalmente uguali per lat, lon e altri parametri.
• La sovrapposizione dei segmenti di percorso può essere rilevata tramite length e startTrkptIdx (quest'ultimo è usato solo per comodità di lettura umana):
  • Se la somma di startTrkptIdx e length del segmento di percorso precedente è uguale a startTrkptIdx del segmento di percorso successivo, i segmenti di percorso non si sovrappongono
  • Se la somma è inferiore di uno, allora i segmenti di percorso si sovrappongono
• Possono esserci segmenti di percorso rettilinei. Sono contrassegnati con id="-1". Possono apparire in due casi:
  • È un percorso multiprofilo e l'utente ha selezionato una linea retta
  • L'utente ha posizionato un rtept troppo lontano dalla strada più vicina, quindi osmand ha creato una linea retta tra rtept e la strada
• trkpts = length - (segments - 1) + (rtepts - 2), dove:
  • trkpts - quantità di trkpt all'interno di trkseg
  • length - somma di tutte le length dei segmenti di percorso all'interno di trkseg
  • segments - quantità di segmenti di percorso all'interno di trkseg
  • rtepts - quantità di rtept posseduti da trkseg

Esempio:

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

Raccolte GPX in OBF

OsmAnd consente di convertire più file GPX in un unico file OBF. Ciò consente di archiviare migliaia di tracce GPX in un formato compatto e ottimizzato, mantenendo al contempo funzionalità come icone speciali sulla mappa, personalizzazione dell'aspetto della traccia e funzionalità di ricerca. Questo evita un limite dei file GPX locali di grandi dimensioni che in genere non possono gestire più di 500.000 punti in totale, tuttavia alcune funzionalità delle tracce GPX potrebbero mancare rispetto alla visualizzazione del file OBF.

Passaggi per convertire GPX in OBF:

• Accedi a OsmAnd Web Map *→ Tracce → Seleziona una cartella → Menu (⋮) → Scarica come raccolta OBF

• Il file <.obf> risultante può essere importato in OsmAnd (richiede OsmAnd Android 5.0+).

Stile della linea della traccia

Personalizza le linee della traccia con i seguenti tag:

Tag GPX	Predefinito	Scopo
<name>	(nessuno)	Nome visualizzato sopra la linea della traccia.
color	red	Colore primario (HEX o testo).
colour, displaycolor	(nessuno)	Modi alternativi per sovrascrivere color.
shield_waycolor	(nessuno)	Sovrascrittura per il color della linea della traccia con simbolo.
translucent_line_colors	no	Impostare su yes per colori semitrasparenti.
width	thin	Larghezza della linea: "thin", "medium", "bold", "1-24", o "roadstyle"

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

Esempio:

<gpx>
  <metadata>
    <name>
      Nome della traccia situato nei Metadati
    </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>

Simboli della linea della traccia

I simboli sono icone o simboli visualizzati lungo la linea della traccia. OsmAnd supporta i simboli in stile OSMC-symbol-style, che possono includere:

• Icona di sfondo - la forma principale (es. cerchio o quadrato).
• Icone in primo piano - fino a due simboli più piccoli sovrapposti allo sfondo.
• Testo - brevi descrizioni o identificatori, derivati dai tag shield_text o ref.

Se non vengono definite proprietà per il simbolo, OsmAnd utilizza un simbolo giallo di dimensioni automatiche per la traccia.

Tag per i simboli:

Tag GPX	Scopo
shield_bg	Definisce l'icona di sfondo per il simbolo.
shield_fg	Specifica la prima icona in primo piano (es. una freccia o un punto).
shield_fg_2	Specifica la seconda icona in primo piano (opzionale).
shield_text	Imposta il testo breve da visualizzare sopra il simbolo (es. rif. percorso).
shield_textcolor	Determina il colore del testo del simbolo (opzionale).
shield_waycolor	Sovrascrive il colore standard della traccia per la linea del simbolo (opzionale).
ref	Utilizzato come testo di riserva se shield_text non è fornito.

Esempio:

<gpx>
  <trk>
    <name>Percorso di esempio</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>

Visualizzazione dei waypoint

Le icone dei waypoint possono essere personalizzate con i seguenti tag:

Tag GPX	Predefinito	Scopo
icon	(nessuno)	Specifica l'icona per il waypoint (utilizza le icone standard dell'editor di waypoint di OsmAnd).
color	red	Imposta il colore dell'icona utilizzando un codice HEX (es. #ffaa00) o un nome di colore supportato (opzioni limitate).
background	circle	Definisce la forma dell'icona. Valori supportati: circle, square, octagon.

Comportamento delle forme di background:

• circle - visualizza l'icona con uno sfondo circolare.
• square - visualizza l'icona con uno sfondo quadrato, con il rosso come colore predefinito se non specificato.
• octagon - trattato come uno sfondo circolare in OsmAnd.

Colori supportati per background=circle: blue, gray, green, lightblue, lightgreen, orange, purple, yellow.

Miglioramenti con elementi aggiuntivi:

• È possibile aggiungere descrizioni formattate ai waypoint utilizzando codice HTML. Ciò consente di includere testo stilizzato, link o persino immagini.
• I waypoint possono visualizzare immagini collegate utilizzando Link come immagine.

Esempio:

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

Ricerca per nome e riferimenti

Tracce e waypoint possono essere localizzati utilizzando una varietà di tag GPX.

Tag GPX	Posizione	Scopo
<name>	<metadata>	Il nome principale della traccia GPX.
ref	<extensions> GPX	Un identificatore breve, spesso derivato dal tag OSM ref.
shield_text	<extensions> GPX	Testo visualizzato sui simboli (può essere utilizzato anche con ref).
name_-_lang	<extensions> GPX/WPT	name:lang localizzato (es. name_-_en per l'inglese, sostituire : -> _-_)
<name>	<wpt>	Il nome del waypoint.

Esempio:

<gpx>
  <metadata>
    <name>Sentiero del patrimonio di Xemxija</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>L'apiario romano</osmand:name_-_en>
    </extensions>
  </wpt>
</gpx>

Ricerca per tipo di attività

OsmAnd organizza le tracce nei file OBF in Gruppi di attività e Tipi di attività. Queste classificazioni aiutano a filtrare le tracce come PDI o a creare filtri di ricerca basati sull'attività.

Come funzionano i tipi di attività:

• I tipi e i gruppi di attività sono determinati utilizzando "id" e "tags" dal file activities.json.
• OsmAnd utilizza i tag osmand:activity o osmand:route per classificare le attività nei file GPX.

Tag GPX	Posizione	Scopo
osmand:activity	<metadata>	Tag principale di OsmAnd per memorizzare il tipo di attività (ID).
osmand:route	<extensions> GPX	Modo alternativo OSM per definire il tipo di attività.

Esempi di organizzazione delle tracce per tipo di attività:

1. Questo classificherà la traccia nel gruppo Motociclismo con il tipo Motociclismo fuoristrada (Dirt Biking).

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

2. Questo organizzerà la traccia nel gruppo Ciclismo con il tipo Mountain Biking.

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

Tag di informazioni per la ricerca

I file OBF generano e memorizzano automaticamente statistiche e analisi critiche della traccia.

Tag OBF	Scopo
distance	Distanza totale coperta da tutti i segmenti della traccia.
start_ele, ele_graph	Dati di elevazione da GPX, racchiusi in un array binario compatto.
min_ele, avg_ele, max_ele	Analisi dell'elevazione minima, media e massima.
diff_ele_up, diff_ele_down	Dislivello totale in salita e in discesa lungo la traccia.
max_speed, avg_speed, min_speed	Analisi della velocità della traccia, inclusa la velocità massima, media e minima.
time_span, time_span_no_gaps	Tempo totale per la traccia, con e senza tenere conto delle pause.
time_moving, time_moving_no_gaps	Tempo totale di movimento, con e senza tenere conto delle pause.

Tag interni

Alcuni tag GPX sono utilizzati o memorizzati indirettamente nei file OBF. Fare riferimento a OsmGpxWriteContext.java per i dettagli sull'implementazione.

Tag OBF	Scopo
route_id	Un identificatore univoco per il file GPX, che collega i dati della mappa e dei PDI (formato: /[A-Z]+[0-9]+/ es. OSM12345).
route_type	Identificatore del gruppo di attività (id) derivato da poi/activities.json
route_activity_type	Identificatore del tipo di attività (all'interno del gruppo) (id) derivato da poi/activities.json
name, ref, description	Attributi localizzabili e ricercabili (lang="true" nei tipi di PDI)
filename	Il nome del file GPX originale utilizzato per generare questa traccia.
track_color	Colore della traccia nella sezione mappa derivato da shield_waycolor, color, colour, o displaycolor
extensions_extra_tags	Tag extra arbitrari per <gpx><extensions> in formato JSON.
metadata_extra_tags	Tag extra arbitrari per <metadata><extensions> in formato JSON.
wpt_extra_tags	Tag extra arbitrari per i waypoint <wpt><extensions> in formato JSON.
route_track_point	I waypoint dal file GPX utilizzano questo tipo nei dati PDI.
route_bbox_radius	Specifica il raggio predefinito per la ricerca di parti della traccia all'interno della sezione PDI
route_shortlink_tiles	Specifica un elenco separato da virgole di tessere OSM Shortlink per accelerare la lettura dei dati geometrici (opzionale)
route_segment_index	Specifica un numero ordinale del segmento geometrico che è collegato a questo punto (opzionale)
route_name	Il nome del percorso, utilizzato da searchPoiByName interno (deprecato)