Пользовательская карта
Как создать карту
Вы можете создать и использовать в дашбордах свою карту кампуса, корпуса, этажа, помещения, отдельного населенного пункта.
Для создания map-файла с картой необходимо установить VSCode или другой редактор кода, Adobe Illustrator или использовать Figma.
Также нужна векторная карта в формате svg.
Если не получилось найти готовую векторную карту, можно поискать ее в других форматах (например png) и потом использовать для рисования вектора.
Подготовка векторной карты
Открываем карту в Figma.
Слева во вкладе «Layers» видно на каком слое лежит каждый фрагмент карты.
Всем слоям, на которых лежат части карты, нужно дать название. Например, слой на котором изображен Корпус 1, обозначен как k1.
Далее экспортируем карту с обозначенными слоями в формате svg.
Cтруктура map-файла
Пустой шаблон map-файла (ссылка на файл map-template.map).
Правила заполнения полей
Поля, которые нужно заполнить: "Name", "Width", "Height", "Key", "Data", "EnglishName", "ISOCode".
В поле "Name" указывается название карты (в названии можно использовать английские буквы, цифры и нижнее подчеркивание вместо пробела).
Пример: "Name":"Karta_korpusov",
В полях "Width" и "Height" указываются ширина и высота в соответствии с аналогичными полями (W и H) из вкладки «Layout» справа в Figma. (также эти параметры будут указаны в svg файле).
Каждый блок поля "Path" представляет собой часть карты, где:
"Key" – уникальное название, которое не должно повторяться (можно использовать английские буквы, цифры, нижнее подчеркивание вместо пробела). Пример: "Key":"Korp_1";
"Data" – вектор фрагмента, взятый из svg-файла, из поля d=" ";
Открываем векторную карту с помощью VSCode (или другого редактора кода) и находим по названиям (которые ранее были обозначены в Figma) нужные фрагменты, например, "k1":
"EnglishName" – наименование части карты на русском языке.
Пример: "EnglishName":"Корпус 1";
"ISOCode"– сокращенное наименование (допустимо использовать английские буквы, короткое тире -, русские буквы, цифры).
Пример заполненных полей
Проверка map-файла перед загрузкой в отчет
Во всех полях "Data" не должно быть пробелов между символами.
В поле "Path" после каждого блока, если он не последний, должна стоять «,».
Весь код файла необходимо проверить в валидаторе и (если будут) исправить ошибки.
Название map-файла должно соответствовать полю "Name". Например:
Как расставить подписи на карте
Загружаем карту в Ресурсы отчета, добавляем на дашборд.
Открываем Изменение ресурса.
Подписи расставляются автоматически.
При необходимости подписи можно двигать стрелками на клавиатуре, выбирая нужный район из списка.
Далее снова открываем Изменение ресурса и сохраняем готовый map-файл карты с расставленными подписями. Полученную карту можно использовать в ваших дашбордах.
