Общие сведения
Компонент служит для представления на виджете географических координат в виде маркеров на карте Яндекс.Карты.
Настройки данных
Компонент предоставляет настройки данных:
- «Слои»;
- «Геоточка»/«Полигон»;
- «Показатель»;
- «Колонка»;
- «Код цвета»;
- «Сортировка»;
- «Количество записей на странице».
- «Фильтры».
Блок «Слои»
Подложка карты может содержать до 5 слоев двух видов: слои с маркерами и слои с полигонами. Слои добавляются в выпадающий список нажатием на кнопку . Для каждого слоя устанавливаются свои настройки данных. Кнопка позволяет удалить либо переименовать слой.
Поле «Геоточка»
Отображается, если выбран слой с маркерами. Должно содержать колонку датасета с координатами точек на карте, которые должны быть отмечены маркерами.
Поле «Полигон»
Отображается, если выбран слой с полигонами. Должно содержать колонку датасета с координатами области на карте, которую нужно очертить полигоном.
Поле «Показатель»
Отображается для обоих видов слоев. Содержит колонки датасета, значения которых будут проставлены в легенде карты и связаны с геоточками/полигонами.
Блок «Цветовая идентификация»
Блок заполняется, если необходимо, чтобы разные показатели отображались на карте разным цветом.
Поле «Колонка»
Содержит колонку датасета, точки/полигоны для значений которой должны быть окрашены в определенные цвета. Колонка должна быть также вынесена в поле «Показатель».
Поле «Код цвета»
Содержит колонку датасета с HEX-кодами цветов для окрашивания точек/полигонов на карте. В поле можно вынести не более одной колонки.
Поле «Сортировка»
По вынесенным колонкам сортируются строки датасета перед отображением на карте. Для переключения направления сортировки (по возрастанию/по убыванию) используется кнопка . Для колонки сортировки также доступны функции агрегации.
Поле «Количество записей на странице»
Значение поля – число N – ограничивает количество отображаемых маркеров до первых N значений с учетом сортировки. Когда значение поля «0» или не указано, ограничения нет.
Фильтры
Для работы с расширенным фильтром см. раздел Работа с расширенным фильтром.
—
Если на карте есть слои и с точками, и с полигонами, по умолчанию они отображаются все друг поверх друга. Ненужные слои можно скрыть, нажав на значок в легенде карты.
Настройки визуализации
Компонент предоставляет следующие настройки визуализации, которые настраиваются отдельно для слоев с точками и слоев с полигонами. Слои выбираются в раскрывающемся списке «Слой»:
- «Условия форматирования». Для того, чтобы данные настройки были доступны, в настройках данных НЕ должен быть заполнен блок «Цветовая идентификация»;
- «Значения». Включает отображение иконок маркеров на карте.
- «Координаты». Позволяет задать место, отображаемое на карте при открытии или перезагрузке страницы и ее масштаб.
Блок «Условия форматирования»
Позволяет задать условия цветового оформления точек или полигонов на карте, а также текст, отображаемый в легенде.
Для добавления нового условия форматирования необходимо развернуть блок «Условия форматирования» и нажать кнопку . После нажатия открывается модальное окно с настройкой правила:
Модальное окно с настройкой правила включает в себя следующие параметры:
- Цветовой градиент;
Для настройки цветового градиента необходимо нажать на переключатель . После нажатия отображается поле типа «селект», где необходимо выбрать колонку с числовыми показателями. Снизу от поля отображается RGB-палитра, где можно настроить цвет значений и фона. Для настройки интервала окраски необходимо вручную установить начальное и конечное значение. В левом нижнем углу модального окна располагается переключатель на трехцветный градиент. После нажатия отображается еще одна палитра и еще одно поле для более детальной настройки цветовой дифференциации.
- Поле «Колонка»;
Поле «Колонка» предназначено для выбора колонки, на которую устанавливается условие. Для выбора нужной колонки необходимо нажать на кнопку, которая располагается в правой части поля. После нажатия открывается список имеющихся колонок. Необходимо выбрать нужную колонку. Данное поле обязательно для заполнения. - Поле «Условие»;
Поле «Условие» предназначено для установления условия. Для выбора условия необходимо нажать на кнопку, которая располагается в правой части поля. После нажатия открывается список условий. Необходимо выбрать нужное условие, которое будет применяться по выбранной колонке на предыдущем шаге. Данное поле обязательно для заполнения. - Поле «Значение»;
Поле «Значение» предназначено для указания значения. Данное поле обязательно для заполнения. - Кнопка «Добавить колонку»;
После нажатия на кнопку добавится блок для выбора колонки и указания условия для этой колонки. Данный блок можно добавлять неограниченное количество раз. - Настройка цвета фона.
Для настройки цвета фона необходимо нажать на . После нажатия отображается RGB-палитра, где можно указать необходимый цвет фона.
После того как были выполнены все настройки, необходимо нажать на кнопку . Условное форматирование колонки сохранится.
Для сброса настроек необходимо нажать на кнопку .
После сохранения настроек условного форматирования по колонке в блоке «Условия форматирования» добавляется новое правило:
Для редактирования уже созданного правила необходимо нажать на иконку . После внесения всех изменений необходимо нажать кнопку «Применить».
Для удаления уже созданного правила необходимо нажать на иконку .
При необходимости добавления нового правила необходимо нажать на текстовую кнопку . После нажатия откроется модальное окно с настройками нового правила. Нумерация правил создается автоматически.
Блок «Значения»
Блок включает в себя один чек-бокс «Маркеры на карте», который включает/отключает отображение иконок маркеров на карте для геоточек.
Блок «Координаты»
В полях Х и Y задаются координаты места, на котором должна открываться карта. В поле «Масштаб» задается приближение или отдаление карты в процентах.