Тип QML Маршрут

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

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

Свойства

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

Методы

• bool equals(Маршрут other)
• int segmentsCount()

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

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

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

Основной способ получения объектов Маршрут — 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.