OsmAnd GPX

Вступ

GPX (GPS Exchange Format) — це широко використовуваний стандарт на основі XML для зберігання даних GPS, включаючи треки, маршрути та шляхові точки. OsmAnd підтримує формат GPX для імпорту, експорту та налаштування даних GPS для навігації, що дозволяє як початківцям, так і досвідченим користувачам оптимізувати свій досвід.

Що робить OsmAnd GPX унікальним?

OsmAnd розширює стандартний формат GPX 1.1, запроваджуючи власний користувацький простір імен XML osmand:. Цей простір імен дозволяє зберігати додаткові дані, такі як:

Візуальні налаштування треку (колір, ширина, стрілки).
Групування та іконки шляхових точок.
Детальні атрибути маршруту, включаючи розраховані маршрути та типи активності.

Що ви дізнаєтеся з цього посібника?

Ця стаття надає вичерпний огляд структури та функцій файлів GPX в OsmAnd. Ви дізнаєтеся:

Як налаштувати треки та шляхові точки за допомогою тегів GPX.
Розширені функції, такі як HTML-описи, дані датчиків та типи активності.
Як експортувати розраховані маршрути та зберегти їх повну функціональність.
Перетворення файлів GPX у формат OBF для оптимізованого зберігання та розширених можливостей пошуку.

Огляд структури GPX

Файли GPX в OsmAnd організовують дані ієрархічно за такими елементами:

<gpx> - кореневий елемент файлу.
<trk> - представляє треки, які містять:
- <trkseg> - сегменти треку, які далі поділяються на <trkpt> (точки треку).
<rte> - представляє маршрути, включаючи шляхові точки та ключові точки.
<wpt> - представляє окремі шляхові точки.

Налаштування треку

Параметри зовнішнього вигляду треку

У цьому розділі описано, як OsmAnd відображає треки на карті та доступні параметри налаштування їх зовнішнього вигляду. Описані нижче параметри застосовуються в межах тегу <gpx> і впливають на всі треки, включені до файлу GPX.

Назва тегу	Опис / Значення
`<color>`	- Визначає колір лінії треку на карті. - Рядок: HEX-код кольору `#RRGGBB` або `#AARRGGBB`
`<width>`	- Визначає ширину лінії треку. - Рядок: `“thin”`, `“medium"`, `“bold”` (визначається атрибутом `“currentTrackWidth”`), або ціле число (1-24)
`<show_arrows>`	- Вмикає або вимикає стрілки напрямку вздовж треку. - Булеве: `"true"` / `"false"`
`<show_start_finish>`	- Показує або приховує маркери початку та кінця треку. - Булеве: `"true"` / `"false"`
`<split_type>`	- Визначає тип сегментації для треку. - Рядок: `"no_split"`, `"distance"`, `"time"`
`<split_interval>`	- Встановлює інтервал для сегментації треку на основі вибраного типу. - Подвійне: Ціле число (метри для `"distance"`, секунди для `"time"`)
`<line_3d_visualization_by_type>`	- Визначає тип 3D-візуалізації для треку. - Рядок: `"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>`	- Визначає тип кольору стіни для 3D-візуалізації. - Рядок: `"none"`, `"solid"`, `"downward_gradient"`, `"upward_gradient"`, `"altitude"`, `"slope"`, `"speed"`
`<line_3d_visualization_position_type>`	- Встановлює положення 3D-візуалізації відносно треку. - Рядок: `"top"`, `"bottom"`, `"top_bottom"`
`<vertical_exaggeration_scale>`	- Множник для масштабування значення атрибута `line_3d_visualization_by_type`. - Дробове: За замовчуванням: 1.0
`<elevation_meters>`	- Визначає фіксовану висоту в метрах для `"fixed_height"` в `<line_3d_visualization_by_type>`. - Дробове: За замовчуванням: `1000`
`<coloring_type>`	- Визначає метод розфарбовування треку. - Рядок: `"solid"`, `"speed"`, `"altitude"`, `"slope"`, `"routeInfo_roadClass`, `"routeInfo_surface"`, `"routeInfo_smoothness"`
`<color_palette>`	- Визначає колірну схему для треку. - Рядок: `"default"` / користувацькі схеми

