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

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

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

Карты

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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