Руководство пользователя

Программа: ТРЭК.Основание Версия документа: 2.0 Год: 2026

---

Для кого этот документ

Документ адресован специалисту по дорожной модели (ГИС-редактору, транспортному инженеру), который рисует и правит дорожную сеть и готовит из неё детальную пополосную модель перекрёстков. Читатель может никогда не видеть продукт: документ последовательно описывает, что это за система, как в неё войти, что расположено на каждом рабочем экране, за что отвечает каждый элемент управления и как выполнить типовую задачу шаг за шагом.

Что документ описывает: пользовательский интерфейс продукта — рабочие экраны, панели, формы, инструменты редактирования и просмотра, типовые сценарии работы, действия в нештатных ситуациях.

Что документ не описывает: установку и администрирование серверной части, внутренние алгоритмы построения модели, программные интерфейсы для внешних систем. Руководство системного администратора выпускается отдельно (см. § 1.4).

ТРЭК.Основание поставляется двумя рабочими местами, построенными на одной и той же редакторской основе и различающимися только тем, откуда приходит личность пользователя и куда уходит готовый результат:

Карта документа

---

1. Введение

1.1. Область применения средства автоматизации

ТРЭК.Основание применяется при подготовке детальной пополосной модели дорожной сети (HD-модели) для задач организации и моделирования дорожного движения: проектирования светофорного регулирования, транспортного моделирования, расчёта пропускной способности, подготовки исходных данных для симуляции и для систем помощи водителю.

Система берёт общедоступную карту, на которой различимы улицы, но не различимы полосы, и помогает довести её до модели, в которой явно представлены каждая полоса движения, каждый разрешённый манёвр на перекрёстке и каждая точка конфликта траекторий. Пользователь рисует дорогу так, как видит её со спутникового снимка, и задаёт параметры полос; система по этим данным автоматически достраивает перекрёстки, манёвры, конфликтные точки, разметку и связи между видами транспорта.

Редактор работает в режиме «что видишь — то и получаешь»: изменение параметра отражается на карте результата в соседней панели.

1.2. Краткое описание возможностей

• Создание рабочей области четырьмя способами: по текущему виду карты, по нарисованному на карте контуру, по границе, введённой текстом (GeoJSON, WKT, bbox, список координат), и из локального файла выгрузки (.osm, .xml, .pbf).
• Пополосное редактирование — число полос, ширина полос, направление, повороты по полосам, связность полос, карманы остановок, парковочные полосы, разметка перехода, форма и радиусы перекрёстка; создание, изменение, удаление и разделение объектов сети; отношения ограничения манёвров и отношения связности.
• Описание светофорного объекта — светофорные узлы, направление и режим светофора, кнопка вызова, средства детектирования транспорта (тип, назначение, режим, направление, длина зоны, распределение по полосам).
• Описание обстановки — опоры, мачты, уличное освещение, дорожные знаки как атрибуты объектов открытой карты (см. границы применимости ниже).
• Автоматическое построение модели — каркас соединений, перекрёстки и составные перекрёстки, стоп-линии, маршруты, дорожный полигон, конфликтные точки, дорожная разметка, обобщённый граф. Каждый этап построения включается и выключается отдельно.
• Мгновенный просмотр результата на второй панели рядом с редактируемыми данными, поверх спутникового снимка, в двух видах — «Каркас соединений» и «Полигоны и разметка».
• Контроль изменений — накопление правок в наборе изменений, просмотр списка правок с фильтрами и поиском, сравнение «до/после», многоуровневая отмена и повтор, выгрузка правок в файл обмена, полный сброс правок.
• Работа с фондом областей — перечень областей с фильтрами, сортировкой, показом на карте, открытием на правку или на просмотр, копированием и удалением. В рабочем месте организации виден фонд областей стенда (с фильтром «Мои»), там же доступны групповые операции и смена назначения результата. В свободной версии перечень содержит только собственные области, а куратору витрины дополнительно доступна выборка областей всех пользователей.
• Обстановка территории на карте — накладываемые слои: дорожная сеть, стрелки и знаки, маршруты общественного транспорта с разбивкой по видам, остановки, обобщённый граф; выбор территории из реестра.
• Витрина образцов («Галерея крутых бэйков») — публичный перечень заранее подготовленных областей с превью, описанием и тегами; образец можно открыть на просмотр или скопировать себе и продолжить с него.
• Передача результата — заявка на слияние в конвейер обработки (рабочее место организации) либо транзакция публикации в открытую карту (свободная версия).
• Совместная работа — публичный просмотр области по ссылке в режиме «только чтение», короткая ссылка, копирование чужой области себе, перенос области с другого экземпляра системы по ссылке или идентификатору.
• Выгрузка результата — GeoJSON (файлом, в буфер обмена, по прямой ссылке, во внешний просмотрщик) и Shapefile с выбором слоёв.

Границы применимости (что система в этой части не делает). Дорожные знаки как объекты модели не строятся: их атрибуты можно проставить объектам открытой карты, но в построенной модели регулирование представлено светофорами, сигнальными группами, средствами детектирования и разметкой. Тоннели и мосты учитываются как уровень прохождения (+1/+2, −1/−2), а не как самостоятельные объекты со своей семантикой. Троллейбус присутствует только как маршрутная линия общественного транспорта; выделенной троллейбусной инфраструктуры, в отличие от трамвайной, нет. Преобразование модели во внешние обменные форматы дорожных сетей (форматы симуляторов и систем автоматизированного проектирования) настоящим продуктом не выполняется — это задача смежного продукта линейки.

1.3. Уровень подготовки пользователя

Продукт рассчитан на специалиста предметной области, а не на разработчика. Для самостоятельной работы достаточно следующей подготовки.

Ручной структурный редактор свойств (§ 4.4) предполагает более высокую квалификацию — понимание словаря ключей карты. Он не обязателен: весь типовой объём правки выполняется контекстной панелью быстрых параметров.

Первичное освоение по разделу 6 занимает у подготовленного специалиста ориентировочно один рабочий день; уверенная работа с параметрами построения модели приходит после нескольких разобранных перекрёстков.

1.4. Перечень эксплуатационной документации