Приклад:

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

Тег 'coloring_type'

Тег <coloring_type> в OsmAnd дозволяє користувачам налаштовувати розфарбовування треку на основі конкретних атрибутів даних, надаючи візуальний спосіб інтерпретації ключової інформації вздовж треку.

Тип	Опис	Випадок використання
`<solid>`	Весь трек відображається одним суцільним кольором, визначеним тегом `color`.	Використовуйте, коли потрібен однорідний колір для чіткої видимості.
`<speed>`	Трек розфарбовується градієнтом на основі значень швидкості в кожній точці треку (`<trkpt>`). Вищі швидкості представлені різними кольорами.	Ідеально підходить для таких видів діяльності, як їзда на велосипеді або водіння, для візуалізації змін швидкості.
`<altitude>`	Трек розфарбовується відповідно до даних про висоту в кожному `<trkpt>`. Застосовується градієнт, що вказує на різні діапазони висот.	Корисно для піших або гірських маршрутів, щоб виділити зміни висоти.
`<slope>`	Трек розфарбовується на основі нахилу/спуску між послідовними точками треку. Позитивні градієнти вказують на підйоми, тоді як негативні градієнти вказують на спуски.	Підходить для велосипедистів або туристів, які аналізують складність треку.
`<routeInfo_roadClass>`	Розфарбовує сегменти треку на основі класифікації доріг OpenStreetMap (OSM) (наприклад, шосе, житлова вулиця).	Допомагає розрізняти різні типи доріг під час руху за маршрутом.
`<routeInfo_surface>`	Розфарбовує сегменти треку на основі типу поверхні OSM (наприклад, асфальт, гравій, ґрунт).	Корисно для визначення умов треку під час таких видів діяльності, як бездоріжжя.
`<routeInfo_smoothness>`	Розфарбовує трек відповідно до рейтингів гладкості OSM, що вказує на шорсткість або гладкість шляху (наприклад, відмінно, погано).	Корисно для оцінки прохідності треку для конкретних транспортних засобів.

Теги GPX в інтерфейсі користувача

Теги розширень GPX відображаються внизу контекстного меню треку. Перелічуються як <metadata>, так і <gpx> <extensions>. Теги зовнішнього вигляду виключені з переліку. Підтримується з OsmAnd Android 5.0.

Налаштування шляхових точок

У цьому розділі пояснюється, як OsmAnd дозволяє налаштовувати шляхові точки у файлах GPX за допомогою іконок, кольорів та групування.

Іконки шляхових точок

Наступні теги керують зовнішнім виглядом іконок шляхових точок в OsmAnd:

Тег GPX	За замовчуванням	Призначення
`<icon>`	(немає)	Визначає іконку для шляхової точки (наприклад, `historic_castle`).
`<color>`	`"red"`	Встановлює колір іконки за допомогою HEX-коду (наприклад, `#FF0000`) або назви кольору (наприклад, `"blue"`).
`<background>`	`"circle"`	Визначає форму фону іконки. Можливі значення: `"circle"`, `"square"`, `"octagon"`.

Приклад:

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

Групи шляхових точок

Шляхові точки в OsmAnd можна сортувати за групами на основі їх типу. Це групування дозволяє користувачеві організовувати кілька шляхових точок за певними категоріями, покращуючи чіткість та читабельність карти.

Визначення групи точок. Тег <type> всередині елемента <wpt> визначає групу точки (наприклад, "castle", "aqueduct").
Конфігурація групи. Розширення <osmand:points_groups> в елементі <gpx> визначає налаштування для кожної групи, включаючи name, color, icon та background для всіх шляхових точок у цій групі.

Приклад:

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

Розширені функції GPX

Тип активності

Починаючи з версії 4.9 OsmAnd, ви можете класифікувати свої треки за типом активності для подальшого аналізу та організації в папки.

Список підтримуваних типів активності доступний у файлі activities.json. Кожна активність ідентифікується своїм унікальним ID і зберігається в розширеннях <metadata> файлу GPX.

Приклад:

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

HTML в описах

