Qt 5.6 | Qt Location | QML Types | Route QML Type

Qt 5.6.3 Reference Documentation

# Route QML Type

The Route type represents one geographical route. More...

Import Statement: | import QtLocation 5.3
Since: | Qt Location 5.5

- List of all members, including inherited members

## Properties

- bounds : georectangle
- distance : real
- path : QJSValue
- segments : list<RouteSegment>
- travelTime : int

## Detailed Description

A Route type contains high level information about a route, such as the length the route, the estimated travel time for the route, and enough information to render a basic image of the route on a map.

The QGeoRoute object also contains a list of RouteSegment objects which describe subsections of the route in greater detail.

The primary means of acquiring Route objects is RouteModel.

## Example

This example shows how to display a route's maneuvers in a 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 : "" }
          }
      }

## Property Documentation

bounds : georectangle

Read-only property which holds a bounding box which encompasses the entire route.

distance : real

Read-only property which holds distance covered by this route, in meters.

path : QJSValue

Read-only property which holds the geographical coordinates of this route. Coordinates are listed in the order in which they would be traversed by someone traveling along this segment of the route.

To access individual segments you can use standard list accessors: 'path.length' indicates the number of objects and 'path[index starting from zero]' gives the actual object.

See also QtPositioning::coordinate.

segments : list<RouteSegment>

Read-only property which holds the list of RouteSegment objects of this route.

To access individual segments you can use standard list accessors: 'segments.length' indicates the number of objects and 'segments[index starting from zero]' gives the actual objects.

See also RouteSegment.

travelTime : int

Read-only property which holds the estimated amount of time it will take to traverse this route, in seconds.