Карты и навигация (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, между сегментами.

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