HTML-теги можна використовувати в тегах <desc> в елементах <metadata> або <wpt> для надання форматованих описів для треків або шляхових точок.

Щоб уникнути конфліктів із синтаксисом XML, замініть спеціальні символи наступним чином:

< → <
> → >
& → &

Приклад:

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

Важливі примітки:

OsmAnd видаляє всі HTML-теги при генерації коротких описів, залишаючи простий текст.
Ви можете використовувати теги, такі як <b>, <i>, <p>, <br/>, <a>, <img> та інші для налаштування.

Тег посилання

Використовуйте тег <link> для зв'язування URL-адрес з метаданими, інформацією про автора або шляховими точками у файлах OsmAnd GPX. Цей тег також може відображати зображення, якщо URL вказує на файл зображення.

Приклади (Посилання на метадані із зображенням):

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

Приклади (Посилання на шляхову точку із зображенням):

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

Теги даних датчиків

Ви можете збагатити свої треки даними з фітнес-датчиків, таких як пульсометри або датчики температури. OsmAnd використовує схему TrackPointExtension Garmin для зберігання цих даних, що робить їх сумісними з такими платформами, як Strava та Garmin Basecamp.

Підтримувані теги даних датчиків:

hr - частота серцевих скорочень (у ударах на хвилину).
cad - каденс велосипеда (у обертах на хвилину).
atemp - температура навколишнього середовища (у градусах Цельсія).
power - вихідна потужність велосипеда (у ватах).

Приклад:

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

Деталі точки треку

Кожна <trkpt> (точка треку) у файлі GPX може включати додаткові атрибути для збору даних, таких як швидкість, напрямок та висота.

Підтримувані атрибути:

speed - швидкість у точці треку (у метрах на секунду).
heading - напрямок руху (0-359 градусів).
ele - висота над рівнем моря (у метрах).
time - мітка часу для точки треку.

Приклад:

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

Розраховані маршрути

В OsmAnd ви можете розрахувати маршрут і зберегти всі дані у форматі GPX, щоб пізніше всі функції навігації були доступні як навігація за GPX. Таким чином, файл OsmAnd GPX буде містити сегменти маршруту, повороти, назви доріг, типи доріг, обмеження тощо. Маршрут може бути повністю відновлений, ніби щойно побудований, навіть за відсутності відповідних офлайн-карт.

Файл gpx може містити кілька маршрутів. Кожен з них міститься в окремому сегменті під trkseg / extensions. Файл gpx зберігається в такому вигляді при експорті побудованого маршруту або при збереженні треку, що складається з декількох окремих сегментів, за допомогою функції Планування маршруту.

Планування маршруту також додає один (або кілька, відповідно до кількості окремих сегментів / треків) блоки rte до файлу gpx, що містять ключові точки маршруту (rtept).

Структура Gpx:

<trk>
  <trkseg>
    // Список точок сегмента. Порядок точок відповідає порядку та довжині сегментів маршруту (<route><segment length="x" ... />).
    // Значення атрибута "length" відповідає кількості точок у цьому сегменті маршруту.
    <trkpt ... ></trkpt>
    <extensions>
      // Список сегментів маршруту
      <route>
        <segment ... />
      </route>
      // Властивості сегментів, включених до маршруту.
      // Ці дані беруться з офлайн-карт під час початкового побудови маршруту.
      <types>
        <type ... />
      </types>
    </extensions>
  </trkseg>
</trk>

// Список проміжних точок маршруту. Якщо є кілька маршрутів, порядок списку rte відповідає порядку сегментів маршруту.
<rte>
  <rtept ... />
    // Для маршрутів, побудованих за допомогою "Планування маршруту", зберігаються параметри ключових точок.
    // Якщо rtept не є першим і останнім, перед ним (з тим же idx) буде trkpt з тими ж даними.
    <extensions>
      // Тип профілю маршруту для наступного сегмента (автомобіль, велосипед, пішохід тощо).
      <profile>...</profile>
      // Індекс точки в сегменті gpx, що відповідає першій точці розрахованого маршруту для цього сегмента.
      // Якщо rtept не є першим і останнім, перед ним (з тим же idx) буде trkpt з тими ж даними.
      <trkpt_idx>...</trkpt_idx>
    </extensions>
  </rtept>
