Fitroutefixer: Главная Справка

Как пользоваться ботом без путаницы: базовый сценарий, команды по группам (маршрут, паузы, фильтры), каталог GPX, примеры для реальных кейсов и разбор частых ошибок.

1. Что Делает Бот

Fitroutefixer исправляет проблемные FIT-файлы: убирает GPS-артефакты, восстанавливает/корректирует паузы и делает трек более аккуратным для экспорта и анализа.

  1. Читает FIT и находит проблемные участки: скачки, разрывы, аномальные точки.
  2. Применяет выбранные фильтры и параметры коррекции.
  3. Если приложен GPX — дополнительно привязывает трек к геометрии маршрута.
  4. Для горных активностей можно включить elevatesync — предварительное восстановление темпа по профилю высот.
  5. Возвращает исправленный FIT, отчёт по изменениям и картинку-превью.

Наглядно

Что отправляете Что делает бот Что получаете
Только FITЧистит и стабилизирует трек по данным FIT.Исправленный FIT + отчёт + превью.
FIT + GPXДелает то же самое + использует GPX как форму маршрута для более точной привязки.Исправленный FIT + отчёт + превью наложения.

2. Где Скачать FIT/GPX

Для Fitroutefixer обычно нужно два файла: FIT активности + GPX маршрута.
Важно: GPX в контексте бота — это именно маршрут (план трека), а не GPX, экспортированный из уже записанной активности.

2.1 Как скачать FIT активности

Сервис Как скачать Что получится
Strava Откройте активность → меню Export Original. Исходный файл активности (часто .fit).
Garmin Connect Activities → откройте активность → значок шестерёнки → Export File / Export Original. .fit (обычно в zip-архиве).
Intervals.icu Откройте активность → страница данных активности (Activity Interval Data) → Download FIT file. .fit активности.
Komoot Komoot в первую очередь экспортирует GPX. Для FIT активности обычно лучше использовать исходный сервис записи (Garmin/Strava/часы). Обычно не основной источник FIT.

2.2 Как скачать GPX маршрута (именно маршрут)

Сервис Как скачать маршрут Что получится
TrailTrack trailtrack.ru → в планировщике накидайте маршрут → после входа через соцсети или регистрации скачайте GPX. .gpx запланированного маршрута.
Strava Раздел маршрутов (My Routes) → откройте нужный маршрут → экспорт GPX. .gpx запланированного маршрута.
Garmin Connect Раздел курсов/маршрутов (Courses) → откройте нужный курс → экспорт в GPX (или близкий формат маршрута). .gpx маршрута (или эквивалентный файл маршрута).
Intervals.icu Обычно маршрут лучше брать из сервиса планирования (Strava/Komoot/Garmin). Intervals.icu чаще используют как источник FIT активности. Рекомендуется GPX из планировщика маршрутов.
Komoot ProfileSaved routes → выберите маршрут → Download GPX file. .gpx маршрута.
Практика для лучшего результата: FIT берите из источника записи активности, а GPX — из того места, где вы планировали маршрут.
Если готового маршрута нет, можно бесплатно построить и скачать GPX в gpx.studio.

Источники: Strava Exporting your Data, Strava: Exporting Files from Garmin Connect, Intervals.icu Forum: download FIT, Komoot Export/Import Routes and Activities.

3. Быстрый Старт

Главное правило: FIT обязателен, GPX опционален. Если GPX не приложен, исправление идёт только по данным FIT. Если GPX приложен, бот использует его как эталон формы маршрута для более точной привязки.
Между сообщениями действует окно ожидания файлов: обычно 60 секунд. Если сначала отправили параметры, успейте дослать FIT/GPX в это окно. Если GPX под рукой нет — в этом же окне можно нажать «Выбрать GPX из каталога».

Вариант А: только FIT (самый простой)

  1. Отправьте FIT-файл в @fitroutefixerbot.
  2. В течение окна ожидания можно: дослать GPX, нажать «Начать» или выбрать маршрут из каталога.
  3. Получите отчёт, превью и исправленный FIT.

Вариант Б: FIT + GPX (когда важна геометрия маршрута)

  1. Опционально отправьте текст с параметрами.
  2. Отправьте FIT и GPX: можно одним сообщением или по очереди.
  3. Если отправляете по очереди, удобный порядок: параметры → FIT → GPX.
  4. Получите отчёт, превью наложения и исправленный FIT.

Этапы усложнения

# 1) Базово — вообще без текста, только FIT
# 2) Добавить GPX и базовые настройки маршрута
sync=unstable
# 3) Добавить GPX и при необходимости режимы
start_km=10 sync=unstable ignoregps=blend

