Карты и навигация (QML)

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

Основано на концепциях и типах API в API позиционирования QML. Более практическое введение в типы Карты и навигации можно найти в учебнике по картам и навигации.

Карты

Отображение карт

Отображение карты выполняется с помощью типов QML Map. Тип Map поддерживает взаимодействие пользователя через тип QML MapGestureArea. Объект Map рисует карту на экране с использованием OpenGL (ES), что позволяет использовать ускоренную отрисовку на аппаратном уровне, где это возможно.

Ключевые типы

Обратите внимание, что клиент должен создать объект Плагин перед использованием типа Карта для доступа к данным карты для отображения.

Размещение объектов на карте (объекты наложения на карту)

Карты также могут содержать объекты наложения на карту, которые используются для отображения информации на её поверхности. Существует набор основных предопределённых объектов наложения на карту, а также возможность реализации пользовательских объектов наложения на карту с использованием типа MapQuickItem, который может содержать любой стандартный элемент QtQuick.

Ключевые типы

Модель-Представление дизайн с объектами наложения на карту

Для автоматического создания объектов наложения на карту на основе содержимого модели QtQuick (например, элемента ListModel), доступен тип MapItemView. Он принимает любой объект наложения на карту в качестве своего делегата и может быть создан только в пределах объекта Map.

Ключевые типы

Взаимодействие с объектами наложения на карту

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

Геокодирование — адрес в координаты и наоборот

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

Запрос геокодирования в QML выполняется с помощью типа GeocodeModel. Для запроса адреса в координаты его свойство query может быть установлено на объект Address или строку, содержащую текстовую форму адреса для поиска. Для выполнения обратного преобразования то же свойство можно установить на координату вместо этого. Результаты становятся доступными в содержимом модели.

Ключевые типы

Обратите внимание, что клиент должен создать объект Плагин до использования объекта GeocodeModel. Это позволит получить доступ к услугам геокодирования и, следовательно, к данным для отображения.

Маршрутизация и навигация

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

Ключевые типы