Перед началом работы необходимо ознакомиться с документами:

1. Настоящее руководство пользователя — ТРЭК.Основание.
2. «Руководство системного администратора. Платформа ТРЭК» и поставляемая часть руководства системного администратора — состав поставки, развёртывание, учётные записи и роли, резервное копирование, восстановление, диагностика. Пользователю необходимо знать из него: адрес стенда, порядок получения учётной записи и роли, контакты администратора стенда.

1.5. Термины и сокращения

Термины взяты из интерфейса и из глоссария предметной области. При первом употреблении в тексте термин поясняется; полный перечень — ниже.

---

2. Назначение и условия применения

2.1. Виды деятельности и функции, для автоматизации которых предназначен продукт

Продукт автоматизирует подготовку исходных геоданных для инженерных расчётов в области организации дорожного движения. Автоматизируемые функции:

2.2. Условия применения

Целевые операционные системы.

Серверная часть разворачивается администратором на отечественных операционных системах из единого реестра российского ПО — Astra Linux Special Edition 1.7 и 1.8 либо Альт p11 (архитектура x86-64). Продукт работает в веб-браузере, особых требований к операционной системе рабочего места не предъявляется.

Рабочее место пользователя. Современный браузер (Chrome, Яндекс.Браузер, Firefox) последних версий; минимальное разрешение экрана 1920×1080 — интерфейс картоцентричный, на меньшем разрешении панели перекрывают карту. Отдельная установка программы на компьютер пользователя не требуется. Рабочий экран редактора двухпанельный, поэтому широкоформатный монитор существенно повышает удобство работы; панель просмотра изменений занимает по ширине около 1060 точек.

Серверное окружение. Разворачивается и обслуживается администратором стенда: служба построения модели с хранилищем рабочих областей, служба единой аутентификации, служба картографической подложки и слоёв территории, конвейер обработки геоданных. Состав — в руководстве системного администратора, порядок развёртывания — в поставляемой части руководства системного администратора.

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

Входная информация.

Требования к подготовке специалистов. См. § 1.3. Дополнительно: пользователь должен получить у администратора стенда учётную запись и роль, соответствующую кругу его задач (§ 3.2), а для свободной версии — иметь учётную запись открытого картографического сообщества.

---

Персональные данные. Продукт не обрабатывает персональные данные.

3. Подготовка к работе

3.1. Состав и содержание поставки

Продукт поставляется как веб-приложение: устанавливать и настраивать что-либо на рабочем месте пользователя не требуется. Администратор развёртывает серверную часть и сообщает пользователю адрес стенда. Приложение открывается по адресу вида https://<адрес стенда>/app/.

Дистрибутив на рабочее место не передаётся. Обновление версии выполняется на сервере и становится доступно пользователю после перезагрузки страницы.

Язык интерфейса (русский или английский) задаётся при развёртывании стенда; переключателя языка внутри рабочего экрана нет. Для рабочего места организации по умолчанию используется русский язык, для свободной версии — английский.

3.2. Порядок загрузки и вход в систему

1. Открыть в браузере адрес стенда.
2. Дождаться отображения карты. Часть возможностей (витрина образцов, публичный просмотр области по ссылке, обстановка территории, выбор подложки) доступна без входа.
3. Выполнить вход:
   • Рабочее место организации. В правом верхнем углу нажать «Войти». Открывается страница единого провайдера идентичности платформы. После ввода учётных данных браузер кратковременно показывает служебный экран «Завершаем вход в Основание…» и возвращает пользователя на ту страницу, с которой был начат вход. Вместо кнопки входа появляется плашка учётной записи с инициалами и именем пользователя.
   • Свободная версия. В верхней части экрана нажать «Войти». Вход выполняется по учётной записи открытого картографического сообщества. После возврата кнопка показывает имя вошедшего участника; повторное нажатие выполняет выход.
4. При необходимости выбрать территорию — выпадающий список в нижней части панели слоёв (правый нижний угол). Список появляется, только если реестр территорий на стенде непустой. Если центр карты не попадает ни в одну территорию, в свёрнутом виде контрол показывает приглашение «Выбрать город».
5. Выбрать рабочую область: открыть существующую из перечня областей либо создать новую (§ 4.9.1–4.9.4).

Права доступа. Набор доступных действий определяется ролью:

Недоступное действие остаётся видимым, но заблокированным, и снабжается подсказкой с причиной: «Нужна роль editor или admin», «Нужна роль editor (свой bake) или admin», «Сменить тип может только админ», «Удалять может только админ», «Push на merge доступен только владельцу bake или админу».

Учётная запись имеет тарифный план (Free, Pro, Enterprise, Unlimited), ограничивающий максимальную площадь одной рабочей области. Текущий план и его пределы показаны в плашке учётной записи: чип с названием плана и всплывающая подсказка вида «Бэйк до N км², проектов до M».

3.3. Порядок проверки работоспособности

Проверка выполняется пользователем перед началом работы и после каждого сообщения администратора об обновлении стенда. Все шаги — только чтение, данные не меняются.

Если шаги 1–3 выполняются, а шаги 4–9 — нет, неисправность локальна для соответствующей службы; порядок действий — в разделе 5. Если не выполняется шаг 1, следует обратиться к администратору стенда.

---

4. Описание операций

Раздел описывает композицию экранов, назначение каждого элемента управления и порядок выполнения рабочих операций. Точные подписи приведены так, как они выведены в интерфейсе. Часть служебных подписей выведена латиницей — они приводятся дословно.

4.1. Состав экранов

4.2. Главный экран рабочего места организации

Экран занят картой во весь размер окна; элементы управления расположены поверх карты плавающими панелями.

4.2.1. Панель команд (верх слева)

Кнопки создания области заблокированы, пока пользователь не вошёл, пока у него нет роли редактора и пока карта недостаточно приближена (подпись меняется на «Увеличить масштаб...»). Порог приближения для рисования контура ниже, чем для загрузки текущего вида.

4.2.2. Плашка учётной записи и подложка (верх справа)

Кнопка «Завершить сессию» гасит общую сессию входа: следующий вход в любой сервис платформы потребует пароль. Уже открытые вкладки других сервисов продолжают работать до истечения собственного срока действия сессии.