4. Каталог GPX

Каталог общий для всех пользователей. Можно быстро выбрать подходящий GPX без ручной загрузки файла.

Как выбрать GPX из каталога

  1. Отправьте FIT и дождитесь кнопок в окне ожидания файлов.
  2. Нажмите «Выбрать GPX из каталога».
  3. Выберите один из вариантов (до 5): показываются название, старт, длина маршрута, дистанция до вашего старта и популярность.
  4. После выбора бот запускает обработку сразу с выбранным GPX.

Как добавить GPX в каталог

addgpx="2026-04-03T07:15:30+03:00" name="Ночной забег"
  • addgpx обязательно должен содержать timezone (например +03:00).
  • name — опционально, это понятное название маршрута для списка.
  • После добавления бот сообщает ID маршрута — его удобно использовать для дальнейших правок названия через модератора.

5. Как Писать Параметры

Параметры можно писать в свободном порядке:

start_km=<км> [sport=<тип>] [флаги] [ключ=значение]
  • FIT обязателен. Без него бот не запустит обработку.
  • GPX не обязателен. Но нужен для привязки трека к маршруту.
  • FIT и GPX можно отправить вместе в одном сообщении или по очереди.
  • После сообщения с параметрами обычно есть 60 секунд, чтобы дослать файлы.
  • start_km=... — от какого километра GPX начинать наложение маршрута. По умолчанию 0.
  • start_km<0 — срезать начало GPX на указанное количество км (например -2 → срезать первые 2 км).
  • Совместимость: формат “первое число в сообщении” тоже поддерживается, но лучше использовать явный start_km=....
  • cutgpx=start[,end] — явная подрезка GPX по километрам (start обязателен, end опционален).
  • sportrun, bike, walk и т.д.
  • Ключи: target=42.2, anchor=10, snap=80, sync=unstable.
  • Флаги: ignoregps, nooffroute, pausefix, pausecut.
  • Для каталога: addgpx="...+TZ" и опционально name="Название".
Важно: базовый запуск — это FIT без текста.

5.1 Маршрутизация (GPX)

Команда Что делает По умолчанию Пример
start_km=...От какого километра GPX начинать привязку трека к маршруту. Если указать отрицательное значение, бот срежет начало GPX на это количество км (например start_km=-2).0 кмstart_km=10
cutgpx=start[,end]Подрезать GPX по диапазону километров перед обработкой: от start до end (если указан). В каталог сохраняется уже подрезанная копия, оригинальный файл не изменяется.Выключенcutgpx=5,42
sync=stable|unstableРежим маршрутизации по GPX: stable — стандартный, unstable — для сложных участков. Работает только если приложен GPX.stablesync=unstable
snap=...Допуск отклонения от GPX в метрах. Меньше значение — строже привязка к маршруту, больше — мягче.100 мsnap=80
elevatesyncПредварительно восстанавливает темп по профилю высот FIT/GPX (особенно полезно в горных активностях если был потерян корректный темп без GPS). Нужен GPX с тегами высоты <ele>.Выключенelevatesync
ignoregps[=fit|hold|blend]Игнорировать входной GPS и строить маршрут по GPX. Режим хвоста: fit — сразу вернуть исходный FIT, hold — удерживать конец GPX, blend — плавно перейти обратно в FIT.Выключен; при включении blendignoregps или ignoregps=hold
nooffrouteОтключить проверку “не ушёл ли трек с маршрута”. По умолчанию при сильном отклонении бот ждёт возврата на маршрут, а не жёстко тянет трек к GPX. Работает только если приложен GPX.Проверка включенаnooffroute
Когда включать elevatesync: в горных активностях, когда на подъёмах/спусках датчик скорости не считает темп/скорость.

5.2 Фильтрация GPS

Команда Что делает По умолчанию Пример
maxspeed=...Ручной порог скорости (км/ч) для отсева GPS-выбросов. Альтернатива maxpace, вместе не используются.Авто-порог из данныхmaxspeed=65
maxpace=...Ручной порог темпа (мм:сс на км) для отсева выбросов. Альтернатива maxspeed, вместе не используются.Авто-порог из данныхmaxpace=2:30
anchor=...Опорный километр как фильтр против стартовых лучей/телепортов.Выключенanchor=10
nointerpОтключить интерполяцию GPS в разрывах.Интерполяция включенаnointerp
nodistspikefixОтключить чистку скачков distance/pace.Clean-up включёнnodistspikefix

5.3 Паузы

