GPX w OsmAnd

Wprowadzenie

GPX (GPS Exchange Format) to szeroko stosowany standard oparty na XML do przechowywania danych GPS, w tym śladów, tras i punktów trasy. OsmAnd obsługuje format GPX do importowania, eksportowania i dostosowywania danych GPS do nawigacji, umożliwiając zarówno początkującym, jak i zaawansowanym użytkownikom optymalizację ich doświadczeń.

Co wyróżnia GPX w OsmAnd?

OsmAnd rozszerza standardowy format GPX 1.1, wprowadzając własną, niestandardową przestrzeń nazw XML osmand:. Ta przestrzeń nazw umożliwia przechowywanie dodatkowych danych, takich jak:

Ustawienia wizualne śladu (kolor, szerokość, strzałki).
Grupowanie punktów trasy i ikony.
Szczegółowe atrybuty trasy, w tym obliczone trasy i typy aktywności.

Czego dowiesz się z tego przewodnika?

Ten artykuł zawiera kompleksowy przegląd struktury plików GPX i funkcji w OsmAnd. Dowiesz się:

Jak dostosowywać ślady i punkty trasy za pomocą tagów GPX.
Zaawansowane funkcje, takie jak opisy HTML, dane z czujników i typy aktywności.
Jak eksportować obliczone trasy i zachować ich pełną funkcjonalność.
Konwertowanie plików GPX do formatu OBF w celu zoptymalizowanego przechowywania i zaawansowanych możliwości wyszukiwania.

Przegląd struktury GPX

Pliki GPX w OsmAnd organizują dane hierarchicznie w następujące elementy:

<gpx> - element główny pliku.
<trk> - reprezentuje ślady, które zawierają:
- <trkseg> - segmenty śladu, które są dalej podzielone na <trkpt> (punkty śladu).
<rte> - reprezentuje trasy, w tym punkty trasy i punkty kluczowe.
<wpt> - reprezentuje pojedyncze punkty trasy.

Zachowanie importu GPX

Podczas importowania pliku GPX OsmAnd tworzy pojedynczy obiekt śladu na podstawie pliku:

Nazwa importowanego śladu jest pobierana z nazwy pliku GPX. Element <name> wewnątrz <trk> nie jest używany jako główna nazwa śladu podczas importu.
Jeśli plik GPX zawiera wiele elementów <trk>, OsmAnd importuje je jako segmenty tego samego śladu. W takim przypadku wartości <name> mogą być używane jako etykiety dla odpowiednich segmentów w obrębie śladu.

Dostosowywanie śladu

Parametry wyglądu śladu

W tej sekcji opisano, jak OsmAnd wyświetla ślady na mapie oraz dostępne opcje dostosowywania ich wyglądu. Opisane poniżej parametry są stosowane wewnątrz tagu <gpx> i wpływają na wszystkie ślady zawarte w pliku GPX.