</rte>

Важливі властивості:

trkpt_idx першого rtept в trkseg дорівнює 0. Отже, якщо є два trkseg, буде два rtept з trkpt_idx = 0
trkpt_idx останнього rtept в trkseg дорівнює кількості trkpt в trkseg мінус 1. Наприклад, якщо trkseg має 12 trkpt, trkpt_idx останнього rtept має бути 11
Сусідні сегменти маршруту перекриваються: кінець попереднього сегмента та початок наступного сегмента є однією і тією ж trkpt.
Існує виняток, коли сусідні сегменти маршруту не перекриваються (не мають спільної trkpt). Це відбувається, коли є rtept "між" сегментами маршруту. Кінець попереднього сегмента маршруту є однією trkpt, а початок наступного сегмента маршруту є іншою rtept. Але ці дві trkpt повністю рівні за широтою, довготою та іншими параметрами.
Перекриття сегментів маршруту можна виявити за допомогою length та startTrkptIdx (останній використовується лише для зручності читання людиною):
- Якщо сума startTrkptIdx та length попереднього сегмента маршруту дорівнює startTrkptIdx наступного сегмента маршруту, сегменти маршруту не перекриваються
- Якщо сума менша на одиницю, то сегменти маршруту перекриваються
Можуть бути прямі сегменти маршруту. Вони позначені id="-1". Вони можуть з'явитися в двох випадках:
- Це багатопрофільний маршрут, і користувач вибрав пряму лінію
- Користувач розмістив rtept занадто далеко від найближчої дороги, тому osmand зробив пряму лінію між rtept та дорогою
trkpts = length - (segments - 1) + (rtepts - 2), де:
- trkpts - кількість trkpt всередині trkseg
- length - сума всіх length сегментів маршруту всередині trkseg
- segments - кількість сегментів маршруту всередині trkseg
- rtepts - кількість rtept, що належать trkseg

Приклад:

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

OsmAnd дозволяє конвертувати кілька файлів GPX в один файл OBF. Це дозволяє зберігати тисячі треків GPX у компактному, оптимізованому форматі, зберігаючи при цьому такі функції, як спеціальні іконки на карті, налаштування зовнішнього вигляду треку та функцію пошуку. Це дозволяє уникнути обмеження локальних великих файлів GPX, які зазвичай не можуть обробляти > 500 тис. точок загалом, однак деякі функції треків GPX можуть бути відсутніми порівняно з відображенням файлу OBF.

Кроки для конвертації GPX в OBF:

Увійдіть на OsmAnd Web Map *→ Треки → Виберіть папку → Меню (⋮) → Завантажити як колекцію OBF
Отриманий файл <.obf> можна імпортувати в OsmAnd (потрібен OsmAnd Android 5.0+).

Стиль лінії треку

Налаштуйте лінії треку за допомогою наступних тегів:

Тег GPX	За замовчуванням	Призначення
`<name>`	(немає)	Назва, що відображається над лінією треку.
`color`	`red`	Основний колір (HEX або текст).
`colour`, `displaycolor`	(немає)	Альтернативні способи перевизначення `color`.
`shield_waycolor`	(немає)	Перевизначення для `color` лінії треку щита.
`translucent_line_colors`	`no`	Встановіть на `yes` для напівпрозорих кольорів.
`width`	`thin`	Ширина лінії: `"thin"`, `"medium"`, `"bold"`, `"1-24"`, або `"roadstyle"`

Підтримувані кольори: black, blue, brown, darkyellow, gray, green, lightblue, lightgreen, orange, purple, red, white, yellow.

Приклад:

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

Щити лінії треку

Щити — це іконки або символи, що відображаються вздовж лінії треку. OsmAnd підтримує щити OSMC-symbol-style, які можуть включати:

Фонова іконка - основна форма (наприклад, коло або квадрат).
Іконки переднього плану - до двох менших символів, накладених на фон.
Текст - короткі описи або ідентифікатори, отримані з тегів shield_text або ref.

