RouteQuery QML Type

RouteQuery 型は、RouteModel にクエリパラメータを渡すために使用されます。詳細...

• 継承されたメンバーを含むすべてのメンバーの一覧

プロパティ

• 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)

詳細な説明

RouteQuery は、ルーティングサービスへのリクエストに必要なすべてのパラメータをまとめ、RouteModel の内容を設定するために使用されます。

これらのパラメータは、通過するwaypoints 、回避するexcludedAreas 、使用されるtravelModes などのルートの重要な詳細情報に加え、ルートの最適化方法や、経路上で優先または回避すべき機能（有料道路、高速道路など）に関する詳細な設定を記述します。

RouteQuery オブジェクトは、RouteModel のquery プロパティの値を設定するためにのみ使用され、これによりモデルにデータを格納するための取得プロセスが開始されます。

プラグインによっては、動作するために特定のパラメータを許可または必要とする場合があります。これらのプラグイン固有のパラメータを指定するために、RouteQuery内にMapParameter要素をネストさせることができます。

使用例

以下のスニペットは、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> [read-only]

ルート計画の際に考慮される特徴の一覧。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.BasicManeuvers です。

numberAlternativeRoutes : int

ルート指定時に要求する代替ルートの数。デフォルト値は 0 です。

routeOptimizations : enumeration

ルートの計画時に考慮すべきルートの最適化項目です。値はOR（「|」）演算子で組み合わせることができます。

デフォルト値はRouteQuery.FastestRoute です。

segmentDetail : enumeration

ルーティングセグメントの表現に使用される詳細度。

デフォルト値はRouteQuery.BasicSegmentData です。

travelModes : enumeration

ルートの計画時に考慮すべき移動手段。値はOR（「|」）演算子で組み合わせることができます。

デフォルト値は `RouteQuery.CarTravel` です。

waypoints : list<coordinate>

目的のルートのウェイポイントの座標。ウェイポイントは、出発地から目的地への順に指定する必要があります。2つ以上の座標が必要です。

ウェイポイントは、RouteQuery 型の宣言の一部として設定することも、提供されている関数を使用して動的に設定することもできます。

「 addWaypoint 」、「removeWaypoint 」、および「clearWaypoints 」も参照してください 。

メソッドのドキュメント

void addExcludedArea(geoRectangle area)

指定されたgeoRectangle 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）にリセットします。

featureTypes 、setFeatureWeight 、およびfeatureWeightも参照してください 。

void setFeatureWeight(FeatureType feature, FeatureWeight weight)

ルートの計画時に、feature に関連付けるweight を定義します。

使用可能なフィーチャー重みの一覧は以下の通りです：

関連項目: featureTypes 、resetFeatureWeights 、およびfeatureWeight 。