4.2.3. Перечень областей

Выдвижная панель слева, открывается кнопкой-переключателем.

Фильтры (первый ряд).

Значения назначения результата:

Строка области. Флажок выделения; значок «человек» с подсказкой «Ваш bake» для собственных областей; имя автора и дата создания; цветной значок назначения (нажатие раскрывает список смены назначения — только администратору); значок «галерея» у областей витрины; индикатор наличия правок (зелёная точка — правки есть, серая — нет); кнопки «показать на карте», «редактировать», «клонировать». Область, отправленная на слияние, не клонируется — подсказка «Бейк отправлен на мердж — клон недоступен».

Над списком — флажок «Select all» и счётчик «выбрано/всего». При пустом списке выводится «No bakes».

Групповые операции (появляются при выделении).

Карточка выбранной области. Появляется в правом нижнем углу при выборе контура области на карте, когда перечень закрыт. Показывает назначение, автора и дату, а также действия над одной областью: «Открыть», «Клонировать», «Удалить», «Статус», Reset CS, Reload, Copy ID.

4.2.4. Панель слоёв и выбор территории

Панель в правом нижнем углу. Каждая строка — слой; переключается щелчком по индикатору.

Ниже — блок выбора территории: свёрнутый контрол показывает текущий город либо приглашение «Выбрать город». Раскрытие даёт список территорий; при числе территорий больше восьми появляется строка поиска, при отсутствии совпадений выводится «Ничего не найдено». Блок скрывается целиком, если реестр территорий пуст.

Слои и территория влияют только на отображение и не изменяют данные. Слои загружаются начиная с определённого приближения карты; на мелком масштабе они пусты.

4.3. Главный экран свободной версии

Отличается составом верхней панели, способом входа и наличием перечня «Мои бейки» в левом нижнем углу.

Отличия от § 4.2:

• Вход — кнопка в верхней части экрана, показывающая имя участника или «Войти». Плашки учётной записи платформы нет.
• Команда «Загрузить OSM файл» вынесена отдельной кнопкой; пункта «Импорт бейка по URL» нет.
• При первом посещении открывается приветственное окно с условиями участия: предупреждение об экспериментальном характере редактора, о том, что результат построения может расходиться с ожиданиями, что велосипедные полосы нестабильны, что набор изменений хранится на сервере без гарантии долговременного хранения и что правки остаются локальными до отправки в открытую карту. Внизу — ссылки на документацию и на список известных проблем и кнопка «Понятно, поехали!».
• Внизу по центру — кнопки Documentation и Issues, открывающие внешние ресурсы проекта.
• Перечень областей называется «Мои бейки», открывается одноимённой кнопкой в левом нижнем углу и доступен только после входа.

Перечень «Мои бейки».

Состояния списка: «Загрузка…»; «Не удалось загрузить список» с кнопкой «Повторить»; «Бейков пока нет — нарисуйте область на карте»; «Под фильтры ничего не подходит».

4.4. Двухпанельный редактор — левая панель (правка исходных данных)

Основной рабочий экран разделён перетаскиваемым вертикальным разделителем на две карты: слева — редактируемые исходные данные, справа — мгновенно перестраиваемая модель.

4.4.1. Верхняя панель левой карты

В режиме «только чтение» кнопки отмены, повтора и счётчика шагов скрыты, а в правом нижнем углу левой панели выводится отметка «Режим только для чтения».

4.4.2. Инструменты правки (вертикальный ряд справа на левой карте)

4.4.3. Контекстная панель быстрых параметров

Появляется в левом нижнем углу при выборе объекта на левой карте и показывает только те параметры, которые имеют смысл для выбранного объекта и ещё не заданы:

• зелёные кнопки «+ ключ: значение» добавляют параметр. Кнопка составная: нажатие на левую часть ставит первое (типовое) значение, нажатие на стрелку раскрывает полный список значений;
• красные кнопки «× ключ: значение» удаляют уже заданный параметр.

Состав предлагаемых параметров:

Примечание о границах. Палитра предлагает атрибуты открытой карты для выбранного элемента. Часть из них — в первую очередь атрибуты дорожных знаков — сохраняется как данные открытой карты, но не порождает объектов в построенной модели: в модели регулирование представлено светофорами, сигнальными группами, средствами детектирования и разметкой.

4.4.4. Структурный редактор свойств

Раскрывается кнопкой с изображением листа с карандашом рядом с контекстной панелью. Текстовый редактор свойств выбранного объекта в структурированном виде с подсветкой синтаксиса, проверкой корректности и автоподсказками по известным ключам; новые и изменённые строки подсвечиваются относительно исходного состояния. Дополнительно: кнопка «упорядочить теги А-Я» и кнопка «wiki», открывающая справку по ключу текущей строки. В режиме «только чтение» редактор доступен на просмотр.

Рядом выводится тип и идентификатор выбранного объекта; для объекта, уже существующего в открытой карте, доступна кнопка открытия его карточки на openstreetmap.org.

4.4.5. Служебные элементы левой панели

4.5. Двухпанельный редактор — правая панель (модель)

Правая карта показывает построенную модель и перестраивается при изменении данных или параметров построения.

Дополнительно в меню параметров доступны поля пользовательской растровой подложки (custom raster tiles url) и смещения подложки по осям (tiles offset X (m), tiles offset Y (m), диапазон от −100 до 100 метров) — для точного совмещения снимка с моделью.

4.6. Модальные окна

4.6.1. Диалог загрузки файла выгрузки

Открывается командой «Загрузить OSM файл». Содержит:

• зону перетаскивания — «Перетащите .osm или .osm.pbf файл»; принимаются .osm, .xml, .pbf; после выбора показываются имя файла и его размер;
• выбор файла — поле «Или выберите файл»;
• фильтр «Типы дорог» — тот же список категорий, что и при импорте из карты;
• индикатор разбора — «Парсинг файла...» с указанием текущей фазы (чтение, разбор, фильтрация, преобразование) и процента выполнения;
• статистику после разбора — «{N} узлов», «{N} путей», «{N} отношений», «{N} всего в файле»;
• сообщение об ошибке — текст, полученный при разборе; при неразборчивом содержимом — «Невалидный OSM XML файл»;
• кнопки — «Отмена» и «Обработать файл», после разбора — «Загрузить в редактор».