Якщо властивості щита не визначені, OsmAnd використовує автоматично масштабований жовтий щит для треку.

Теги для щитів:

Тег GPX	Призначення
`shield_bg`	Визначає фонову іконку для щита.
`shield_fg`	Визначає першу іконку переднього плану (наприклад, стрілка або точка).
`shield_fg_2`	Визначає другу іконку переднього плану (необов'язково).
`shield_text`	Встановлює короткий текст, що відображається над щитом (наприклад, посилання на маршрут).
`shield_textcolor`	Визначає колір тексту щита (необов'язково).
`shield_waycolor`	Перевизначає стандартний колір треку для лінії щита (необов'язково).
`ref`	Використовується як резервний текст, якщо `shield_text` не надано.

Приклад:

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

Відображення шляхових точок

Іконки шляхових точок можна налаштувати за допомогою наступних тегів:

Тег GPX	За замовчуванням	Призначення
`icon`	(немає)	Визначає іконку для шляхової точки (використовує стандартні іконки редактора шляхових точок OsmAnd).
`color`	`red`	Встановлює колір іконки за допомогою HEX-коду (наприклад, `#ffaa00`) або підтримуваної назви кольору (обмежені варіанти).
`background`	`circle`	Визначає форму іконки. Підтримувані значення: `circle`, `square`, `octagon`.

Поведінка форм background:

circle - відображає іконку з круглим фоном.
square - відображає іконку з квадратним фоном, за замовчуванням червоним, якщо колір не вказано.
octagon - розглядається як круглий фон в OsmAnd.

Підтримувані кольори для background=circle: blue, gray, green, lightblue, lightgreen, orange, purple, yellow.

Покращення з додатковими елементами:

Ви можете додавати форматовані описи до шляхових точок за допомогою HTML-коду. Це дозволяє включати стилізований текст, посилання або навіть зображення.
Шляхові точки можуть відображати пов'язані зображення за допомогою Посилання як зображення.

Приклад:

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

Пошук за назвою та посиланнями

Треки та шляхові точки можна знайти за допомогою різних тегів GPX.

Тег GPX	Розташування	Призначення
`<name>`	`<metadata>`	Основна назва треку GPX.
`ref`	GPX `<extensions>`	Короткий ідентифікатор, часто отриманий з тегу OSM `ref`.
`shield_text`	GPX `<extensions>`	Текст, що відображається на щитах (також може використовуватися з `ref`).
`name_-_lang`	GPX/WPT `<extensions>`	Локалізована `name:lang` (наприклад, `name_-_en` для англійської, замінити `:` -> `_-_`)
`<name>`	`<wpt>`	Назва шляхової точки.

Приклад:

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

Пошук за типом активності

OsmAnd організовує треки у файлах OBF за Групами активності та Типами активності. Ці класифікації допомагають фільтрувати треки як POI або створювати пошукові фільтри на основі активності.

Як працюють типи активності:

Типи та групи активності визначаються за допомогою "id" та "tags" з файлу activities.json.
OsmAnd використовує теги osmand:activity або osmand:route для класифікації активностей у файлах GPX.

Тег GPX	Розташування	Призначення
`osmand:activity`	`<metadata>`	Основний тег OsmAnd для зберігання типу активності (ID).
`osmand:route`	GPX `<extensions>`	Альтернативний спосіб OSM для визначення типу активності.

Приклади організації треків за типом активності:

Це класифікує трек у групу Мотоциклізм з типом Позашляховий мотоциклізм (Dirt Biking).
```
<metadata>
  <extensions>
    <osmand:activity>off_road_motorcycling_dirt_biking</osmand:activity>
  </extensions>
</metadata>
```
Це організує трек у групу Велоспорт з типом Гірський велосипед.
```
<gpx>
  <extensions>
    <osmand:route>mtb</osmand:route>
  </extensions>
</gpx>
```

Теги пошукової інформації

Файли OBF автоматично генерують та зберігають критичні статистичні дані та аналітику треків.

Тег OBF	Призначення
`distance`	Загальна відстань, пройдена всіма сегментами треку.
`start_ele`, `ele_graph`	Дані про висоту з GPX, упаковані в компактний бінарний масив.
`min_ele`, `avg_ele`, `max_ele`	Мінімальна, середня та максимальна висота.
`diff_ele_up`, `diff_ele_down`	Загальний набір та втрата висоти на треку.
`max_speed`, `avg_speed`, `min_speed`	Аналітика швидкості треку, включаючи максимальну, середню та мінімальну швидкість.
`time_span`, `time_span_no_gaps`	Загальний час треку, з урахуванням та без урахування проміжків.
`time_moving`, `time_moving_no_gaps`	Загальний час руху, з урахуванням та без урахування проміжків.

Внутрішні теги

Деякі теги GPX використовуються або зберігаються опосередковано у файлах OBF. Деталі реалізації дивіться у OsmGpxWriteContext.java.

Тег OBF	Призначення
`route_id`	Унікальний ідентифікатор для файлу GPX, що зв'язує дані карти та POI (формат: `/[A-Z]+[0-9]+/` наприклад, `OSM12345`).
`route_type`	Ідентифікатор групи активності (`id`), отриманий з `poi/activities.json`
`route_activity_type`	Ідентифікатор типу активності (в межах групи) (`id`), отриманий з `poi/activities.json`
`name`, `ref`, `description`	Локалізовані та пошукові атрибути (`lang="true"` в типах POI)
`filename`	Назва оригінального файлу GPX, використаного для генерації цього треку.
`track_color`	Колір треку розділу карти, отриманий з `shield_waycolor`, `color`, `colour` або `displaycolor`
`extensions_extra_tags`	Довільні додаткові теги для `<gpx><extensions>` у форматі JSON.
`metadata_extra_tags`	Довільні додаткові теги для `<metadata><extensions>` у форматі JSON.
`wpt_extra_tags`	Довільні додаткові теги для шляхових точок `<wpt><extensions>` у форматі JSON.
`route_track_point`	Шляхові точки з файлу GPX використовують цей тип у даних POI.
`route_bbox_radius`	Визначає радіус за замовчуванням для пошуку частин треку в розділі POI
`route_shortlink_tiles`	Визначає список плиток OSM Shortlink, розділених комами, для прискорення читання геометричних даних (необов'язково)
`route_segment_index`	Визначає порядковий номер геометричного сегмента, який пов'язаний з цією точкою (необов'язково)
`route_name`	Назва маршруту, використовується внутрішнім `searchPoiByName` (застаріло)

Останнє оновлення: Березень 2025

Вступ​

Що робить OsmAnd GPX унікальним?​

Що ви дізнаєтеся з цього посібника?​

Огляд структури GPX​

Налаштування треку​

Параметри зовнішнього вигляду треку​

Тег 'coloring_type'​

Теги GPX в інтерфейсі користувача​

Налаштування шляхових точок​

Іконки шляхових точок​

Групи шляхових точок​

Розширені функції GPX​

Тип активності​

HTML в описах​

Тег посилання​

Теги даних датчиків​

Деталі точки треку​

Розраховані маршрути​

Структура Gpx:​

Важливі властивості:​

Приклад:​

Колекції GPX в OBF​

Стиль лінії треку​

Щити лінії треку​

Відображення шляхових точок​

Пошук за назвою та посиланнями​

Пошук за типом активності​

Теги пошукової інформації​

Внутрішні теги​

Вступ

Що робить OsmAnd GPX унікальним?

Що ви дізнаєтеся з цього посібника?

Огляд структури GPX

Налаштування треку

Параметри зовнішнього вигляду треку

Тег 'coloring_type'

Теги GPX в інтерфейсі користувача

Налаштування шляхових точок

Іконки шляхових точок

Групи шляхових точок

Розширені функції GPX

Тип активності

HTML в описах

Тег посилання

Теги даних датчиків

Деталі точки треку

Розраховані маршрути

Структура Gpx:

Важливі властивості:

Приклад:

Колекції GPX в OBF

Стиль лінії треку

Щити лінії треку

Відображення шляхових точок

Пошук за назвою та посиланнями

Пошук за типом активності

Теги пошукової інформації

Внутрішні теги