Nazwa tagu	Opis / Wartości
`<color>`	- Definiuje kolor linii śladu na mapie. - Ciąg znaków: Kod koloru HEX `#RRGGBB` lub `#AARRGGBB`
`<width>`	- Określa szerokość linii śladu. - Ciąg znaków: `„thin”`, `„medium"`, `„bold”` (zdefiniowane przez atrybut „currentTrackWidth”) lub liczba całkowita (1-24)
`<show_arrows>`	- Włącza lub wyłącza strzałki kierunku wzdłuż śladu. - Wartość logiczna: `"true"` / `"false"`
`<show_start_finish>`	- Pokazuje lub ukrywa znaczniki początku i końca śladu. - Wartość logiczna: `"true"` / `"false"`
`<split_type>`	- Określa typ segmentacji śladu. - Ciąg znaków: `"no_split"`, `"distance"`, `"time"`
`<split_interval>`	- Ustawia interwał segmentacji śladu w oparciu o wybrany typ. - Liczba zmiennoprzecinkowa: Liczba całkowita (metry dla `"distance"`, sekundy dla `"time"`)
`<line_3d_visualization_by_type>`	- Określa typ wizualizacji 3D dla śladu. - Ciąg znaków: `"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>`	- Definiuje typ koloru ściany dla wizualizacji 3D. - Ciąg znaków: `"none"`, `"solid"`, `"downward_gradient"`, `"upward_gradient"`, `"altitude"`, `"slope"`, `"speed"`
`<line_3d_visualization_position_type>`	- Ustawia pozycję wizualizacji 3D względem śladu. - Ciąg znaków: `"top"`, `"bottom"`, `"top_bottom"`
`<vertical_exaggeration_scale>`	- Mnożnik do skalowania wartości atrybutu `line_3d_visualization_by_type`. - Liczba zmiennoprzecinkowa: Domyślnie: 1.0
`<elevation_meters>`	- Określa stałą wysokość w metrach dla `"fixed_height"` w `<line_3d_visualization_by_type>`. - Liczba zmiennoprzecinkowa: Domyślnie: `1000`
`<coloring_type>`	- Określa metodę kolorowania śladu. - Ciąg znaków: `"solid"`, `"speed"`, `"altitude"`, `"slope"`, `"routeInfo_roadClass`, `"routeInfo_surface"`, `"routeInfo_smoothness"`
`<color_palette>`	- Określa schemat kolorów dla śladu. - Ciąg znaków: `"default"` / schematy zdefiniowane przez użytkownika

Przykład:

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

Tag <coloring_type> w OsmAnd pozwala użytkownikom dostosować kolorowanie śladu w oparciu o określone atrybuty danych, zapewniając wizualny sposób interpretacji kluczowych informacji wzdłuż śladu.

Typ	Opis	Przypadek użycia
`<solid>`	Cały ślad jest wyświetlany w jednym, jednolitym kolorze określonym przez tag `color`.	Używaj, gdy jednolity kolor jest potrzebny dla dobrej widoczności.
`<speed>`	Ślad jest kolorowany gradientem na podstawie wartości prędkości w każdym punkcie śladu (`<trkpt>`). Wyższe prędkości są reprezentowane przez odrębne kolory.	Idealne do aktywności takich jak jazda na rowerze lub samochodem, aby zwizualizować zmiany prędkości.
`<altitude>`	Ślad jest kolorowany zgodnie z danymi o wysokości w każdym `<trkpt>`. Stosowany jest gradient, wskazujący różne zakresy wysokości.	Przydatne na szlakach pieszych lub górskich do podkreślenia zmian wysokości.
`<slope>`	Ślad jest kolorowany na podstawie nachylenia/spadku między kolejnymi punktami śladu. Dodatnie gradienty wskazują podjazdy, a ujemne zjazdy.	Odpowiednie dla rowerzystów lub turystów pieszych analizujących trudność trasy.
`<routeInfo_roadClass>`	Koloruje segmenty śladu na podstawie klasyfikacji dróg OpenStreetMap (OSM) (np. autostrada, ulica osiedlowa).	Pomaga rozróżnić różne typy dróg podczas podążania trasą.
`<routeInfo_surface>`	Koloruje segmenty śladu na podstawie typu nawierzchni OSM (np. utwardzona, żwirowa, gruntowa).	Przydatne do określania warunków na trasie podczas aktywności takich jak jazda terenowa.
`<routeInfo_smoothness>`	Koloruje ślad zgodnie z ocenami gładkości OSM, wskazując na chropowatość lub gładkość ścieżki (np. doskonała, zła).	Pomocne przy ocenie przejezdności trasy dla określonych pojazdów.

Tagi GPX w interfejsie użytkownika

Tagi rozszerzeń GPX wyświetlane na dole menu kontekstowego śladu. Wyświetlane są zarówno rozszerzenia <metadata>, jak i <gpx> <extensions>. Tagi wyglądu są wykluczone z listy. Obsługiwane od OsmAnd na Androida 5.0.

Dostosowywanie punktów trasy