Команда Что делает По умолчанию Пример
pausefixПопытка восстановить пропущенные паузы.Выключенpausefix
pausemode=avg|elapsedavg: оставляет время только на движение и убирает лишнюю паузу из дальнейшего времени. elapsed: сохраняет весь фактический разрыв времени между точками.avgpausefix pausemode=elapsed
pausemin=...Минимальный сдвиг GPS (м), который трактуется как движение при pausefix.100 мpausemin=120
pausecutВырезать стоячие паузы из активности.Выключенpausecut
pausecutmin=...Минимальная длительность паузы (сек), чтобы вырезать её.30 секpausecutmin=30
pausecutmove=...Максимум движения (м), который ещё считается стоянием.15 мpausecutmove=15
Подсказка: начинайте с базового запуска (FIT без параметров), затем добавляйте по 1 параметру и сравнивайте отчёт.
Осторожно: pausecut может срезать очень медленное движение.

5.4 Модификаторы Метаданных

Команда Что делает По умолчанию Пример
sportПрофиль активности; влияет на рабочие пороги и поведение фильтрации.auto (из FIT)sport=<тип>
target=...Целевая итоговая дистанция (км) для no-GPS участков.Выключенtarget=42.2
setstart=...Вручную задаёт новое время старта активности.Оставить исходное время FITsetstart="2026-04-03 07:15:30"
addgpx=...Добавляет GPX в общий каталог (дата/время старта с timezone).Выключенaddgpx="2026-04-03T07:15:30+03:00"
name=...Понятное название маршрута в каталоге.Автоназваниеname="Ночной забег"

6. Готовые Сценарии

Базово: только обработать FIT

Без параметров, без GPX.

(просто отправьте FIT файл боту)

Проблемный старт GPS

Стартовые лучи/телепорты до определённого километра.

anchor=10
start_km=10 anchor=10 nooffroute

Сложная геометрия маршрута

Перекрёстки, развороты, нестабильная привязка к маршруту.

start_km=10 sync=unstable
start_km=10 elevatesync
start_km=10 sync=unstable ignoregps=blend
cutgpx=5,42 sync=unstable
start_km=-2 sync=stable

Контроль пауз

Добавить/вырезать паузы.

pausefix pausemode=elapsed pausemin=120
pausecut pausecutmin=30 pausecutmove=15

Пороги выбросов GPS

Когда авто-порог нужно скорректировать вручную.

maxspeed=75
maxpace=2:30

Служебные флаги

Отключение отдельных этапов обработки.

nointerp nooffroute
nodistspikefix

Добавить маршрут в каталог

Когда хотите использовать GPX повторно без переотправки файла.

addgpx="2026-04-03T07:15:30+03:00" name="Забег 10к"

Сдвиг времени старта

Когда в активности неверно указано время начала.

setstart=\"2026-04-03 07:15:30\"

7. Частые Ошибки

  • start_km=10 как базовая команда: это уже изменённая точка старта маршрутизации, не базовый режим.
  • Неверный anchor: если указать опорный км не в том месте, бот может взять не тот участок маршрута.
  • Слишком много параметров сразу: добавляйте по одному и проверяйте отчёт.
  • Ожидание формы маршрута без GPX: без GPX бот не знает геометрию маршрута.
  • Неверный addgpx без timezone: используйте только формат с часовым поясом, например +03:00.
  • Слишком агрессивный pausecut: может съесть медленный участок.
Рекомендуемый порядок: FIT без параметров → затем добавить только один параметр → затем GPX и sync-режим.

8. Как Загрузить Исправленный FIT Обратно

После обработки бот отдаёт исправленный .fit. Ниже — как загрузить его обратно как активность.

8.1 Загрузка активности (только FIT)

Сервис Как загрузить Прямая ссылка
Strava Откройте страницу загрузки → выберите файл .fit (или перетащите его). strava.com/upload/select
Garmin Connect Откройте импорт в веб-версии Connect → выберите ваш .fit → загрузите. Если файл в zip, сначала распакуйте. connect.garmin.com/modern/import-data
Intervals.icu В веб-кабинете Intervals.icu загрузите файл активности .fit через импорт файлов активности. app.intervals.icu
Komoot Profile → Completed activities → Import a GPS file, затем выберите .fit. Инструкция Komoot

Источники: Strava: How to get your Activities to Strava, Strava: Exporting Files from Garmin Connect, Intervals.icu: Upload .fit files for activities, Komoot Export/Import.

Перед загрузкой обратно можно визуально проверить итоговый FIT в fitfileviewer.com, чтобы увидеть, нет ли артефактов и нужно ли дополнительное исправление.

9. Контакты

По вопросам работы бота, ошибкам, предложениям и улучшениям пишите разработчику.

Разработчик: Олег Карнаухов

Telegram: @Bupycnet