В ixContinuum мне понадобилась карта для собственных объектов приложения: показать положение, провести по маршруту, следить камерой и отреагировать на вход в заданную область. Из этой задачи постепенно вырос ixGeo — компонент для Delphi FireMonkey, который рисует векторные карты локально, через Skia.

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

Монако в Geo Map Demo: здания, дороги и деревья в наклонном виде

Geo Map Demo в Windows. Монако: векторная геометрия, объёмные здания, деревья и подписи. Данные карты © OpenStreetMap contributors.

Карта внутри приложения

Мне нужно было управлять объектами карты через обычные Delphi-классы: передавать координаты и направление движения, получать события выбора, включать сопровождение камерой. С подготовленными данными всё это должно было работать без сети.

Основной визуальный компонент — TGeoMapView, наследник TSkPaintBox. Он находится на FMX-форме и рисует через Skia. Встроенного браузера здесь нет. Геометрия, поиск и граф дорог читаются из локальных файлов.

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

Что лежит в файле карты

Основой служат данные OpenStreetMap. Конвертер принимает региональные .osm.pbf и GeoPackage; предусмотрены также пути импорта Shapefile и морских данных. Результат — файл .ixgeo. Несколько региональных файлов можно открыть совместно.

По своей сути .ixgeo — это файл SQLite с собственной схемой хранения, а не переименованный MVT или MBTiles. В нём есть метаданные, описание слоёв, уровни детализации и сжатые пространственные ячейки. В тот же контейнер могут входить поисковый индекс и дорожный граф.

Исходные данные OSM / GeoPackage
               ↓
Конвертер: подготовка геометрии и атрибутов
               ↓
.ixgeo — контейнер SQLite
  • слои и метаданные
  • геометрия для диапазонов масштаба
  • сжатые пространственные ячейки
  • данные поиска и граф дорог
               ↓
TGeoMapView → Skia → FMX-форма

При подготовке карты решаются две задачи. Первый — сколько подробностей геометрии нужно при данном масштабе. Для обзора страны и отдельного квартала конвертер готовит разные представления. В коде эти диапазоны называются tiers. Второй — как внутри каждого такого представления распределить объекты по пространственным ячейкам.

Целый объект в расширенной ячейке

Для пространственного размещения используется loose quadtree — дерево квадрантов с расширенными границами ячеек. Объект помещается на самый глубокий разрешённый уровень, на котором его ограничивающий прямоугольник ещё укладывается в размер обычной ячейки. Сама ячейка выбирается по центру этого прямоугольника.

Граница хранения расширена на половину стороны ячейки в каждую сторону. Поэтому объект может пересекать обычную границу сетки, оставаясь целиком в одной записи. При чтении это учитывается: для каждого уровня выбираются ячейки, чьи расширенные области пересекают видимую часть карты.

Для моего сценария важен именно целый объект. У здания или полигона остаётся единая геометрия для выделения, подписи и запросов. Его не приходится собирать из фрагментов, разрезанных границами ячеек. При этом крупный объект попадёт на более грубый уровень дерева, а мелкие смогут разместиться глубже.

Это компромисс: расширенные границы дают лишних кандидатов возле края экрана. Но они позволяют сохранить объект целиком. Ключ ячейки включает диапазон масштаба, уровень дерева, слой и координаты ячейки; в SQLite он используется как целочисленный первичный ключ.

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

Во время работы компонент выбирает нужное представление геометрии и читает ячейки для текущего вида. Для одного файла читатели внутри процесса используют общий кэш. Значительная часть подготовки выполняется при конвертации. При движении камеры остаётся выбирать и отображать подготовленные данные.

От плоской карты к глобусу

Для отображения предусмотрены привычная плоская карта, псевдопространственный режим 2.5D с перспективой и глобус. В городском режиме контуры зданий получают высоту; поддерживаются формы крыш, части зданий, тени и деревья. Насколько подробно выглядит конкретное место, зависит от исходных атрибутов. Для Эстонии я использовал в том числе высоты из ETAK.