Ta sekcja wyjaśnia, w jaki sposób OsmAnd pozwala na dostosowywanie punktów trasy w plikach GPX za pomocą ikon, kolorów i grupowania.

Ikony punktów trasy

Poniższe tagi kontrolują wygląd ikon punktów trasy w OsmAnd:

Tag GPX	Domyślnie	Cel
`<icon>`	(brak)	Określa ikonę dla punktu trasy (np. `historic_castle`).
`<color>`	`"red"`	Ustawia kolor ikony za pomocą kodu HEX (np. `#FF0000`) lub nazwy koloru (np. `"blue"`).
`<background>`	`"circle"`	Definiuje kształt tła ikony. Możliwe wartości: `"circle"`, `"square"`, `"octagon"`.

Przykład:

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

Grupy punktów trasy

Punkty trasy w OsmAnd mogą być sortowane w grupy na podstawie ich typu. To grupowanie pozwala użytkownikowi organizować wiele punktów trasy w określonych kategoriach, poprawiając przejrzystość i czytelność mapy.

Definicja grupy punktów. Tag <type> wewnątrz elementu <wpt> określa grupę punktu (np. "castle", "aqueduct").
Konfiguracja grupy. Rozszerzenie <osmand:points_groups> w elemencie <gpx> definiuje ustawienia dla każdej grupy, w tym name, color, icon i background dla wszystkich punktów trasy w tej grupie.

Przykład:

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

Zaawansowane funkcje GPX

Typ aktywności

Począwszy od OsmAnd w wersji 4.9, możesz klasyfikować swoje ślady według typu aktywności w celu dalszej analizy i organizacji w folderach.

Lista obsługiwanych typów aktywności jest dostępna w pliku activities.json. Każda aktywność jest identyfikowana przez unikalny ID i przechowywana w rozszerzeniach <metadata> pliku GPX.

Przykład:

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

HTML w opisach

Tagi HTML mogą być używane wewnątrz tagów <desc> w elementach <metadata> lub <wpt>, aby zapewnić sformatowane opisy dla śladów lub punktów trasy.

Aby uniknąć konfliktów ze składnią XML, zamień znaki specjalne w następujący sposób:

< → <
> → >
& → &

Przykład:

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

Ważne uwagi:

OsmAnd usuwa wszystkie tagi HTML podczas generowania krótkich opisów, pozostawiając czysty tekst.
Do dostosowywania można używać tagów takich jak <b>, <i>, <p>, <br/>, <a>, <img> i innych.

Tag link

Użyj tagu <link>, aby powiązać adresy URL z metadanymi, informacjami o autorze lub punktami trasy w plikach GPX OsmAnd. Ten tag może również wyświetlać obraz, gdy adres URL wskazuje na plik obrazu.

Przykłady (Link w metadanych z obrazem):

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

Przykłady (Link w punkcie trasy z obrazem):

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

Tagi danych z czujników

Możesz wzbogacić swoje ślady o dane z czujników fitness, takich jak monitory tętna czy czujniki temperatury. OsmAnd używa schematu TrackPointExtension firmy Garmin do przechowywania tych danych, co czyni je kompatybilnymi z platformami takimi jak Strava i Garmin Basecamp.

Obsługiwane tagi danych z czujników:

hr - tętno (w uderzeniach na minutę).
cad - kadencja rowerowa (w obrotach na minutę).
atemp - temperatura otoczenia (w stopniach Celsjusza).
power - moc rowerowa (w watach).

Przykład:

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

Szczegóły punktu śladu

Każdy <trkpt> (punkt śladu) w pliku GPX może zawierać dodatkowe atrybuty do przechwytywania danych, takich jak prędkość, kurs i wysokość.

Obsługiwane atrybuty:

speed - prędkość w punkcie śladu (w metrach na sekundę).
heading - kierunek ruchu (0-359 stopni).
ele - wysokość nad poziomem morza (w metrach).
time - znacznik czasu dla punktu śladu.

Przykład:

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

Obliczona trasa (trasy)

