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 プロパティの値を入力するためだけに使用されます。

プラグインによっては、操作に特定のパラメータを許可または要求する場合があります。これらのプラグイン固有のパラメータを指定するために、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> [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 を除外領域（ルートが横切ってはならない領域）に追加する。同じエリアは一度しか追加できません。

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も参照 。