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

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

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

Свойства

• bounds : georectangle
• distance : real
• extendedAttributes : Объект
• legs : список<Маршрут>
• path : список<координата>
• routeQuery : RouteQuery
• segments : список<УчастокМаршрута>
• 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 этого маршрута.

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

См. также УчастокМаршрута.

travelTime : int

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

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

bool equals(other)

Этот метод выполняет глубокое сравнение этого маршрута с other.

Возвращает true если маршруты считаются равными, false в противном случае.

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

int segmentsCount()

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

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

См. также УчастокМаршрута.