W OsmAnd możesz obliczyć trasę i zapisać wszystkie dane w pliku GPX, dzięki czemu później wszystkie funkcje nawigacji będą dostępne jako nawigacja po trasie GPX, więc GPX w OsmAnd będzie zawierał segmenty trasy, zakręty, nazwy dróg, typy dróg, ograniczenia itp. Trasę można całkowicie przywrócić, tak jakby została właśnie zbudowana, nawet w przypadku braku odpowiednich map offline.

Plik GPX może zawierać kilka tras. Każda z nich znajduje się w określonym segmencie pod trkseg / extensions. Plik GPX jest zapisywany w tej formie podczas eksportowania zbudowanej trasy lub podczas zapisywania śladu składającego się z kilku oddzielnych segmentów za pomocą funkcji Planowanie trasy.

Funkcja Planowanie trasy dodaje również jeden (lub kilka, w zależności od liczby zawartych oddzielnych segmentów/śladów) bloków rte do pliku GPX, zawierających kluczowe punkty trasy (rtept).

Struktura GPX:

<trk>
  <trkseg>
    // Lista punktów segmentu. Kolejność punktów odpowiada kolejności i długości segmentów trasy (<route><segment length="x" ... />).
    // Wartość atrybutu "length" odpowiada liczbie punktów w tym segmencie trasy.
    <trkpt ... ></trkpt>
    <extensions>
      // Lista segmentów trasy
      <route>
        <segment ... />
      </route>
      // Właściwości segmentów zawartych w trasie.
      // Te dane są pobierane z map offline podczas początkowego budowania trasy.
      <types>
        <type ... />
      </types>
    </extensions>
  </trkseg>
</trk>

// Lista pośrednich punktów trasy. Jeśli istnieje wiele tras, kolejność listy rte odpowiada kolejności segmentów trasy.
<rte>
  <rtept ... />
    // Dla tras zbudowanych za pomocą "Planowania trasy" zapisywane są parametry punktów kluczowych.
    // Jeśli rtept nie jest pierwszy i ostatni, przed nim (z tym samym idx) trkpt będzie miał te same dane.
    <extensions>
      // Typ profilu trasy dla następnego segmentu (samochód, rower, pieszy itp.).
      <profile>...</profile>
      // Indeks punktu w segmencie GPX, który odpowiada pierwszemu punktowi obliczonej trasy dla tego segmentu.
      // Jeśli rtept nie jest pierwszy i ostatni, przed nim (z tym samym idx) trkpt będzie miał te same dane.
      <trkpt_idx>...</trkpt_idx>
    </extensions>
  </rtept>
</rte>

Ważne właściwości:

trkpt_idx pierwszego rtept w trkseg wynosi 0. Zatem, jeśli istnieją dwa trkseg, będą dwa rtept z trkpt_idx = 0
trkpt_idx ostatniego rtept w trkseg jest równy liczbie trkpt w trkseg minus 1. Na przykład, jeśli trkseg ma 12 trkpt, trkpt_idx ostatniego rtept powinien wynosić 11
Sąsiednie segmenty trasy nakładają się: koniec poprzedniego segmentu i początek następnego segmentu to ten sam trkpt.
Istnieje wyjątek, gdy sąsiednie segmenty trasy nie nakładają się (nie dzielą tego samego trkpt). Dzieje się tak, gdy między segmentami trasy znajduje się rtept. Koniec poprzedniego segmentu trasy to jeden trkpt, a początek następnego segmentu trasy to inny rtept. Ale te dwa trkpt są całkowicie identyczne pod względem szerokości, długości geograficznej i innych parametrów.
Nakładanie się segmentów trasy można wykryć za pomocą length i startTrkptIdx (ten drugi jest używany tylko dla wygody czytania przez człowieka):
- Jeśli suma startTrkptIdx i length poprzedniego segmentu trasy jest równa startTrkptIdx następnego segmentu trasy, segmenty trasy nie nakładają się
- Jeśli suma jest mniejsza o jeden, segmenty trasy nakładają się
Mogą istnieć proste segmenty trasy. Są one oznaczone id="-1". Mogą pojawić się w dwóch przypadkach:
- Jest to trasa wieloprofilowa, a użytkownik wybrał linię prostą
- Użytkownik umieścił rtept zbyt daleko od najbliższej drogi, więc OsmAnd utworzył linię prostą między rtept a drogą
trkpts = length - (segments - 1) + (rtepts - 2), gdzie:
- trkpts - liczba trkpt wewnątrz trkseg
- length - suma wszystkich length segmentów trasy wewnątrz trkseg
- segments - liczba segmentów trasy wewnątrz trkseg
- rtepts - liczba rtept należących do trkseg