Стиль задаётся отдельно от геометрии. Встроены варианты OSM, Paper и Sketch, а пользовательское оформление хранится в JSON и может быть встроено в карту. Подписи используют локальные, английские или русские названия, когда соответствующие значения есть в данных.

Глобус добавил другой масштаб работы: страны, мировой рельеф, ночное оформление с огнями городов. Переход FlyTo может отдалить камеру от улицы, повернуть глобус к другому региону и снова приблизить карту.

Ночной глобус в macOS: дуги перелётов и орбита

Ночной режим в macOS. Дуги больших кругов, движущиеся объекты и орбита показывают возможности визуализации. Полёты и спутник в этом демо — симуляция; живые данные слежения к ним не подключены. Атрибуция карты сохранена в исходном скриншоте.

Всё это работает в том же компоненте: приложение может показать общий вид, а затем перейти к подробностям конкретной территории. При этом сами дуги и орбитальные анимации полезны как способ показать движение; их внешний вид не говорит о точности какой-либо подключённой модели полёта.

Объекты приложения и объекты карты

В ixGeo есть два разных источника объектов. Из файла приходят здания, дороги, территории и POI. Приложение добавляет свои точки, движущиеся маркеры, линии и области. Ради второго слоя я и начал эту работу.

Приложение передаёт положение и направление, а компонент отвечает за изображение объекта, его выбор и сопровождение камерой. Маркер может двигаться по маршруту, оставлять след, использовать анимированный спрайт с разными направлениями. Внешний вид настраивается: контур, основание, пульсация, кольцо выделения.

Когда вокруг высокие здания, метка может оказаться за ними. Для этого есть X-ray: здания вокруг объектов становятся прозрачными. Объёмные здания остаются на карте, но уже не скрывают отслеживаемый объект.

Таллин в macOS: персонажи на карте и панель настройки маркера

Собственные объекты приложения поверх карты Таллина. В панели настраиваются персонаж, цвет, контур, основание и выделение. Данные © OpenStreetMap contributors; дополнительные источники указаны на скриншоте.

Линии и области можно рисовать и редактировать мышью, расстояния и площади — измерять. Пользовательский слой сохраняется в GeoJSON. Геозоны формируют события входа, выхода и пребывания, которые приложение обрабатывает своей логикой.

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

Почему маршрутизатору недостаточно знать перекрёсток

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

Сам по себе поиск пути между вершинами графа ещё не решает задачу поворотов. Допустим, на перекрёсток можно попасть с двух улиц. Из одной поворот на нужную дорогу разрешён, из другой — запрещён. Координата перекрёстка одинакова, но допустимое продолжение пути различается.

Поэтому здесь используется вариант A*, в котором состояние связано с направленным ребром. Маршрутизатор сохраняет информацию о том, по какой дороге он вошёл в узел. При выборе следующего ребра можно проверить переход и добавить его стоимость. Время пути учитывает в том числе повороты, светофоры и знаки остановки из исходных данных.

Полученное время — оценка по графу и его атрибутам. Текущие пробки в неё не входят. Качество маршрута также зависит от полноты дорожных данных и корректности ограничений.

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

Рельеф и море — отдельными наборами данных

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

При наличии высот доступны отмывка рельефа, окраска склонов, высота и уклон в точке, а также профиль маршрута с набором и потерей высоты. В подготовке данных используются мировой рельеф NOAA ETOPO и региональные источники; для морских глубин предусмотрены, в частности, данные EMODnet.

Морской импорт включает S-57 ENC, OpenSeaMap и Nutimeri. В зависимости от источника можно показать знаки, секторы огней, опасности, области глубин и ограничений. Огни воспроизводят ритм, записанный в их атрибутах, а при выборе знака можно посмотреть его данные.

Детализация и свежесть морских данных зависят от источника и могут различаться для разных участков моря.

Как это выглядит со стороны Delphi

TGeoMapView можно поставить на форму через палитру компонентов или создать в коде. Ниже — короткий фрагмент для формы, на которой уже есть компонент с именем Map. Он открывает подготовленный файл, задаёт камеру, добавляет динамический объект и включает слежение за ним:

uses Geo.MapView, Geo.Objects;

procedure TForm1.OpenTrackingMap(const MapFileName: string);
var
  Vehicle: TGeoObject;
begin
  Map.DBPath := MapFileName;
  Map.Buildings3D := True;
  Map.SetCamera(30, 50); // азимут и наклон камеры, в градусах

  Vehicle := Map.AddObject('vehicle1', 'Vehicle 1', gokDynamic);
  Vehicle.SetPosition(59.437, 24.7536, 90); // широта, долгота, курс

  Map.FollowObjectID := 'vehicle1';
  Map.FollowMode := mfmFollowOwn;
end;

Skia включается через GlobalUseSkia := True до Application.Initialize. Следующие обновления положения можно передавать через Map.MoveObject. Сам этот фрагмент не создаёт поток координат: источник движения предоставляет приложение. Более полные примеры маршрутов, запросов и анимации находятся в демо.

Чтение SQLite в библиотеке сейчас выполняется через небольшой слой IxDAC поверх SQLite C API с использованием движка из RAD Studio. Для подключения компонента не требуется UniDAC или набор FireDAC dataset-компонентов. При этом файлы окружения зависят от платформы: например, готовые Windows-инструменты поставляются с sk4d.dll, а на macOS нужно разворачивать libcgsqlite3.dylib.

Швейцарский нож для ixGeo

Позже понадобился редактор, чтобы готовить оформление и данные без изменения кода приложения. Так появился IX Geo Studio: карта, стили, объекты и маршруты в одном интерфейсе, с сохранением проекта в .ixproj. Отдельно есть конвертер и редактор стилей.

IX Geo Studio в Windows: редактирование стиля карты Монако

IX Geo Studio. Изменения оформления видны на открытой карте. Данные © OpenStreetMap contributors.

Текущая поставка ориентирована на RAD Studio 13 Florence. Подготовлены библиотечные сборки для Win32, Win64, macOS Intel и ARM64, Android64, iOS-устройств и ARM64-симулятора iOS. В статье показана работа настольных приложений в Windows и macOS; наличие сборки под мобильную платформу ещё не означает, что на каждом устройстве проверены все возможности.

Локальные данные и живая информация

И так как основной проект ixContinuum подразумевает работу с живой информацией, то и карта будет гибридной: тяжёлая основа хранится на устройстве, а динамические данные приходят по сети. Это могут быть события города, временные ограничения, положения и состояния объектов приложения. Это пока план: готовой системы такой синхронизации в описанной версии нет.

Геометрию региона, здания и нужные дополнительные слои предполагаю один раз загружать по Wi-Fi, а затем использовать локально до следующего обновления карты. По мобильной сети получать преимущественно небольшие сообщения о том, что изменилось: объект переместился, поменял состояние, появилось или завершилось событие. Повторно передавать тяжёлую основу при каждом просмотре того же места не требуется.

Для мобильных приложений здесь нужен баланс между местом на устройстве и расходом трафика. Хранить все регионы и все слои заранее неудобно, поэтому предполагаю выбор нужных территорий и детализации, ограничение размера кэша и возможность освобождать ненужные данные. Крупные загрузки и обновления основы можно будет планировать на Wi-Fi, сохраняя мобильную связь для оперативных изменений.

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

Что хочется обсудить

ixGeo развивается как коммерческий компонент Ilan Service OÜ.

Дополнительные скриншоты и описание ixGeo — на ixnet.eu.

Статья описывает текущую разработку.

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

Как вы решаете похожие задачи в настольных и мобильных приложениях? Где для вас важна локальная карта: в полевых инструментах, диспетчеризации, просмотре треков, симуляции? О чём рассказать подробнее — формат хранения, маршрутизация или работа с движущимися объектами?

Иллюстрации — скриншоты ixGeo и IX Geo Studio. Атрибуция источников карты сохранена. Английский обзор опубликован на DelphiPraxis.