Справочник

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

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

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

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

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

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

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

Источник данных относится к сервису, откуда поступает изображение. Это изображение обычно служит в качестве фонового слоя карты и предоставляет пространственный контекст. Вы можете получать изображения, используя поставщиков услуг с открытым исходным кодом или коммерческих поставщиков: сервисы 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 или получаемых от него.

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

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

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