Текстовые файлы (.osm, .xml) разбираются в браузере: пользователь видит ход разбора и статистику и подтверждает загрузку кнопкой «Загрузить в редактор»; охват и центр будущей области вычисляются по фактическим координатам содержимого файла. Двоичные файлы (.pbf) в браузере не разбираются — они передаются на сервер сразу после нажатия «Обработать файл», и редактор открывается без промежуточного подтверждения; охват и центр такой области берутся из текущего вида карты, поэтому перед загрузкой двоичного файла карту следует навести на нужное место.

4.6.2. Диалог «Загрузить границу»

Открывается из меню «Нарисовать для загрузки». Позволяет задать контур области текстом. Форматы перечислены в самом диалоге:

• «GeoJSON — Polygon, MultiPolygon, Feature или FeatureCollection»;
• «WKT — POLYGON((lon lat, lon lat, ...))»;
• «BBox — 4 числа: minLon, minLat, maxLon, maxLat»;
• «Список координат — по одной точке на строку: lat, lon».

Поле ввода — «Вставьте сюда GeoJSON / WKT / bbox / список lat,lon...»; кнопки «Применить» и «Отмена». При ошибке разбора выводится «Не удалось распарсить:» с пояснением.

4.6.3. Диалог «Импорт бейка по URL»

Доступен в рабочем месте организации из меню «Импорт». Поле «URL или ID бейка» принимает ссылку редактора, адрес программного интерфейса или просто идентификатор области; подсказка поясняет форматы. Кнопки — «Импортировать» и «Отмена». Сообщения: «Бейк импортирован»; «Не похоже на URL или ID бейка»; «Не удалось связаться с сервисом-источником»; «Бейк не найден на источнике»; «Не удалось импортировать бейк».

4.6.4. Витрина образцов «Галерея крутых бэйков»

Открывается кнопкой «Галерея». Вверху — пояснение о назначении витрины. Далее — ряд кнопок-тегов для отбора карточек (при большом числе тегов часть скрывается за кнопкой «… +N») и счётчик отобранных карточек. Карточка образца показывает превью, до трёх тегов, заголовок, краткое описание и пронумерованные шаги; при наведении в центре карточки появляются две круглые кнопки:

Состояния: «Загрузка витрины…»; «Не удалось загрузить витрину» с кнопкой «Повторить»; при отсутствии подходящих карточек — сообщение и кнопка сброса фильтров.

4.6.5. Диалог пометки области в витрину

Открывается кнопкой «В галерею» на правой панели редактора; доступен администратору продукта либо куратору витрины. Заголовок — «Добавить проект в галерею» или «Редактировать проект в галерее».

Кнопки: «Убрать из галереи» (активна для уже помеченной области), «Отмена», «Сохранить». Сообщения: «Карточка сохранена»; «Карточка убрана из витрины»; «Не удалось сохранить карточку: превью отклонено...»; «Не удалось сохранить карточку. Попробуйте ещё раз.».

4.6.6. Просмотр набора изменений

Открывается из верхней панели левой карты. Панель занимает правую часть окна.

• Заголовок — «Просмотр изменений» со сводкой по числу созданных, изменённых и удалённых элементов.
• Фильтры — флажки по типу («Узел», «Путь», «Отношение») и по операции («Создать», «Изменить», «Удалить»), у каждого — число элементов; поле «Поиск by ID».
• Список правок — время, номер шага и подпись операции, тип и идентификатор объекта, вид операции, тип дороги и название (если заданы). Опасные правки помечаются значком с предупреждением о возможном удалении узлов, принадлежащих незагруженным путям и отношениям. Выбор строки подсвечивает объект на карте и открывает сравнение.
• Сравнение «до/после» — блок «Редакция изменений [ до | после ]» с двухпанельным просмотром различий. Для отдельных объектов доступно ручное редактирование: Edit object manually → Save / Cancel.
• «Скачать .osc» — выгрузка набора изменений в файл обмена.
• «Сбросить все изменения» — очистка всех правок области; недоступна в режиме «только чтение».
• При пустом наборе выводится «Ничего не найдено» с пояснениями «здесь должен быть список объектов OSM» и «попробуйте изменить фильтры или внести изменения в данные».

Вверху панели выводится состояние области: сообщение о том, что работа принадлежит другому пользователю и доступна только для чтения; либо «Этот bake заморожен — был опубликован, дальнейшее редактирование закрыто»; либо, после успешной публикации в открытую карту, сообщение с номером транзакции и кнопками View on OSM и View on OSMCha.

4.6.7. Блок передачи результата

Расположен в верхней части просмотра набора изменений. Состав кнопок зависит от того, есть ли в наборе удаления или разделения объектов:

Форма подачи заявки на слияние (рабочее место организации). Заголовок — «Отправка в pipeline». Единственное обязательное поле — «Комментарий» (при пустом значении выводится «Комментарий обязателен»). Кнопки — «Отправить» и «Отмена». Направление подачи вычисляется системой по самой области и оператором не выбирается.

Форма публикации в открытую карту (свободная версия). Заголовок — «Применить к OSM». Поля: «Комментарий к вашим изменениям» (обязательный; рядом кнопка share link, добавляющая в комментарий короткую ссылку на область), Source (источники, множественный выбор с возможностью ввести своё значение), #Hashtags, и переключатель способа публикации из двух вариантов:

• отправить набор изменений целиком — все правки и все свойства уходят в открытую карту. Справка предупреждает, что набор может содержать свойства, новые для открытой карты, и что служебные свойства системы удаляются из набора всегда;
• отправить только общепринятые свойства — экспериментальные свойства (связность полос, форма и радиусы перекрёстка, угловой признак перехода, смещение полосы) отфильтровываются и сохраняются отдельно, чтобы при следующей загрузке вернуться к своим объектам.

4.7. Параметры построения модели

Открываются меню Options & defaults на правой панели редактора. Все линейные величины — в метрах; в режиме футов и дюймов рядом с полем показывается пересчёт.

Числовые параметры.