Przykład:

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

Kolekcje GPX w OBF

OsmAnd pozwala na konwersję wielu plików GPX do jednego pliku OBF. Umożliwia to przechowywanie tysięcy śladów GPX w kompaktowym, zoptymalizowanym formacie, zachowując jednocześnie funkcje takie jak specjalne ikony mapy, dostosowywanie wyglądu śladu i funkcjonalność wyszukiwania. Pozwala to uniknąć limitu dużych lokalnych plików GPX, które zazwyczaj nie radzą sobie z więcej niż 500 tys. punktów w sumie, jednak niektóre funkcje śladów GPX mogą być niedostępne w porównaniu z wyświetlaniem pliku OBF.

Kroki konwersji GPX do OBF:

Zaloguj się do mapy internetowej OsmAnd *→ Ślady → Wybierz folder → Menu (⋮) → Pobierz jako kolekcję OBF
Wynikowy plik <.obf> można zaimportować do OsmAnd (wymaga OsmAnd na Androida 5.0+).

Styl linii śladu

Dostosuj linie śladu za pomocą następujących tagów:

Tag GPX	Domyślnie	Cel
`<name>`	(brak)	Nazwa wyświetlana nad linią śladu.
`color`	`red`	Główny kolor (HEX lub tekst).
`colour`, `displaycolor`	(brak)	Alternatywne sposoby nadpisania `color`.
`shield_waycolor`	(brak)	Nadpisanie dla koloru `color` linii śladu z tarczą.
`translucent_line_colors`	`no`	Ustaw na `yes` dla półprzezroczystych kolorów.
`width`	`thin`	Szerokość linii: `"thin"`, `"medium"`, `"bold"`, `"1-24"` lub `"roadstyle"`

Obsługiwane kolory: black, blue, brown, darkyellow, gray, green, lightblue, lightgreen, orange, purple, red, white, yellow.

Przykład:

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

Tarcze linii śladu

Tarcze to ikony lub symbole wyświetlane wzdłuż linii śladu. OsmAnd obsługuje tarcze w stylu OSMC-symbol-style, które mogą zawierać:

Ikonę tła - główny kształt (np. koło lub kwadrat).
Ikony pierwszego planu - do dwóch mniejszych symboli nałożonych na tło.
Tekst - krótkie opisy lub identyfikatory, pochodzące z tagów shield_text lub ref.

Jeśli nie zdefiniowano żadnych właściwości tarczy, OsmAnd używa dla śladu automatycznie dopasowanej żółtej tarczy.

Tagi dla tarcz:

Tag GPX	Cel
`shield_bg`	Definiuje ikonę tła dla tarczy.
`shield_fg`	Określa pierwszą ikonę pierwszego planu (np. strzałkę lub kropkę).
`shield_fg_2`	Określa drugą ikonę pierwszego planu (opcjonalnie).
`shield_text`	Ustawia krótki tekst do wyświetlenia na tarczy (np. numer trasy).
`shield_textcolor`	Określa kolor tekstu tarczy (opcjonalnie).
`shield_waycolor`	Nadpisuje standardowy kolor śladu dla linii tarczy (opcjonalnie).
`ref`	Używany jako tekst zastępczy, jeśli `shield_text` nie jest podany.

Przykład:

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

Wyświetlanie punktów trasy

Ikony punktów trasy można dostosować za pomocą następujących tagów:

