route QML Value Type

ルートタイプは、1つの地理的なルートを表します。詳細...

プロパティ

• bounds : geoRectangle
• distance : real
• extendedAttributes : Object (since QtLocation 5.13)
• legIndex : int
• legs : list<route> (since QtLocation 5.12)
• overallRoute : Route
• path : list<coordinate>
• segments : list<routeSegment>
• travelTime : int

方法

• int segmentsCount()

詳細説明

ルートタイプには、ルートの長さ、推定所要時間、および地図上にルートの基本的なイメージを表示するのに十分な情報など、ルートに関する概要情報が含まれます。

QGeoRoute オブジェクトには、ルートの各区間をより詳細に記述するrouteSegment オブジェクトのリストも含まれています。

ルートオブジェクトを取得する主な手段は、RouteModel です。

例

この例では、ListView 内でルートの操作を表示する方法を示します：

import QtQuick
import QtPositioning
import QtLocation

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 : Object [since QtLocation 5.13]

このプロパティは、ルートの拡張属性を保持するマップです。これらの属性はプラグインごとに異なり、空の場合もあります。

どの属性がサポートされているか、またそれらの使用方法については、プラグインのドキュメントを参照してください。

なお、QQmlPropertyMap の制限により、QMLで属性を宣言的に指定することはできず、属性のキーと値の割り当てはJavaScriptでのみ行うことができます。

このプロパティは、QtLocation 5.13で導入されました。

legIndex : int

包含するルートの QtLocation::route::legs リスト内におけるレッグのインデックスを保持する読み取り専用プロパティです。このルートが全体ルート内のレッグではない場合、インデックスは -1 になります。

overallRouteも参照してください 。

legs : list<route> [since QtLocation 5.12]

このルートに関連付けられたルート区間を返します。ルート区間とは、隣接する2つのウェイポイント間の部分ルートのことです。バックエンドがこの詳細レベルをサポートしていない場合、結果は空になることがあります。

このプロパティは、QtLocation 5.12で導入されました。

overallRoute : Route

この区間を含むルートを保持する読み取り専用プロパティ。

path : list<coordinate>

このルートの地理座標を保持する読み取り専用プロパティです。座標は、このルートの区間を移動する人が実際に通過する順序で列挙されます。

個々の区段にアクセスするには、標準的なリストアクセサを使用できます。「path.length」はオブジェクトの数を示し、「path[0から始まるインデックス]」は実際のオブジェクトを返します。

QtPositioning::coordinateも参照してください 。

segments : list<routeSegment>

このルートのrouteSegment オブジェクトのリストを保持する読み取り専用プロパティです。

個々のセグメントにアクセスするには、標準的なリストアクセサを使用できます。「segments.length」はオブジェクトの数を示し、「segments[0から始まるインデックス]」は実際のオブジェクトを取得します。

routeSegmentも参照してください 。

travelTime : int

このルートを移動するのにかかる推定時間を秒単位で保持する読み取り専用プロパティです。

メソッドのドキュメント

int segmentsCount()

ルートに含まれるセグメントの数を返します

「routeSegment」も参照してください 。