Этапы построения (флажки). Набор независимо включаемых этапов построения: каждый этап отвечает за свою часть модели, включается и выключается отдельным флажком. Отключение ненужного этапа ускоряет пересборку области (см. § 4.9.5). Строятся:

• соединения полос — автомобильных, а также трамвайных, велосипедных и пешеходных;
• стоп-линии;
• маршруты перекрёстков;
• поверхность дороги (дорожный полигон);
• конфликтные точки;
• дорожная разметка;
• обобщённый граф.

Прочие флажки. «Игнорировать way[highway=service]» — не учитывать служебные дороги; «Отображать бордюры и ограждения»; «Отрисовывать границу lanelet»; «Левостороннее движение».

Оптимизация трансформации. Выпадающий список профилей настройки геометрического конвейера построения. Значения: None (по умолчанию, без оптимизации), Lanelet2, OpenDRIVE (XODR), SUMO, Net329, Analytics. Профиль подстраивает построение модели под особенности конкретного применения; сам по себе выбор профиля модель во внешний формат не выгружает — преобразование во внешние обменные форматы выполняется отдельным продуктом линейки.

4.8. Ссылки и выгрузка результата

Выполняется из меню «Поделиться» на правой панели редактора. Меню содержит три вкладки: «Поделиться», «Благодарности», «О проекте».

Вкладка «Поделиться»:

При отсутствии построенного результата выводится «Нет данных для экспорта».

Дополнительно из просмотра набора изменений доступна выгрузка правок в файл обмена — «Скачать .osc».

Выгрузка охватывает представления самой модели (GeoJSON и Shapefile) и набор изменений. Преобразование модели в форматы внешних симуляторов дорожного движения настоящим продуктом не выполняется.

Вкладки «Благодарности» и «О проекте» — справочные: перечень использованных открытых компонентов и сведения об авторах продукта.

4.9. Рабочие операции

Операции описаны по шаблону п. 6.4.6 ГОСТ Р 59795-2021.

4.9.1. Создание рабочей области по текущему виду карты

• Наименование. Создание рабочей области по текущему виду карты.
• Условия выполнения. Выполнен вход; учётная запись имеет право создания областей; площадь будущей области не превышает предела тарифного плана.
• Подготовительные действия. Открыть главный экран; найти нужное место полем географического поиска либо панорамированием карты; приблизить карту так, чтобы подпись кнопки сменилась с «Увеличить масштаб...» на «Загрузить текущий вид».
• Основные действия.
  1. Раскрыть список типов дорог (кнопка со стрелкой рядом с кнопкой загрузки).
  2. Снять флажки с категорий, не нужных в работе. Флажок «Основная» снять нельзя — эта категория загружается всегда.
  3. Нажать «Загрузить текущий вид».
  4. Дождаться окончания загрузки (кнопка показывает индикатор выполнения).
• Заключительные действия. Открывается двухпанельный редактор с загруженным участком. Область автоматически появляется в перечне областей.
• Расходуемые ресурсы. Площадь области ограничена тарифным планом учётной записи (пределы видны в подсказке плашки учётной записи). Время загрузки зависит от площади области и плотности дорожной сети в ней.

4.9.2. Создание рабочей области по контуру или по текстовой границе

• Наименование. Создание рабочей области произвольной формы.
• Условия выполнения. Те же, что в § 4.9.1. Для рисования контура требуется меньшее приближение карты, чем для загрузки текущего вида.
• Подготовительные действия. Отобрать категории дорог, как в § 4.9.1.
• Основные действия.
  • Рисованием: открыть меню «Нарисовать для загрузки» → пункт «Нарисовать для загрузки»; обвести участок на карте, замкнув контур двойным щелчком. Для прекращения рисования нажать «Отмена» либо клавишу Esc.
  • Текстом: открыть то же меню → пункт «Загрузить границу»; вставить границу в одном из поддерживаемых форматов (§ 4.6.2); нажать «Применить».
• Заключительные действия. Открывается редактор с загруженным участком.
• Расходуемые ресурсы. См. § 4.9.1.

4.9.3. Создание рабочей области из файла выгрузки

• Наименование. Создание рабочей области из локального файла.
• Условия выполнения. Выполнен вход; есть право создания областей; файл имеет расширение .osm, .xml или .pbf.
• Подготовительные действия. Подготовить файл выгрузки на рабочем месте.
• Основные действия.
  1. Нажать «Загрузить OSM файл» (в рабочем месте организации — меню «Импорт» → «Загрузить OSM файл»).
  2. Перетащить файл в зону перетаскивания либо выбрать его полем «Или выберите файл».
  3. При необходимости уточнить фильтр «Типы дорог».
  4. Нажать «Обработать файл» и дождаться завершения разбора.
  5. Для текстового файла: проверить статистику (число узлов, путей, отношений) и нажать «Загрузить в редактор». Для двоичного файла эти шаги не требуются — редактор открывается сразу по окончании передачи на сервер.
• Заключительные действия. Область создаётся из файла и открывается в редакторе. Для текстового файла охват и центр вычисляются по фактическим координатам его содержимого; для двоичного файла — берутся из текущего вида карты.
• Расходуемые ресурсы. Текстовые файлы разбираются в браузере — время разбора и потребление памяти растут с размером файла; двоичные файлы передаются на сервер, что требует времени на передачу. Размер файла ограничивается на стороне сервера.

4.9.4. Перенос области с другого экземпляра системы

• Наименование. Импорт области по ссылке или идентификатору.
• Условия выполнения. Рабочее место организации; выполнен вход; есть право создания областей; экземпляр-источник доступен по сети.
• Подготовительные действия. Получить ссылку редактора, адрес программного интерфейса либо идентификатор области на экземпляре-источнике.
• Основные действия. Меню «Импорт» → «Импорт бейка по URL» → вставить значение в поле «URL или ID бейка» → «Импортировать».
• Заключительные действия. Выводится «Бейк импортирован»; копия появляется в перечне областей.
• Расходуемые ресурсы. Время переноса определяется объёмом области и скоростью соединения с экземпляром-источником.

4.9.5. Пополосная разметка перекрёстка