Tag GPX	Domyślnie	Cel
`icon`	(brak)	Określa ikonę dla punktu trasy (używa standardowych ikon edytora punktów trasy OsmAnd).
`color`	`red`	Ustawia kolor ikony za pomocą kodu HEX (np. `#ffaa00`) lub obsługiwanej nazwy koloru (ograniczone opcje).
`background`	`circle`	Definiuje kształt ikony. Obsługiwane wartości: `circle`, `square`, `octagon`.

Zachowanie kształtów background:

circle - wyświetla ikonę z okrągłym tłem.
square - wyświetla ikonę z kwadratowym tłem, domyślnie czerwonym, jeśli nie określono koloru.
octagon - traktowany w OsmAnd jako okrągłe tło.

Obsługiwane kolory dla background=circle: blue, gray, green, lightblue, lightgreen, orange, purple, yellow.

Ulepszenia z dodatkowymi elementami:

Możesz dodawać sformatowane opisy do punktów trasy za pomocą kodu HTML. Pozwala to na dołączanie stylizowanego tekstu, linków, a nawet obrazów.
Punkty trasy mogą wyświetlać połączone obrazy za pomocą linku jako obrazu.

Przykład:

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

Wyszukiwanie według nazwy i odniesień

Ślady i punkty trasy można zlokalizować za pomocą różnych tagów GPX.

Tag GPX	Lokalizacja	Cel
`<name>`	`<metadata>`	Główna nazwa śladu GPX.
`ref`	`<extensions>` GPX	Krótki identyfikator, często pochodzący z tagu OSM `ref`.
`shield_text`	`<extensions>` GPX	Tekst wyświetlany na tarczach (może być również używany z `ref`).
`name_-_lang`	`<extensions>` GPX/WPT	Zlokalizowana nazwa `name:lang` (np. `name_-_en` dla angielskiego, zamień `:` -> `_-_`)
`<name>`	`<wpt>`	Nazwa punktu trasy.

Przykład:

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

Wyszukiwanie według typu aktywności

OsmAnd organizuje ślady w plikach OBF w Grupy aktywności i Typy aktywności. Te klasyfikacje pomagają filtrować ślady jako POI lub tworzyć filtry wyszukiwania oparte na aktywności.

Jak działają typy aktywności:

Typy i grupy aktywności są określane za pomocą "id" i "tags" z pliku activities.json.
OsmAnd używa tagów osmand:activity lub osmand:route do klasyfikowania aktywności w plikach GPX.

Tag GPX	Lokalizacja	Cel
`osmand:activity`	`<metadata>`	Główny tag OsmAnd do przechowywania typu aktywności (ID).
`osmand:route`	`<extensions>` GPX	Alternatywny sposób OSM na zdefiniowanie typu aktywności.

Przykłady organizowania śladów według typu aktywności:

To sklasyfikuje ślad w grupie Motocykle z typem Jazda terenowa motocyklem (Dirt Biking).

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

To zorganizuje ślad w grupie Kolarstwo z typem Kolarstwo górskie.

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

Tagi informacji wyszukiwania

Pliki OBF automatycznie generują i przechowują kluczowe statystyki i analizy śladów.

Tag OBF	Cel
`distance`	Całkowita odległość pokonana przez wszystkie segmenty śladu.
`start_ele`, `ele_graph`	Dane o wysokości z GPX, opakowane w kompaktową tablicę binarną.
`min_ele`, `avg_ele`, `max_ele`	Minimalna, średnia i maksymalna analiza wysokości.
`diff_ele_up`, `diff_ele_down`	Całkowity przyrost i spadek wysokości na całej trasie.
`max_speed`, `avg_speed`, `min_speed`	Analiza prędkości śladu, w tym maksymalna, średnia i minimalna prędkość.
`time_span`, `time_span_no_gaps`	Całkowity czas trasy, z uwzględnieniem przerw i bez nich.
`time_moving`, `time_moving_no_gaps`	Całkowity czas ruchu, z uwzględnieniem przerw i bez nich.

