Расширенные данные в файлах GPX и KML

Помимо координат, высоты и времени, Геотрекер может записывать в экспортированные файлы GPX, KML и KMZ дополнительные данные о каждой точке трека: скорость, направление, точность, часовой пояс, источник местоположения и спутники. При импорте файла Геотрекер снова читает эти поля, а в других программах их можно использовать для анализа треков.

Расширенные данные записываются, только если в Настройки → Данные в разделе Экспорт включён Экспорт расширенных данных. Выключите его, если эти данные вам не нужны и вы хотите получать файлы меньшего размера.

Поля точек трека

Поле записывается, только если у точки есть для него значение. Какие значения есть у точки, зависит от устройства и источника местоположения.

GPX	KML	Значение	Единицы или значения
`c`	`course`	Направление движения, по часовой стрелке от географического севера	Радианы, от 0 до 2π (≈ 6,28); умножьте на 57,3, чтобы получить градусы
`s`	`speed`	Скорость	Метры в секунду
`a`	`accuracy`	Точность по горизонтали	Метры
`va`	`verticalAccuracy`	Точность по вертикали	Метры
`sa`	`speedAccuracy`	Точность скорости	Метры в секунду
`ca`	`courseAccuracy`	Точность направления	Градусы
`tz`	`tzOffset`	Смещение часового пояса от UTC в момент записи	Секунды, например `7200` для UTC+2
`src`	`source`	Источник местоположения	`1` устройство, `2` сеть, `3` Bluetooth-приёмник, `4` аксессуар
`su`	`satellitesUsed`	Спутники, использованные для определения позиции	Количество
`sv`	`satellitesVisible`	Видимые спутники	Количество
`hdop`	`hdop`	Горизонтальный геометрический фактор точности (HDOP)	Число, чем меньше, тем лучше
`fq`	`fixQuality`	Качество фикса по NMEA	`1` GPS, `2` DGPS, `4` RTK fixed, `5` RTK float и т. д.
`mock`	`mock`	Позиция из приложения для подмены местоположения	`1` да, `0` нет
`dev`	`sourceDevice`	Название Bluetooth-приёмника	Текст

Откуда берутся значения:

Источник местоположения: 1 — собственное местоположение устройства. На Android это его встроенный спутниковый приёмник; на iPhone iOS не сообщает, какой источник использовался. 4 — сертифицированный для iPhone приёмник (MFi), который передаёт координаты в iOS. Подробнее в инструкции Запись с Bluetooth GNSS-приёмником.
Спутники (su, sv) записываются на Android и для Bluetooth-приёмников, подключённых в Геотрекере. iOS не передаёт приложениям данные о спутниках.
HDOP и качество фикса (hdop, fq) приходят только от Bluetooth-приёмников, подключённых в Геотрекере.
Часовой пояс (tz) берётся из настроек часового пояса устройства, поэтому следите, чтобы он был указан верно.
Mock не записывается, если платформа не может определить, подменена ли позиция.

GPX

В файлах GPX поля записываются как атрибуты элемента <geotracker:meta> в <extensions> каждой точки <trkpt>. Префикс geotracker объявлен в корневом элементе как xmlns:geotracker="http://ilyabogdanovich.com/gpx/extensions/geotracker". Адрес пространства имён ведёт на эту страницу.

<trkpt lat="47.12345678" lon="8.54321000">
  <ele>450.00</ele>
  <time>2026-09-05T14:23:00Z</time>
  <extensions>
    <geotracker:meta c="2.36" s="2.85" a="4.00" va="3.00" tz="7200" src="3" su="18" sv="27" hdop="0.80" fq="4" mock="0" dev="My GNSS receiver" />
  </extensions>
</trkpt>

Здесь точка записана с Bluetooth-приёмником (src="3") с решением RTK fixed (fq="4"), при движении на юго-восток (c="2.36", около 135°) со скоростью 2,85 м/с (около 10,3 км/ч), в часовом поясе на 2 часа впереди UTC.

KML и KMZ

Файл KMZ — это заархивированный файл KML, поэтому в них одни и те же поля. В KML они хранятся в формате расширенных данных Google:

В документе объявлена схема Schema с ID geotrackerTrackSchema, в которой для каждого поля есть gx:SimpleArrayField с описанием в displayName.
У каждого gx:Track есть элемент ExtendedData с SchemaData, ссылающимся на эту схему. В нём по одному gx:SimpleArrayData на поле, а в каждом — по одному gx:value на точку трека, в порядке элементов when и gx:coord. Если у точки нет значения, gx:value пустой.

<gx:Track>
  <when>2026-09-05T14:23:00Z</when>
  <when>2026-09-05T14:23:01Z</when>
  <gx:coord>8.54321000 47.12345678 450.00</gx:coord>
  <gx:coord>8.54325000 47.12342000 450.20</gx:coord>
  <ExtendedData>
    <SchemaData schemaUrl="#geotrackerTrackSchema">
      <gx:SimpleArrayData name="speed">
        <gx:value>2.85</gx:value>
        <gx:value>2.90</gx:value>
      </gx:SimpleArrayData>
      <gx:SimpleArrayData name="accuracy">
        <gx:value>4.00</gx:value>
        <gx:value>3.50</gx:value>
      </gx:SimpleArrayData>
    </SchemaData>
  </ExtendedData>
</gx:Track>

Поля поездки, трека и меток

Геотрекер также сохраняет несколько данных о поездке, её треках и метках. Они записываются независимо от того, включён ли Экспорт расширенных данных.

GPX	KML	Значение
`geotracker:comment` в `<metadata>`	`Data` с именем `comment`	Комментарий к поездке или треку
`geotracker:length` в `<trk>`	—	Длина трека, метры
`geotracker:duration` в `<trk>`	`TimeSpan` трека	Длительность записи; в GPX — в миллисекундах
`geotracker:creationtime` в `<trk>`	`begin` в `TimeSpan`	Начало записи
`geotracker:activity` в `<trk>`	`Data` с именем `activity`	Активность: `0` не задана, `1` лыжи
Атрибут `visited` путевой точки	`Data` с именем `visited`	`1`, если вы посетили метку
Атрибут `emoji` путевой точки	`Data` с именем `emoji`	Эмодзи метки
Атрибут `generated` путевой точки	`Data` с именем `generated`	`1` для меток, которые Геотрекер создал автоматически, например меток остановок
`<type>` точки маршрута	`Data` с именем `maneuver`	Манёвр маршрутного руководства: `L` поворот налево, `R` поворот направо, `U` разворот

В GPX поля трека — это элементы внутри <extensions><geotracker:meta>, а поля меток — атрибуты <geotracker:meta>.