Skip to main content

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

  1. Jak dostosowywać ślady i punkty trasy za pomocą tagów GPX.
  2. Zaawansowane funkcje, takie jak opisy HTML, dane z czujników i typy aktywności.
  3. Jak eksportować obliczone trasy i zachować ich pełną funkcjonalność.
  4. 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.

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 taguOpis / 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” (cienka), „medium" (średnia), „bold” (pogrubiona) (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" (bez podziału), "distance" (odległość), "time" (czas)
<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.

TypOpisPrzypadek 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 GPXDomyślnieCel
<icon>(brak)Określa ikonę dla punktu trasy (np. historic_castle).
<color>"czerwony"Ustawia kolor ikony za pomocą kodu HEX (np. #FF0000) lub nazwy koloru (np. "blue").
<background>"koło"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:

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

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.

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. Plik 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 GPXDomyślnieCel
<name>(brak)Nazwa wyświetlana nad linią śladu.
colorczerwonyGłó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_colorsnieUstaw na tak dla półprzezroczystych kolorów.
widthcienkaSzerokość 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 GPXCel
shield_bgDefiniuje ikonę tła dla tarczy.
shield_fgOkreśla pierwszą ikonę pierwszego planu (np. strzałkę lub kropkę).
shield_fg_2Określa drugą ikonę pierwszego planu (opcjonalnie).
shield_textUstawia krótki tekst do wyświetlenia na tarczy (np. numer trasy).
shield_textcolorOkreśla kolor tekstu tarczy (opcjonalnie).
shield_waycolorNadpisuje standardowy kolor śladu dla linii tarczy (opcjonalnie).
refUż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 GPXDomyślnieCel
icon(brak)Określa ikonę dla punktu trasy (używa standardowych ikon edytora punktów trasy OsmAnd).
colorczerwonyUstawia kolor ikony za pomocą kodu HEX (np. #ffaa00) lub obsługiwanej nazwy koloru (ograniczone opcje).
backgroundkołoDefiniuje 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 GPXLokalizacjaCel
<name><metadata>Główna nazwa śladu GPX.
ref<extensions> GPXKrótki identyfikator, często pochodzący z tagu OSM ref.
shield_text<extensions> GPXTekst wyświetlany na tarczach (może być również używany z ref).
name_-_lang<extensions> GPX/WPTZlokalizowana 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 GPXLokalizacjaCel
osmand:activity<metadata>Główny tag OsmAnd do przechowywania typu aktywności (ID).
osmand:route<extensions> GPXAlternatywny sposób OSM na zdefiniowanie typu aktywności.

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

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

  2. 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 OBFCel
distanceCałkowita odległość pokonana przez wszystkie segmenty śladu.
start_ele, ele_graphDane o wysokości z GPX, opakowane w kompaktową tablicę binarną.
min_ele, avg_ele, max_eleMinimalna, średnia i maksymalna analiza wysokości.
diff_ele_up, diff_ele_downCałkowity przyrost i spadek wysokości na całej trasie.
max_speed, avg_speed, min_speedAnaliza prędkości śladu, w tym maksymalna, średnia i minimalna prędkość.
time_span, time_span_no_gapsCałkowity czas trasy, z uwzględnieniem przerw i bez nich.
time_moving, time_moving_no_gapsCał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 OBFCel
route_idUnikalny identyfikator pliku GPX, łączący dane mapy i POI (format: /[A-Z]+[0-9]+/ np. OSM12345).
route_typeIdentyfikator grupy aktywności (id) pochodzący z poi/activities.json
route_activity_typeIdentyfikator typu aktywności (w ramach grupy) (id) pochodzący z poi/activities.json
name, ref, descriptionLokalizowalne i przeszukiwalne atrybuty (lang="true" w typach POI)
filenameNazwa oryginalnego pliku GPX użytego do wygenerowania tego śladu.
track_colorKolor śladu w sekcji mapy pochodzący z shield_waycolor, color, colour lub displaycolor
extensions_extra_tagsDowolne dodatkowe tagi dla <gpx><extensions> w formacie JSON.
metadata_extra_tagsDowolne dodatkowe tagi dla <metadata><extensions> w formacie JSON.
wpt_extra_tagsDowolne dodatkowe tagi dla punktów trasy <wpt><extensions> w formacie JSON.
route_track_pointPunkty trasy z pliku GPX używają tego typu w danych POI.
route_bbox_radiusOkreśla domyślny promień wyszukiwania części śladu w sekcji POI
route_shortlink_tilesOkreśla listę kafelków OSM Shortlink oddzielonych przecinkami, aby przyspieszyć odczyt danych geometrii (opcjonalnie)
route_segment_indexOkreśla numer porządkowy segmentu geometrii, który jest powiązany z tym punktem (opcjonalnie)
route_nameNazwa trasy, używana przez wewnętrzną funkcję searchPoiByName (przestarzałe)