• Наименование. Доведение перекрёстка до корректной пополосной модели.
• Условия выполнения. Область открыта в редакторе; пользователь — владелец области; область не переведена в режим «только чтение».
• Подготовительные действия. Приблизить обе панели к нужному перекрёстку; при необходимости выбрать подходящую подложку и выставить смещение подложки (§ 4.5), чтобы снимок точно совпадал с данными.
• Основные действия.
  1. Выбрать на левой карте подход к перекрёстку (линейный объект).
  2. В контекстной панели задать число полос, при необходимости — ширину полос, повороты по полосам, односторонность, смещение оси.
  3. При наличии парковки или кармана остановки задать соответствующие параметры.
  4. Выбрать узел перекрёстка и задать его тип (регулируемый / нерегулируемый), радиус скругления и форму.
  5. Для регулируемого перекрёстка задать параметры светофора и, при необходимости, средства детектирования.
  6. Повторить для остальных подходов.
  7. При необходимости задать явную связность полос и отношения ограничения манёвров (инструмент «Добавить новое отношение»).
  8. Наблюдать, как правая панель перестраивает каркас соединений, стоп-линии, конфликтные точки и разметку. Если пересчёт не произошёл автоматически, нажать «Обновить» (клавиша «Пробел»).
  9. Проверить результат в обоих видах — «Каркас соединений» и «Полигоны и разметка».
• Заключительные действия. Нажать «Обновить» — модель пересобирается и область сохраняется на сервере.
• Расходуемые ресурсы. Время пересборки растёт с размером области и числом включённых этапов построения. Отключение ненужных этапов (например, построения дорожной разметки на время черновой правки) заметно сокращает время ожидания.

4.9.6. Отмена, повтор и просмотр истории правок

• Наименование. Управление набором изменений.
• Условия выполнения. Область открыта в редакторе на правку.
• Основные действия.
  1. Отмена — кнопка «Отменить» или Ctrl+Z; повтор — кнопка «Повторить» или Ctrl+Shift+Z.
  2. Для просмотра всей истории нажать счётчик шагов или сводку изменений — открывается «Просмотр изменений».
  3. Отфильтровать список по типу объекта и виду операции, при необходимости найти объект по идентификатору.
  4. Выбрать строку — объект подсвечивается на карте, ниже открывается сравнение «до/после».
• Заключительные действия. Закрыть панель. При необходимости выгрузить набор изменений кнопкой «Скачать .osc» либо очистить его кнопкой «Сбросить все изменения».
• Расходуемые ресурсы. История правок хранится вместе с областью на сервере; длинная история увеличивает время сохранения области.

4.9.7. Передача результата в конвейер обработки

• Наименование. Подача заявки на слияние.
• Условия выполнения. Рабочее место организации; область открыта в редакторе; пользователь — владелец области с ролью редактора либо администратор продукта; область отнесена к одной из территорий реестра; область ещё не публиковалась.
• Подготовительные действия. Убедиться, что модель построена и выглядит корректно; при наличии удалений или разделений объектов выполнить согласование зависимых связей кнопкой Fix relations & ways.
• Основные действия.
  1. Нажать «Отправить в pipeline» в верхней панели левой карты — открывается просмотр набора изменений.
  2. Нажать «Отправить в pipeline» в блоке передачи результата — раскрывается форма «Отправка в pipeline».
  3. Заполнить обязательное поле «Комментарий».
  4. Нажать «Отправить».
• Заключительные действия. Выводится подтверждение «Отправлено: {N} (request: {идентификатор})». Идентификатор заявки следует сохранить: экран намеренно не перезагружается, чтобы оператор успел его скопировать. Область переводится в режим «только чтение»; повторная подача в то же направление отклоняется сообщением «Bake уже опубликован — повторно нельзя».
• Расходуемые ресурсы. Заявка обрабатывается конвейером асинхронно; время обработки от продукта не зависит.

Подача выполняется только из редактора. Групповой подачи из перечня областей нет: подаётся именно то, что оператор перед этим видел на экране.

4.9.8. Возврат результата в открытую карту

• Наименование. Публикация набора изменений в открытую карту.
• Условия выполнения. Свободная версия; область открыта в редакторе; пользователь — владелец области; набор изменений непуст.
• Подготовительные действия. При наличии удалений или разделений объектов выполнить Fix relations & ways. При подозрении на устаревание исходных данных выполнить Reload OSM data.
• Основные действия.
  1. Нажать «Применить к OSM» (или Ctrl+S) — открывается просмотр набора изменений.
  2. Нажать «Применить к OSM» в блоке передачи результата.
  3. Заполнить обязательный комментарий; при необходимости добавить короткую ссылку кнопкой share link, указать источники и хештеги.
  4. Выбрать способ публикации: набор целиком либо только общепринятые свойства.
  5. Подтвердить публикацию.
• Заключительные действия. Выводится сообщение об успешном применении с номером транзакции и ссылками View on OSM и View on OSMCha. Область переводится в режим «только чтение».
• Расходуемые ресурсы. Публикация выполняется одной транзакцией; при конфликте версий требуется перечитать исходные данные и повторить.

4.9.9. Работа с фондом областей

• Наименование. Ведение перечня рабочих областей.
• Условия выполнения. Выполнен вход. Групповые операции и смена назначения — при наличии соответствующей роли.
• Подготовительные действия. Открыть перечень областей.
• Основные действия.
  1. Отобрать нужные области фильтрами (текущий вид карты, свои, назначение, наличие правок; в свободной версии дополнительно — сортировка по дате создания или правки).
  2. Выполнить действие над одной областью: показать на карте, открыть в редакторе или на просмотр, клонировать, удалить, сменить назначение.
  3. Для группового действия отметить флажками несколько областей (или Select all) и нажать нужную кнопку: Delete, Status, Reset CS, Reload, Copy IDs.
• Заключительные действия. Список перечитывается автоматически. Удаление запрашивает подтверждение и необратимо.
• Расходуемые ресурсы. Групповые операции выполняются последовательно; при большом выделении операция занимает заметное время. Если часть областей недоступна по правам, операция выполняется по доступным, а в сообщении указывается, сколько областей пропущено.

4.9.10. Публикация области в витрину образцов

