Документация
Примечание: Эта документация в настоящее время находится в разработке.

Управление картой с помощью местоположений и маршрутов

Открыть настройки

В этом документе представлен подробный обзор функции «Карта» в приложении, объясняющий ее функциональность с точки зрения как обычных пользователей (издателей), так и координаторов (администраторов).

Обзор

Функция «Карта» позволяет собраниям визуально управлять и отображать географические точки интереса (Местоположения) и области/пути (Маршруты). Его можно использовать для координации мест публичного свидетельствования, определения конкретных территорий или выделения важных областей для возвещателей.

Для рендеринга карты используются тайлы OpenStreetMap и Leaflet. Он также поддерживает отображение местоположений пользователей, отображение границ собраний и загрузку изображений для определенных мест.

Роли пользователей

  • Стандартные пользователи (издатели): Могут просматривать карту, местоположения, маршруты и связанные с ними детали (например, изображения и подсказки), если координатор сделал карту видимой для них.
  • Координаторы (Администраторы): Иметь полный доступ к управлению. Они могут настраивать параметры карты, создавать/редактировать/удалять местоположения и маршруты, управлять изображениями местоположений и рисовать многоугольники для маршрутов.

Стандартный пользователь (издатель)

Если Координатор включил настройку «Карта видна всем издателям», обычные пользователи могут получить доступ к карте через меню навигации (в разделе Другое -> Карта).


Просмотр карты

  • Автоцентрирование: Карта автоматически корректирует свои границы, чтобы соответствовать всем доступным местоположениям и маршрутам. Если их нет, по умолчанию используется центральная точка, настроенная координатором.
  • Маркеры и фигуры:
    • Местоположения отображаются в виде маркеров на карте с пользовательскими цветами и значками.
    • Маршруты отображаются на карте в виде цветных многоугольников или линий.
    • Границы собраний отображаются в виде неинтерактивных оранжевых контуров (если это разрешено координатором).
  • Стиль карты: Карта может отображаться в стандартных цветах или в оттенках серого (монохромном) в зависимости от настроек календаря.

Взаимодействие с элементами карты

При нажатии на маркер (Местоположение) или многоугольник (Маршрут) открывается диалоговое окно с подробностями:

  • Детали местоположения:
    • Отображает имя и описание.
    • Показывает Важные советы (выделены красным для наглядности).
    • Отображает галерею связанных изображений. При нажатии на миниатюру открывается полноэкранное Лайтбокс для масштабирования и навигации по изображениям.
  • Детали маршрута:
    • Отображает имя и описание.
    • Перечисляет все местоположения, связанные с этим конкретным маршрутом.

Функция «Найди меня»

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


Просмотр координатора (администратора)

Координаторы управляют функцией карты из области администратора в разделе Управление картой (`/admin/map`). Отсюда они могут настраивать глобальные параметры, управлять местоположениями и маршрутами.


1. Настройки карты

Доступен через значок настроек (шестеренка) на панели управления картой.

Центральная широта и долгота

  • Широта центра
  • Долгота центра
  • Выбрать центр на карте

Что он делает: Устанавливает географическую центральную точку карты по умолчанию. Это определяет начальный вид при загрузке карты.

Где появляется/Эффект: В главном представлении карты, когда любой пользователь открывает раздел карты, карта сначала перемещается к этим точным координатам.

Карта видна всем издателям

Что он делает: Переключает, доступна ли функция карты только администраторам и координаторам или она доступна также и обычным пользователям (издателям).

Где появляется/Эффект: Управляет внешним видом ссылки меню «Карта» в основной навигации. Если эта опция включена, все издатели видят в своем меню пункт «Карта» и могут просматривать настроенные местоположения и маршруты.

Использовать монохромные плитки

Что он делает: Изменяет стиль базовой карты с полноцветного на оттенки серого (монохромный).

Где появляется/Эффект: Применяется непосредственно к фону карты, просматриваемому всеми пользователями. Фон карты становится черно-белым, что позволяет более заметно выделить маршруты и маркеры местоположения, окрашенные в разные цвета.

Показать границы собрания

Что он делает: Позволяет рисовать на карте заранее заданные линии границ собрания.

Где появляется/Эффект: Наложение границ будет наложено на основной вид карты для всех пользователей, выделяя определенные области.