Tagi wewnętrzne

Niektóre tagi GPX są używane lub przechowywane pośrednio w plikach OBF. Szczegóły implementacji można znaleźć w OsmGpxWriteContext.java.

Tag OBF	Cel
`route_id`	Unikalny identyfikator pliku GPX, łączący dane mapy i POI (format: `/[A-Z]+[0-9]+/` np. `OSM12345`).
`route_type`	Identyfikator grupy aktywności (`id`) pochodzący z `poi/activities.json`
`route_activity_type`	Identyfikator typu aktywności (w ramach grupy) (`id`) pochodzący z `poi/activities.json`
`name`, `ref`, `description`	Lokalizowalne i przeszukiwalne atrybuty (`lang="true"` w typach POI)
`filename`	Nazwa oryginalnego pliku GPX użytego do wygenerowania tego śladu.
`track_color`	Kolor śladu w sekcji mapy pochodzący z `shield_waycolor`, `color`, `colour` lub `displaycolor`
`extensions_extra_tags`	Dowolne dodatkowe tagi dla `<gpx><extensions>` w formacie JSON.
`metadata_extra_tags`	Dowolne dodatkowe tagi dla `<metadata><extensions>` w formacie JSON.
`wpt_extra_tags`	Dowolne dodatkowe tagi dla punktów trasy `<wpt><extensions>` w formacie JSON.
`route_track_point`	Punkty trasy z pliku GPX używają tego typu w danych POI.
`route_bbox_radius`	Określa domyślny promień wyszukiwania części śladu w sekcji POI
`route_shortlink_tiles`	Określa listę kafelków OSM Shortlink oddzielonych przecinkami, aby przyspieszyć odczyt danych geometrii (opcjonalnie)
`route_segment_index`	Określa numer porządkowy segmentu geometrii, który jest powiązany z tym punktem (opcjonalnie)
`route_name`	Nazwa trasy, używana przez wewnętrzną funkcję `searchPoiByName` (przestarzałe)

Wprowadzenie​

Co wyróżnia GPX w OsmAnd?​

Czego dowiesz się z tego przewodnika?​

Przegląd struktury GPX​

Zachowanie importu GPX​

Dostosowywanie śladu​

Parametry wyglądu śladu​

Tag „coloring_type”​

Tagi GPX w interfejsie użytkownika​

Dostosowywanie punktów trasy​

Ikony punktów trasy​

Grupy punktów trasy​

Zaawansowane funkcje GPX​

Typ aktywności​

HTML w opisach​

Tag link​

Tagi danych z czujników​

Szczegóły punktu śladu​

Obliczona trasa (trasy)​

Struktura GPX:​

Ważne właściwości:​

Przykład:​

Kolekcje GPX w OBF​

Styl linii śladu​

Tarcze linii śladu​

Wyświetlanie punktów trasy​

Wyszukiwanie według nazwy i odniesień​

Wyszukiwanie według typu aktywności​

Tagi informacji wyszukiwania​

Tagi wewnętrzne​

Wprowadzenie

Co wyróżnia GPX w OsmAnd?

Czego dowiesz się z tego przewodnika?

Przegląd struktury GPX

Zachowanie importu GPX

Dostosowywanie śladu

Parametry wyglądu śladu

Tag „coloring_type”

Tagi GPX w interfejsie użytkownika

Dostosowywanie punktów trasy

Ikony punktów trasy

Grupy punktów trasy

Zaawansowane funkcje GPX

Typ aktywności

HTML w opisach

Tag link

Tagi danych z czujników

Szczegóły punktu śladu

Obliczona trasa (trasy)

Struktura GPX:

Ważne właściwości:

Przykład:

Kolekcje GPX w OBF

Styl linii śladu

Tarcze linii śladu

Wyświetlanie punktów trasy

Wyszukiwanie według nazwy i odniesień

Wyszukiwanie według typu aktywności

Tagi informacji wyszukiwania

Tagi wewnętrzne