Geo Mapping

Модуль BPM2B Geo Mapping добавляет в платформу BPM2B полноценный геопространственный слой: автоматический геокодинг адресов, режим карты в любом списке, рисование и редактирование геометрии, маршруты между объектами и аналитический дашлет с кластеризацией маркеров.

Основные функциональные возможности:

• Сущность MapObject: универсальный геообъект, привязанный к любой записи через linkParent. Хранит GeoJSON-геометрию (точки, полигоны, линии) и точку point с координатами. Уникальный индекс по parentId + parentType + field — на одно поле сущности приходится один MapObject.
• Расширение address и geoCoordinates полей: через FieldProcessing Loaders на адресных и координатных полях появляются виртуальные подполя lat, lon, shape, borderColor, backgroundColor — без хранения дублей в основной таблице.
• Автоматический геокодинг через Nominatim: хук afterSave находит address-поля, отправляет запрос в Nominatim API и создаёт/обновляет MapObject с координатами и GeoJSON-границей объекта.
• Режим «карта» в любом списке: глобальный viewSetupHandler добавляет вкладку «map» в любой list view, где есть address или geoCoordinates поля — пользователь переключается между списком и картой одной кнопкой.
• Карта в карточке записи и редактирование геометрии: Leaflet с поддержкой полноэкранного режима; Geoman добавляет инструменты рисования и редактирования полигонов, линий, точек.
• Маршруты между объектами: self-referencing связь MapObject хранит маршрут в дополнительной колонке (jsonArray); Leaflet Routing Machine строит и отображает маршруты на карте.
• Дашлет Reporting Map: через API /GeoMapping/action/mapData подтягиваются данные через MapDataProviderInterface; маркеры кластеризуются, отображаются полигоны территорий из GeoJSON, есть фильтры по статусу/территории и панель KPI.
• Свой mapProvider: модуль регистрируется в app/mapProviders и заменяет стандартный картографический провайдер (Google Maps) на Leaflet — никаких внешних API-ключей не требуется.

Модуль предназначен для команд, которые работают с физическими объектами: недвижимость, проекты по регионам, выезды сотрудников, поставки. Зависит от bpm2bGeoCoordinates ≥ 1.0.0 (базовый тип поля координат) и bpm2bApiLog ≥ 1.0.0 (логирование запросов к Nominatim).