• Наименование. Ведение витрины образцов.
• Условия выполнения. Роль администратора продукта (рабочее место организации) либо куратора витрины (свободная версия); область открыта в редакторе.
• Подготовительные действия. Настроить вид правой панели так, чтобы он годился для превью карточки: выбрать масштаб и вид результата.
• Основные действия.
  1. Нажать «В галерею» на правой панели.
  2. В открывшемся диалоге нажать «Снимок» — снимок делается с текущего вида карты результата.
  3. Заполнить заголовок, описание и шаги на русской и, при необходимости, английской вкладке.
  4. Задать теги, точку входа в кластер и порядок карточки в витрине.
  5. Нажать «Сохранить».
• Заключительные действия. Выводится «Карточка сохранена»; в перечне областей у области появляется отметка «галерея» / «витрина». Помеченная область не удаляется, пока пометка не снята. Снятие пометки — кнопка «Убрать из галереи».
• Расходуемые ресурсы. Размер превью ограничен: при отказе выводится сообщение с рекомендацией уменьшить масштаб карты и переснять превью.

4.9.11. Просмотр обстановки территории

• Наименование. Отображение слоёв территории на карте.
• Условия выполнения. Открыт главный экран. Вход не требуется.
• Основные действия.
  1. Приблизить карту к нужному месту.
  2. При наличии реестра территорий выбрать территорию в нижней части панели слоёв.
  3. Включить нужные слои: «Дорожная сеть», «Стрелки и знаки», «Маршруты» (с отбором видов транспорта и слоя «Остановки»), «Обобщённый граф».
• Заключительные действия. Выключить слои по окончании работы — при выключении панели слои снимаются с карты.
• Расходуемые ресурсы. Слои подгружаются по мере панорамирования и появляются только начиная с достаточного приближения карты.

4.9.12. Совместная работа: ссылки, просмотр и копирование чужой области

• Наименование. Передача области на просмотр и взятие чужой области в работу.
• Условия выполнения. Для копирования — выполненный вход и право создания областей. Просмотр по ссылке доступен без входа.
• Основные действия.
  1. Открыть меню «Поделиться» на правой панели.
  2. Скопировать нужную ссылку: короткую, «ссылка для просмотра (read-only)» либо прямую ссылку на данные модели.
  3. Получатель открывает ссылку — область открывается в режиме публичного просмотра: правка, инструменты и передача результата недоступны, в правом нижнем углу левой панели выводится «Режим только для чтения», внизу доступен переключатель «До / После».
  4. Чтобы взять чужую область в работу, нажать «Клонировать» (в меню «Поделиться», в строке перечня областей или на карточке образца витрины).
• Заключительные действия. Создаётся собственная копия-черновик, открывается в новой вкладке. Сообщение — «Клон создан, открыт в новом окне».
• Расходуемые ресурсы. Копия — самостоятельная область и учитывается в пределах тарифного плана.

4.10. Служебные экраны

• Экран завершения входа — «Завершаем вход в Основание…»; отображается кратковременно при возврате от провайдера идентичности и автоматически перенаправляет на страницу, с которой был начат вход.
• Экран «страница не найдена» — «404», «Упс. Здесь ничего нет...», кнопка «На главную».
• Короткая ссылка — служебный переход по сокращённому адресу; открывает соответствующую область в режиме публичного просмотра.

---

5. Аварийные ситуации

5.1. Действия при несоблюдении условий выполнения

5.1.1. Сообщения интерфейса и реакция пользователя

5.1.2. Длительные отказы технических средств

Общее правило: непереданный на сервер результат существует только в браузере. При длительной работе следует периодически нажимать «Обновить», сохраняя область на сервере, и выгружать набор изменений кнопкой «Скачать .osc».

5.2. Действия по восстановлению программ и данных

Продукт — веб-приложение; программа на рабочем месте не хранится и восстановлению не подлежит: достаточно заново открыть адрес стенда. Восстановлению подлежат данные рабочей области.

Что и где хранится.

Порядок восстановления.

[УТОЧНИТЬ: глубина хранения резервных копий и допустимая точка восстановления задаются регламентом конкретного стенда и приведены в руководстве системного администратора. Пользователю следует уточнить их у администратора заранее — от них зависит, за какой срок работу удастся вернуть.]

Меры предупреждения потерь, обязательные для пользователя.

1. Нажимать «Обновить» после каждого законченного смыслового блока правок (один перекрёсток — одно сохранение), не реже одного раза в 15–20 минут.
2. Перед выполнением необратимых действий («Сбросить все изменения», Reset CS, удаление области) выгружать набор изменений кнопкой «Скачать .osc».
3. Сохранять идентификатор важной области (Copy ID) вместе с записью о том, что в ней сделано.
4. Не закрывать вкладку редактора по предупреждению «ваша история редактирования может не сохраниться», не сохранив область.

5.3. Действия при обнаружении несанкционированного доступа к данным

Признаки, требующие реакции.

• В перечне областей появились области, которых пользователь не создавал, либо исчезли ранее созданные им области.
• В истории правок области присутствуют шаги, которых пользователь не выполнял, либо время правок не соответствует времени его работы.
• Область неожиданно оказалась в состоянии «Опубликован» или в режиме «только чтение», хотя пользователь её не передавал.
• В витрине образцов появилась карточка, которую пользователь не создавал, либо изменилось содержимое его карточки.
• В плашке учётной записи отображается чужое имя, чужая организация или чужой тарифный план.
• Из служебных уведомлений или писем следует, что вход в учётную запись выполнялся с неизвестного пользователю устройства, места или в нерабочее время.
• Продукт запрашивает учётные данные на странице, адрес которой отличается от сообщённого администратором адреса стенда и провайдера идентичности.

Действия немедленно, до обращения.

1. Прекратить работу с данными: не вносить правок, не передавать результат, не удалять ничего — сохранность следов важнее продолжения работы.
2. Завершить сессию — кнопка «Завершить сессию» в плашке учётной записи (в свободной версии — повторное нажатие кнопки с именем участника). Это гасит общую сессию входа, и следующий вход в любой сервис платформы потребует пароль.
3. Сменить пароль учётной записи средствами провайдера идентичности; если это невозможно — немедленно сообщить администратору, чтобы учётную запись заблокировали.
4. Зафиксировать доказательства: время обнаружения, адрес страницы, идентификаторы затронутых областей (Copy ID), снимки экрана с подозрительными строками истории правок и перечня областей.
5. Не пользоваться для входа ссылками из писем и сообщений; открывать стенд только по адресу, сообщённому администратором.

