Тип маршрута QML

Тип Route представляет собой один географический маршрут. Подробнее...

• Список всех членов, включая унаследованные члены

Свойства

• bounds : georectangle
• distance : real
• extendedAttributes : Объект
• legs : список<Маршрут>
• path : список<координата>
• routeQuery : RouteQuery
• segments : список<RouteSegment>
• travelTime : int

Методы

• bool equals(other)
• int segmentsCount()

Подробное описание

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

Объект QGeoRoute также содержит список объектов RouteSegment, которые описывают подсекции маршрута более подробно.

Основной способ получения объектов Route — RouteModel.

Пример

Этот пример демонстрирует, как отобразить маневры маршрута в ListView:

import QtQuick 2.3
import QtPositioning 5.5
import QtLocation 5.6

RouteModel {
    id: routeModel
    // model initialization
}

ListView {
    id: listview
    anchors.fill: parent
    spacing: 10
    model: routeModel.status == RouteModel.Ready ? routeModel.get(0).segments : null
    visible: model ? true : false
    delegate: Row {
        width: parent.width
        spacing: 10
        property bool hasManeuver : modelData.maneuver && modelData.maneuver.valid
        visible: hasManeuver
        Text { text: (1 + index) + "." }
        Text { text: hasManeuver ? modelData.maneuver.instructionText : "" }
    }
}

Документация по свойствам

bounds : georectangle

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

distance : real

Только для чтения свойство, которое содержит расстояние, пройденное по этому маршруту, в метрах.

extendedAttributes : Объект

Это свойство содержит расширенные атрибуты маршрута и представляет собой карту. Эти атрибуты зависят от плагина и могут быть пустыми.

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

Обратите внимание, что из-за ограничений QQmlPropertyMap невозможно декларативно указать атрибуты в QML. Назначения ключей и значений атрибутов могут быть выполнены только с помощью JavaScript.

Это свойство было добавлено в QtLocation 5.13.

legs : список<Маршрут>

Возвращает связанные с этим маршрутом ноги маршрута. Ноги маршрута — это подмаршруты между каждыми двумя смежными контрольными точками. Результат может быть пустым, если этот уровень детализации не поддерживается бэкендом.

Это свойство было добавлено в QtLocation 5.12.

path : список<координата>

Только для чтения свойство, которое содержит географические координаты этого маршрута. Координаты перечислены в порядке, в котором они проходились бы кем-то, кто идет по этому участку маршрута.

Для доступа к отдельным сегментам можно использовать стандартные средства доступа к спискам: «path.length» указывает количество объектов, а «path[индекс, начинающийся с нуля]» дает фактический объект.

См. также QtPositioning::coordinate.

routeQuery : RouteQuery

Возвращает запрос маршрута, связанный с этим маршрутом.

Это свойство было добавлено в Qt 5.11.

segments : список<RouteSegment>

Только для чтения свойство, которое содержит список объектов RouteSegment этого маршрута.

Для доступа к отдельным сегментам можно использовать стандартные средства доступа к спискам: 'segments.length' указывает количество объектов, а 'segments[индекс, начинающийся с нуля]' возвращает фактические объекты.

См. также RouteSegment.

travelTime : int

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

Документация по методам

bool equals(other)

Этот метод выполняет глубокое сравнение, если текущий маршрут идентичен маршруту other. Возвращает true если маршруты равны.

Этот метод был добавлен в Qt 5.12.

int segmentsCount()

Возвращает количество сегментов в маршруте

Этот метод был добавлен в Qt 5.11.

См. также RouteSegment.