2. Управление локациями

Открыть в админке

Местоположение представляет собой определенные точки на карте (например, местоположение тележки, место встречи).

Создание/редактирование локации:

имя

Что он делает: Основной идентификатор или название местоположения.

Где появляется/Эффект: Отображается в виде заголовка, когда пользователь нажимает на маркер местоположения на карте, в списке местоположений в области администрирования и в раскрывающихся списках ассоциаций.

Цвет / Иконка

  • Цвет:
    • Что он делает: Определяет цветовой оттенок маркера карты.
    • Где появляется/Эффект: Значок булавки в реальном виде карты будет отображаться в этом выбранном цвете.
  • Иконка:
    • Что он делает: Позволяет выбрать определенный символ или глиф для размещения внутри маркера карты.
    • Где появляется/Эффект: Выбранный значок будет виден внутри цветной метки на карте, что поможет пользователям быстро определить тип местоположения с первого взгляда.

Координаты

Широта и долгота. Для выбора точной точки на карте предусмотрен инструмент «Выбор координат».

Описание

Что он делает: Поле с форматированным текстом для предоставления общей информации о местоположении.

Где появляется/Эффект: Появляется во всплывающем окне или на панели сведений, когда пользователь щелкает маркер местоположения на карте.

Важные указания

Что он делает: Вторичное поле форматированного текста, специально предназначенное для важных оповещений, правил или предупреждений, связанных с местоположением.

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

Связанные маршруты

Что он делает: Связывает местоположение с одним или несколькими предопределенными маршрутами.

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

Период действия

Что он делает: Определяет дату начала и окончания, когда это местоположение следует считать активным.

Где появляется/Эффект: Если текущая дата выходит за пределы этого диапазона, местоположение будет автоматически скрыто от общедоступного представления карты, даже если установлен переключатель «Активно».

активный

Что он делает: Главный переключатель для полного включения или отключения местоположения.

Где появляется/Эффект: Если флажок снят, маркер местоположения исчезает с карты для всех пользователей сразу, независимо от срока его действия.

Управление изображениями местоположений:

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

  • Размер изображений автоматически изменяется на маленькие (ширина 600 пикселей) и большие (ширина 1600 пикселей) для оптимизации загрузки в галерее внешнего интерфейса и лайтбоксе.
  • Координаторы могут предоставить Название и Описание для каждого изображения.
  • Изображения можно переключить в режим Активные или полностью удалить.

3. Управление маршрутами

Открыть в админке

Маршруты представляют собой многоугольники, линии или определенные области на карте (например, конкретную зону публичного свидетельства, пешеходную дорожку).

Создание/редактирование маршрута:

Имя

Что он делает: Основной идентификатор маршрута.

Где появляется/Эффект: Отображается в списке маршрутов в области администрирования, в раскрывающихся списках ассоциаций и в виде заголовка, если щелкнуть маршрут на карте.

Цвет

Что он делает: Устанавливает цвет линий маршрута и области заливки.

Где появляется/Эффект: Фигура, нарисованная на карте, будет отображаться в этом цвете с различной непрозрачностью.

Описание

Что он делает: Общий текст с подробной информацией о маршруте.

Где появляется/Эффект: Виден при нажатии на участок маршрута на карте.

Маршрутизатор (Многоугольники)

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

Ассоциации

  • Связанные места:
    • Что он делает: Связывает маршрут с одним или несколькими заранее заданными местами на карте.
    • Где появляется/Эффект: Позволяет логически группировать местоположения по этому маршруту. Это может повлиять на представление фильтров или группировку на главной карте.
  • Связанные резервируемые позиции:
    • Что он делает: Связывает географический маршрут с элементами календаря, которые пользователи могут зарезервировать.
    • Где появляется/Эффект: Это связывает функцию карты непосредственно с календарем бронирования. Когда пользователь взаимодействует с определенным резервируемым элементом, этот маршрут можно указать или отобразить.
  • Связанные кампании:
    • Что он делает: Связывает географический маршрут с конкретными Кампаниями резервирования (логическими группировками смен).
    • Где появляется/Эффект: При управлении кампаниями или их просмотре в календаре этот географический контекст обеспечивает визуальное представление того, где на карте проводится кампания.