このページでは

routeManeuver QML Type

routeManeuver タイプは、2つの routeSegment が交差する地点に関連する情報を表します。詳細...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.5

プロパティ

詳細な説明

routeSegment のインスタンスは、ルーティンググラフ上の辺と見なすことができ、routeManeuverのインスタンスは、グラフの頂点に付随するオプションのラベルと見なすことができます。

routeManeuver インスタンスが保持する最も興味深い情報は、通常、提供するナビゲーションのテキストと、それを提供する位置であり、それぞれinstructionText およびposition を通じてアクセスできます。

例

以下の QML スニペットは、ルートマニューバに関する情報を出力する方法を示しています:

import QtQuick
import QtPositioning
import QtLocation

Text {
    text: "Distance till next maneuver: " + routeManeuver.distanceToNextInstruction
          + " meters, estimated time: " + routeManeuver.timeToNextInstruction + " seconds."
}

プロパティのドキュメント

direction : enumeration

routeManeuver に関連付けられた指示テキストに伴う方向の変化について説明します。

  • RouteManeuver.NoDirection - 指示テキストに関連付けられた進行方向はありません
  • RouteManeuver.DirectionForward - 指示により、進行方向を変更する必要がない
  • RouteManeuver.DirectionBearRight - 進行方向を右に傾ける必要があることを指示しています
  • RouteManeuver.DirectionLightRight - 指示により、右へ軽く曲がる必要がある
  • RouteManeuver.DirectionRight - この指示は、右折が必要であることを示しています
  • RouteManeuver.DirectionHardRight - この指示は、右への急旋回が必要であることを示します
  • RouteManeuver.DirectionUTurnRight - 右へのUターンが必要であることを示す指示
  • RouteManeuver.DirectionUTurnLeft - この指示は、左へのUターンが必要であることを示しています
  • RouteManeuver.DirectionHardLeft - この指示は、左への急旋回が必要であることを示しています
  • RouteManeuver.DirectionLeft - この指示は、左への旋回が必要であることを示しています
  • RouteManeuver.DirectionLightLeft - 左への軽い旋回が必要であることを示す指示
  • RouteManeuver.DirectionBearLeft - 進行方向を左にずらす必要があることを示す指示

distanceToNextInstruction : real

この読み取り専用プロパティには、関連する命令が発行された地点と、次の命令が発行されるべき地点との間の距離(メートル単位)が格納されます。

extendedAttributes : Object [since QtLocation 5.11]

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

どの属性がサポートされており、どのように使用すべきかについては、プラグインのドキュメントを参照してください。

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

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

instructionText : string

この読み取り専用プロパティには、テキスト形式のナビゲーション指示が格納されています。

position : coordinate

この読み取り専用プロパティは、instructionText を表示すべき場所を指定します。

timeToNextInstruction : int

この読み取り専用プロパティには、関連する命令が発行された時点から、次の命令が発行されるべき時点までの所要時間の推定値(秒単位)が格納されます。

valid : bool

この読み取り専用プロパティは、このマニューバーが有効かどうかを表します。

無効なマニューバーは、QGeoRouteSegment インスタンスのエンドポイントに添付すべき情報がない場合に使用されます。

waypoint : coordinate

このプロパティには、このマニューバに関連付けられたウェイポイントが格納されます。すべてのマニューバにウェイポイントが関連付けられているわけではありません。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.