Перейти к содержанию

Пользовательские карты

По умолчанию Glarus BI использует OpenStreetMaps для визуализации карт, но есть несколько вариантов настройки.

Управление настройками карт

Чтобы найти настройки карт:

  1. В правом верхнем углу выберите настройки > Управление.
  2. Выберите Карты в меню слева.

Настройки карт

Тайл-сервер карт

По умолчанию Glarus BI использует тайл-сервер OpenStreetMaps для pin и grid-карт. Если вашей организации нужен другой внешний вид или уровень детализации карт, вы можете изменить тайл-сервер, указав путь к серверу в первом поле на странице.

Путь должен быть либо URL, начинающимся с http:// или https://, либо относительным путём к локальному файлу в classpath JVM.

Сейчас Glarus BI использует один тайл-сервер на экземпляр. Нельзя указать разные тайлы для разных карт.

Карты в закрытом контуре

В Glarus BI входят встроенные карты мира, России с 85 субъектами и США со штатами. Для них не нужно загружать карту из интернета. Подробнее о карте России — в разделе Карта России.

Пользовательские карты регионов могут использовать GeoJSON по HTTP или HTTPS URL, доступному серверу Glarus BI, либо ресурс из classpath JVM. URL запрашивает сервер Glarus BI, поэтому он может быть внутренним и не обязан открываться из браузера пользователя. Администратор может предварительно загрузить пользовательские карты при запуске через MB_CUSTOM_GEOJSON.

Для фоновой подложки карт с метками и с сеткой настройте внутренний тайл-сервер в Управление → Карты → Тайл-сервер карт или задайте MB_MAP_TILE_SERVER_URL. Например, можно указать https://tiles.example.local/{z}/{x}/{y}.png или путь к ресурсу classpath JVM. Адрес использует растровые тайлы XYZ в проекции Web Mercator (EPSG:3857); в шаблоне Leaflet поддерживаются подстановки {s}, {z}, {x} и {y}. См. раздел Тайл-сервер карт.

Организация сама готовит и обновляет тайлы; загрузки или предварительного кэширования тайлов из интерфейса нет. Для экземпляра можно настроить только один тайл-сервер. Если он недоступен, фоновые тайлы карт с метками и с сеткой не загрузятся. Региональные карты используют GeoJSON и не зависят от тайл-сервера: их геометрия и значения продолжают отображаться.

Офлайн-геокодирования адресов нет. Чтобы показывать данные на карте с метками, включите в запрос координаты широты и долготы. При настройке пользовательского GeoJSON учитывайте, что запрещены link-local адреса и хост metadata.google.internal; сервер Glarus BI должен напрямую получить файл.

Пользовательские карты регионов

Если вам нужна карта определённого региона, вы можете указать GeoJSON-файл с информацией о регионах. Часто такие GeoJSON-карты можно найти, поискав в интернете "[Ваш регион] + geojson", например: "Нижний Новгород GeoJSON". Вы также можете создать свой GeoJSON с помощью инструмента вроде MapShaper или GeoJSON.io. Если вас интересует получение дополнительной информации о формате GeoJSON, мы рекомендуем начать здесь.

Ваш GeoJSON-файл должен:

  • быть меньше 5 Мбайт;
  • содержать полигональные объекты, определяющие регионы (не только точки или координаты);
  • использовать географические координаты (широта и долгота) для определения полигонов регионов. Glarus BI не поддерживает проекционные координаты, поэтому вам нужно будет преобразовать проекционные координаты в географические;
  • быть доступен серверу Glarus BI по HTTP или HTTPS либо находиться в classpath JVM. GeoJSON можно указать как URL или путь к ресурсу; см. раздел Карты в закрытом контуре. Непосредственная загрузка файла через интерфейс не поддерживается.

Чтобы добавить пользовательскую карту:

  1. Перейдите в Управление > Карты > Произвольная карта.
  2. Нажмите Добавить карту.
  3. Введите имя карты.
  4. Укажите HTTP(S) URL, доступный серверу Glarus BI, или путь к ресурсу в classpath JVM.
  5. Укажите JSON-свойства, которые будут использоваться как идентификатор региона и как отображаемое имя региона.

Загрузка пользовательского GeoJSON

  • Название карты будет отображаться в выборе региона для пользовательских карт регионов
  • Идентификатор региона — поле GeoJSON, которое идентифицирует регион. Значения в этом поле должны совпадать с тем, как регионы указаны в ваших данных. Поле не обязано совпадать с отображаемым именем.
  • Отображаемое название региона — поле GeoJSON, определяющее, как регион будет называться на карте. Это поле может отличаться от идентификатора региона.

Чтобы предварительно загрузить одну или несколько карт регионов при запуске Glarus BI, используйте переменную окружения MB_CUSTOM_GEOJSON или опцию файла конфигурации custom-geojson в файле конфигурации.

Чтобы отключить создание пользовательских карт, используйте MB_CUSTOM_GEOJSON_ENABLED или опцию файла конфигурации custom-geojson-enabled.

Дополнительная информация