RouteQuery QML Type
RouteQuery 型は、RouteModel にクエリパラメータを提供するために使用されます。
| Import Statement: | import QtLocation 6.8 |
| Since: | QtLocation 5.5 |
プロパティ
- departureTime : date
- excludedAreas : list<georectangle>
- featureTypes : QList<FeatureType>
- maneuverDetail : enumeration
- numberAlternativeRoutes : int
- routeOptimizations : enumeration
- segmentDetail : enumeration
- travelModes : enumeration
- waypoints : list<coordinate>
メソッド
- void addExcludedArea(georectangle area)
- void addWaypoint(coordinate)
- void clearExcludedAreas()
- void clearWaypoints()
- FeatureWeight featureWeight(FeatureType featureType)
- void removeExcludedArea(georectangle area)
- void removeWaypoint(coordinate)
- void resetFeatureWeights()
- void setFeatureWeight(FeatureType feature, FeatureWeight weight)
詳細説明
RouteModelRouteQuery は、ルーティングサービスへのリクエストに必要なすべてのパラメータをパックするために使用されます。
これらのパラメータには、waypoints 通過する、excludedAreas 回避する、travelModes 使用する、といったルートの主要な詳細や、ルートを最適化する方法や、パスに沿って優先または回避する機能（有料道路、高速道路など）に関する詳細な設定が記述されます。
RouteQuery オブジェクトは、RouteModel のquery プロパティの値を入力するためだけに使用されます。
プラグインによっては、操作に特定のパラメータを許可または要求する場合があります。これらのプラグイン固有のパラメータを指定するために、MapParameter 要素を RouteQuery 内に入れ子にすることができます。
使用例
次の例は、RouteQuery オブジェクトを作成し、RouteModel のquery プロパティの値として設定する不完全な例です。
RouteQuery {
id: aQuery
}
RouteModel {
query: aQuery
autoUpdate: false
}より完全な例については、RouteModel タイプのドキュメントと Mapviewer の例を参照してください。
RouteModelも参照してください 。
プロパティのドキュメント
departureTime : date |
ルートのクエリ時に使用される出発時刻。デフォルト値は無効な日付で、出発時刻はクエリに使用されません。
excludedAreas : list<georectangle> |
ルートが横断してはならないエリア。
除外領域は、RouteQuery 型宣言の一部として、または提供される関数で動的に設定することができる。
addExcludedArea 、removeExcludedArea 、clearExcludedAreasも参照 。
featureTypes : QList<FeatureType> |
ルート計画時に考慮されるフィーチャーのリスト。NeutralFeatureWeight の重みを持つフィーチャは返されません。
- RouteQuery.NoFeature - ルートを計画するときに考慮されるフィーチャーはありません。
- RouteQuery.TollFeature - ルートを計画するときに有料道路を考慮します。
- RouteQuery.HighwayFeature - ルートを計画する際に高速道路を考慮します。
- RouteQuery.PublicTransitFeature - ルートを計画する際に公共交通機関を考慮します。
- RouteQuery.FerryFeature - ルートを計画する際にフェリーを考慮します。
- RouteQuery.TunnelFeature - ルートを計画する際にトンネルを考慮します。
- RouteQuery.DirtRoadFeature - ルートを計画する際に未舗装道路を考慮する
- RouteQuery.ParksFeature - ルートを計画する際に公園を考慮します。
- RouteQuery.MotorPoolLaneFeature - ルートを計画する際にモータープールレーンを考慮します。
- RouteQuery.TrafficFeature - ルートを計画する際に交通を考慮する
setFeatureWeight およびfeatureWeightも参照してください 。
maneuverDetail : enumeration |
ルーティング操作の表現に使用される詳細レベル。
| 定数 | 説明 |
|---|---|
RouteQuery.NoManeuvers | ルートにはマヌーバは含まれません。 |
RouteQuery.BasicManeuvers | 基本的なマヌーバがルートに含まれる。 |
デフォルト値はRouteQuery.BasicManeuvers 。
numberAlternativeRoutes : int |
ルートを要求するときに要求される代替ルートの数。デフォルト値は 0 です。
routeOptimizations : enumeration |
ルート計画中に考慮すべきルートの最適化。値は OR ('|') -operator で組み合わせることができます。
| 定数 | 説明 |
|---|---|
RouteQuery.ShortestRoute | 所要時間の最小化 |
RouteQuery.FastestRoute | 移動時間を最小にする |
RouteQuery.MostEconomicRoute | 旅のコストを最小にする |
RouteQuery.MostScenicRoute | 旅の景観の可能性を最大化する |
デフォルト値はRouteQuery.FastestRoute です。
segmentDetail : enumeration |
ルーティングセグメントの表現に使用される詳細レベル。
| 定数 | 説明 |
|---|---|
RouteQuery.NoSegmentData | セグメントデータをルートに含めない |
RouteQuery.BasicSegmentData | 基本的なセグメントデータがルートに含まれる |
デフォルト値はRouteQuery.BasicSegmentData です。
travelModes : enumeration |
ルート計画中に考慮すべき旅行モード。値は OR ('|') 演算子で組み合わせることができます。
| 定数 | 説明 |
|---|---|
RouteQuery.CarTravel | ルートは車を運転する人のために最適化されます。 |
RouteQuery.PedestrianTravel | ルートは歩いている人に最適化されます。 |
RouteQuery.BicycleTravel | ルートは自転車に乗っている人に最適化されます。 |
RouteQuery.PublicTransit | 旅行 公共交通機関を利用する人に最適化されます。 |
RouteQuery.TruckTravel | ルートはトラックを運転している人に最適化されます。 |
デフォルト値はRouteQuery.CarTravel です。
waypoints : list<coordinate> |
希望するルートのウェイポイントの座標。ウェイポイントは出発地から目的地の順に指定します。2つ以上の座標が必要です。
ウェイポイントは、RouteQuery 型宣言の一部として、または提供される関数で動的に設定することができる。
addWaypoint 、removeWaypoint 、clearWaypointsも参照のこと 。
メソッドの説明
void addExcludedArea(georectangle area) |
指定されたジオレクタングルarea を除外領域（ルートが横切ってはならない領域）に追加します。同じ領域を追加できるのは 1 回だけです。
removeExcludedArea およびclearExcludedAreasも参照してください 。
void addWaypoint(coordinate) |
指定されたcoordinate をウェイポイントのリストに追加します。同じ座標を複数回設定できます。
removeWaypoint およびclearWaypointsも参照 。
void clearExcludedAreas() |
すべての除外領域（ルートが横切ってはならない領域）をクリアします。
addExcludedArea およびremoveExcludedAreaも参照して ください。
void clearWaypoints() |
すべてのウェイポイントをクリアします。
removeWaypoint およびaddWaypointも参照して ください。
FeatureWeight featureWeight(FeatureType featureType) |
featureType のウェイトを取得します。
featureTypes 、setFeatureWeight 、およびresetFeatureWeightsも参照して ください。
void removeExcludedArea(georectangle area) |
指定されたarea を除外領域 (ルートが越えてはならない領域) から削除します。
addExcludedArea およびclearExcludedAreas も参照して ください。
void removeWaypoint(coordinate) |
指定されたcoordinate をウェイポイントのリストから削除します。同 じ 座標が複数回現れ る と き は、 最近追加 さ れた座標 イ ン ス タ ン ス が削除 さ れます。
addWaypoint およびclearWaypointsも 参照 して く だ さ い。
void resetFeatureWeights() |
すべての特徴重みをデ フ ォ ル ト 状態 （NeutralFeatureWeight） に リ セ ッ ト し ます。
void setFeatureWeight(FeatureType feature, FeatureWeight weight) |
経路計画中にfeature と関連付けるweight を定義します。
以下は、設定可能な特徴重みの一覧です：
| 定数 | 説明 |
|---|---|
RouteQuery.NeutralFeatureWeight | その特徴があってもなくても、ルート計画には影響しない。 |
RouteQuery.PreferFeatureWeight | そのフィーチャーを含むルートは、含まないルートよりも優先される。 |
RouteQuery.RequireFeatureWeight | その特徴を含むルートのみが考慮され、そうでなければルートは返されない。 |
RouteQuery.AvoidFeatureWeight | そのフィーチャーを含まないルートが、含むルートよりも優先される |
RouteQuery.DisallowFeatureWeight | そのフィーチャーを含まないルートだけが考慮され、そうでなければルートは返されません。 |
featureTypes 、resetFeatureWeights 、featureWeightも参照してください 。
このドキュメントに含まれるコントリビューションの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
