Справочник

В этом разделе мы рассмотрим детально Jmix Maps. Мы углубимся в то, как слои способствуют организации данных на карте, и изучим источники, которые предоставляют визуальный контент. Кроме того, мы раскроем концепцию геообъекта и исследуем его практическое использование в контексте Jmix Maps.

Что такое карта?

Jmix Map - это компонент, который отображает географические карты из различных источников. Он поддерживает несколько слоев, что позволяет эффективно структурировать данные и реализовывать различную логику для каждого слоя.

При работе с картой важно понимать две ключевые концепции: слои и источники данных.

Слой

Слой - это способ организации данных на карте.

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

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

structure

Дополнение поддерживает следующие типы слоев:

  • Тайловый слой используется для отображения тайлов, предоставляемых сервисами XYZ тайлов.

  • Слой изображений используется для работы со статическими изображениями или изображениями WMS (Веб-сервис карт).

  • Векторный слой содержит геообъекты (сущности с атрибутами геометрии).

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

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

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

Проекция

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

Дополнение Maps поддерживает различные стандартные проекции, такие как EPSG:4326 (WGS 84 - обычно используется для координат GPS) и EPSG:3857 (Spherical Mercator - популярна для онлайн-карт благодаря своим конформным свойствам).

Проекцией по умолчанию является EPSG:4326.

Векторный источник данных

Векторный источник данных - это источник, содержащий геообъекты. Этот источник действует как соединитель между данными и UI-компонентом карты. Он передает данные вместе с дополнительной информацией о том, как геообъекты должны отображаться на карте.

Геообъект

По сути, геообъект - это сущность, которая имеет определенное свойство типа геометрии. Это свойство хранит конкретные данные для определения точек, полилиний и полигонов. Jmix предлагает компонент, поддерживающий работу с данными, позволяющий удобно соединять геообъекты с картой.

Координаты

Системы координат (CRS) определяют каждое место на Земле набором чисел, называемых координатами. Существует две основные группы систем: спроектированные системы координат (также называемые декартовыми или прямоугольными системами координат) и географические системы координат.

Географическая система координат использует градусы широты и долготы, а иногда также значение высоты для описания местоположения на поверхности земли. Наиболее популярной является Всемирная геодезическая система - WGS 84 (EPSG:4326). GPS-устройства используют ее для определения позиции на Земле.

Это система координат по умолчанию для всех координат, передаваемых в компонент Jmix Map или получаемых от него.

При работе с координатами EPSG:4326 в OpenLayers сначала указывайте долготу, а затем широту. Для получения более подробной информации обратитесь к документации OpenLayers.

После того как данные карты проецируются на плоскую поверхность, географическая система (широта-долгота), основанная на углах, измеренных на сфере, больше не действительна. Поэтому используется декартова система координат. Когда пользователь вводит координаты долготы и широты в компонент Jmix Map, он преобразует географические координаты в проецированные координаты в метрах, используемые для генерации растровых тайлов в ГИС и WM(T)S сервисах.

Маркеры

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

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