Название

Назначение

Категория Параметры

Тип карты

Задается способ получения тайлов карты. Возможные следующие варианты:

Глобальная с тайловым сервером - данный тип карты создается с помощью подключения к внешнему источнику тайлов - тайловому серверу. Путь к  тайловому серверу задается в параметре Адрес тайлового сервера

Глобальная с ресурсами тайлов - в данном типе карты используются подготовленные локальные ресурсы тайлов. Но геолокация и позиционирование маркеров осуществляется в глобальных координатах (долгота\широта). Это может быть полезно для серверов без доступа к внешним интернет ресурсам. Для этого необходимо "нарезать" карту в хорошем разрешении на тайлы. Для генерации тайлов рекомендуется использовать утилиту от Яндекса  (Подробнее о процессе генерации). Сгенерированную папку необходимо разместить в папке проекта Res, а в параметре Адрес тайлового сервера записать имя этой папки.

Локальная -использует локальный ресурс, картинку, в качестве подложки карты с возможностью изменения масштаба и размещением на ней элементов. В текущей версии не поддерживается.

Адрес тайлового сервера

Если используется тип карты Глобальная с тайловым сервером, то указывается шаблон для формирования URL тайлового сервера. Например, для Stutnik - Http://tilessputnik.ru/{z}/{x}/{y}.png,  OpenStreetMap указывается https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png, а для Яндекс.Карты: yandex (другие варианты описаны в разделе - Яндекс.Карты)

где {z}, {x}, {y} - это zoom, долгота и широта, а {s} - это маска для сабдомена. Сабдомены - это некие символы для формирования разного url для резервных подключений.

Если используется тип карты Глобальная с ресурсами тайлов, то в качестве адреса указывается имя папки с тайлами, которая находится в папке Res разрабатываемого проекта, в этом случае будут использоваться тайлы с расширением .png. Если в качестве адреса указать имя папки с тайлами с добавлением на конце /{z}/tile-{x}-{y}.jpg, то будут использоваться тайлы с расширением .jpg

Пример адреса тайлового сервера для папки тайлов с расширением .jpg: folder_name/{z}/tile-{x}-{y}.jpg

Формат названия тайла строго ограничен и должен соответствовать шаблону: {z}/tile-{x}-{y}.{form}

где {z}, {x}, {y} - это zoom, долгота и широта, а {.form} - формат файла тайла (.png, .jpg).

Сабдомены тайлового сервера

Указываются сабдобмены допустимые для указанного тайлового сервера. Например,для Яндекс.Карты массив сабдоменов выглядит как 01,02,03,04, для OpenStreetMap подставляются символы из строки a,b,c.

Центр карты

Указывается точка первоначальной загрузки карты, задается строкой в формате : y,x,z - где

y - lattitude - широта (значение 0 - экватор)

x - longitude - долгота (значение 0 - нулевой меридиан)

z - zoom, приближение

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

Позиционирование маркеров

Определяет к какому углу маркера будет привязана его координата на карте.  Возможные значения:

•По центру - по умолчанию.

•Сверху слева

•Сверху справа

•Снизу слева

•Снизу справа

Свойство можно динамизировать. Для определения нужного положения маркера установить входящую связь с параметром проекта

Приближение

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

Максимальное/Минимальное приближение

Определяется значение, на котором будет зафиксирован максимальный/минимальный zoom карты, нужно для ограничения зоны просмотра. Например при пользовательских тайлах невозможно будет просматривать фрагменты в неподготовленных участках карты . Так ограничив область zoom (а в дальнейшем планируется и ограничение по координатам), пользователь не будет выходить за рамки существующих тайлов.  Для Яндекс.Карты это целое число от 0 до 23 -  стандартные уровни zoom. Для  других тайловых серверов они могут отличаться.

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

Система координат

Реализует механику преобразования координат и их расположение в контейнере карты. Возможные значения:

•Эллиптическая проекция Меркатора   - используется для Яндекс-тайлов

•Сферическая проекция Меркатора  - используется в Openstreetmap тайлах

•Равнопрямоугольная проекция

•Простая - используется при настройке типа карты "Локальная" - значения широты-долготы напрямую используются как X,Y, точка (0,0) переносится в левый нижний угол

Атрибуция

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

Пример вставки гиперссылки в атрибуции: <a href="https://masterscada.ru/">MasterSCADA</a>

Приближение по двойному клику

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

Игнорирование кликов по прозрачному фону маркера

Позволяет игнорировать нажатие по фону окна маркера.

Тема

Позволяет изменить тему карты. Возможные значение:

•Светлая   - по умолчанию

•Тёмная  

Эта настройка нужна для визуального отображения карты в светлом или тёмном формате. Может динамически изменяться в зависимости от некоторого параметра, события и т.д.

Кластеризация

Позволяет объединить соседние маркеры между собой в кластер. По умолчанию TRUE. Возможные значения:

•TRUE - кластеризация происходит.

•FALSE - кластеризация не происходит.

Максимальный радиус кластера (pixel)

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

Заливка кластера

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

Цвет текста кластера

Определяет цвет текста кластера. По умолчанию чёрный.

Условия заливки

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

•Имя - название условия

•Значение - значение для сравнения с условием.

•Тип сравнения - использует логические операторы сравнения: ==, >, <, >=, <=, !=, а так же тип сравнения Содержит, позволяющий найти нужное слово или его часть в любом месте строки.

•Поле структуры - указывается поле структуры которое будет сравниваться со значение.

•Заливка - задаётся цвет заливки.

•Цвет текста

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

Название кластера

Задаёт название всей области кластера или его сегмента для заливки кластера по умолчанию. Также это название выводится в легенде.

Фон текста кластера

Определяет цвет фона текста в кластере. По умолчанию белый.

Кольцевая диаграмма в кластере

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

•TRUE - включить отображение состояний входящих в кластер маркеров в виде кольцевой диаграммы.

•FALSE - выключить отображение кольцевой диаграммы.

Отображать легенду

Позволяет отображать легенду на карте. По умолчанию FALSE. Возможные значения:

•TRUE - включить отображение легенды.

•FALSE - выключить отображение легенды.

Название легенды

Задаёт название легенды на карте.

Позиция легенды

Задаёт расположение легенды на карте. Возможные значения:

•Сверху слева - по умолчанию.

•Сверху справа.

•Снизу слева.

•Снизу справа.

Категория Данные

Источник данных

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