Куда сообщать.

1. Администратору стенда — незамедлительно, любым доступным каналом. Только он может заблокировать учётную запись, снять роль и поднять журналы сервера.
2. В службу технической поддержки — info@trafficeq.ru, 09:00–18:00 МСК, пн–пт. В обращении указать: адрес стенда, имя учётной записи, время обнаружения, перечень признаков, идентификаторы затронутых областей и приложить снимки экрана. Просить зарегистрировать обращение как критичное.
3. Ответственному за информационную безопасность организации — в порядке, установленном внутренними документами организации.

Самостоятельно восстанавливать изменённые злоумышленником данные до разбора инцидента не следует: это уничтожает следы. Порядок восстановления определяет администратор стенда.

5.4. Прочие аварийные ситуации

Техническая поддержка: info@trafficeq.ru, 09:00–18:00 МСК, пн–пт. Обращения регистрируются по классам со сроками реакции от 4 рабочих часов (критичный) до 3 рабочих дней (консультация). В обращении следует указывать адрес стенда, имя учётной записи, идентификатор области, точное время и текст сообщения об ошибке.

---

6. Рекомендации по освоению

6.1. Порядок освоения

Рекомендуемая последовательность — от просмотра к правке, от одного перекрёстка к территории:

1. Осмотреться без входа. Открыть адрес стенда, поработать с картой, сменить подложку, включить слои обстановки территории, открыть витрину образцов и посмотреть один-два образца кнопкой «Просмотр». Это даёт представление о том, как выглядит правильно собранная модель, до того как придётся собирать свою.
2. Разобрать чужой образец. В открытом на просмотр образце переключить вид результата, открыть легенду модели, выбрать несколько объектов и посмотреть их свойства, включить дерево маршрутов перекрёстка. Ничего испортить нельзя — образец открыт в режиме «только чтение».
3. Взять образец в работу. Скопировать образец себе кнопкой «+» на карточке витрины и повторить в редакторе шаги, описанные в карточке. Это самый быстрый путь к первому осмысленному результату.
4. Собрать собственный перекрёсток. Выполнить контрольный пример § 6.2.
5. Освоить параметры построения. Выключать и включать по очереди этапы построения, наблюдая, что именно исчезает с правой панели. Это единственный надёжный способ понять, за что отвечает каждый этап.
6. Освоить передачу результата. Выполнить операцию § 4.9.7 (или § 4.9.8) на учебной области. Помнить: после успешной передачи область становится неизменяемой.
7. Освоить работу с фондом областей — фильтры, сортировку, копирование, групповые операции.

6.2. Контрольный пример

Пример предназначен для проверки того, что пользователь освоил основной рабочий цикл, а стенд работает штатно. Выполняется целиком за 20–30 минут.

Правила запуска.

• Требуется учётная запись с ролью редактора и выполненный вход.
• Работать следует на учебной области, созданной специально для примера, а не на рабочей.
• Объект: любой четырёхсторонний регулируемый перекрёсток с двумя-тремя полосами на каждом подходе и пешеходными переходами по всем сторонам. Подойдёт любой такой перекрёсток в пределах вашей территории; на нём должен быть виден спутниковый снимок.
• Шаг 8 (передача результата) на учебной области не выполняется — он делает область неизменяемой; вместо него выполняется проверка доступности кнопки.

Шаги.

Ожидаемый результат. Пользователь получил из общедоступной карты пополосную модель регулируемого перекрёстка: четыре трёхполосных подхода с назначенными поворотами, скруглённый регулируемый узел, полный набор манёвров и конфликтных точек, сохранённый на сервере и выгруженный набор изменений. Если все 14 шагов выполнены с указанными признаками, продукт и стенд работоспособны, а пользователь владеет основным рабочим циклом.

Если результат не достигнут. Шаги 1–2 — см. § 3.3 и § 5.1; шаги 3–6 (модель не перестраивается или выглядит неправдоподобно) — § 5.4; шаг 7 (область не сохраняется) — § 5.1.2; шаг 12 — § 5.1.1.

6.3. Советы

• Правая панель — зеркало. Хорошо смоделированный перекрёсток должен выглядеть как настоящий поверх спутникового снимка. Если модель выглядит неправдоподобно, причина почти всегда в параметрах полос или типе узла, а не в подложке.
• Сначала снимок, потом полосы. Перед разметкой стоит выставить смещение подложки так, чтобы снимок точно совпал с данными: иначе полосы будут подгоняться под смещённую картинку.
• Один перекрёсток — одно сохранение. Нажимайте «Обновить» после каждого законченного перекрёстка: это и точка возврата, и проверка того, что модель строится.
• Отключайте лишние этапы на время черновой правки. Построение дорожной разметки — самый заметный по времени этап; на стадии расстановки полос он не нужен.
• Составной перекрёсток. Если два близких перекрёстка должны управляться как один, увеличьте «Макс. длина линка суперкластера»; если, наоборот, они склеились ошибочно — уменьшите.
• Начинайте с образца. Копия готового образца витрины экономит часы: в ней уже подобраны параметры построения.
• Сохраняйте идентификаторы. Кнопка Copy ID в карточке области — самый быстрый способ однозначно указать область в обращении в поддержку.
• Фильтр категорий — не только про объём. Лишние категории (служебные проезды, велодорожки) усложняют картину на левой панели; отключайте те, что не нужны в задаче.

6.4. Горячие клавиши

Клавиатурные команды редактора действуют, когда фокус находится на карте: если курсор стоит в поле ввода или открыта панель, сначала щёлкните по карте.

Общие.

Инструменты правки.

Цифры при открытом меню инструмента.

---

Приложение А. Форматы описания границы области

Приложение Б. Слои выгрузки Shapefile

Слои выбираются флажками перед выгрузкой; файлы упаковываются в архив по слоям.