QGeoRouteRequest Class
QGeoRouteRequest クラスは、経路情報のリクエストを定義するパラメータや制約を表します。詳細...
| Header: | #include <QGeoRouteRequest> |
| qmake: | QT += location |
パブリック型
| enum | FeatureType { NoFeature, TollFeature, HighwayFeature, PublicTransitFeature, FerryFeature, …, TrafficFeature } |
| flags | FeatureTypes |
| enum | FeatureWeight { NeutralFeatureWeight, PreferFeatureWeight, RequireFeatureWeight, AvoidFeatureWeight, DisallowFeatureWeight } |
| flags | FeatureWeights |
| enum | ManeuverDetail { NoManeuvers, BasicManeuvers } |
| flags | ManeuverDetails |
| enum | RouteOptimization { ShortestRoute, FastestRoute, MostEconomicRoute, MostScenicRoute } |
| flags | RouteOptimizations |
| enum | SegmentDetail { NoSegmentData, BasicSegmentData } |
| flags | SegmentDetails |
| enum | TravelMode { CarTravel, PedestrianTravel, BicycleTravel, PublicTransitTravel, TruckTravel } |
| flags | TravelModes |
パブリック関数
| QGeoRouteRequest(const QList<QGeoCoordinate> &waypoints = QList<QGeoCoordinate>()) | |
| QGeoRouteRequest(const QGeoCoordinate &origin, const QGeoCoordinate &destination) | |
| QGeoRouteRequest(const QGeoRouteRequest &other) | |
| QGeoRouteRequest(QGeoRouteRequest &&other) | |
| ~QGeoRouteRequest() | |
| QDateTime | departureTime() const |
| QList<QGeoRectangle> | excludeAreas() const |
| QList<QGeoRouteRequest::FeatureType> | featureTypes() const |
| QGeoRouteRequest::FeatureWeight | featureWeight(QGeoRouteRequest::FeatureType featureType) const |
| QGeoRouteRequest::ManeuverDetail | maneuverDetail() const |
| int | numberAlternativeRoutes() const |
| QGeoRouteRequest::RouteOptimizations | routeOptimization() const |
| QGeoRouteRequest::SegmentDetail | segmentDetail() const |
| void | setDepartureTime(const QDateTime &departureTime) |
| void | setExcludeAreas(const QList<QGeoRectangle> &areas) |
| void | setFeatureWeight(QGeoRouteRequest::FeatureType featureType, QGeoRouteRequest::FeatureWeight featureWeight) |
| void | setManeuverDetail(QGeoRouteRequest::ManeuverDetail maneuverDetail) |
| void | setNumberAlternativeRoutes(int alternatives) |
| void | setRouteOptimization(QGeoRouteRequest::RouteOptimizations optimization) |
| void | setSegmentDetail(QGeoRouteRequest::SegmentDetail segmentDetail) |
| void | setTravelModes(QGeoRouteRequest::TravelModes travelModes) |
| void | setWaypoints(const QList<QGeoCoordinate> &waypoints) |
| QGeoRouteRequest::TravelModes | travelModes() const |
| QList<QGeoCoordinate> | waypoints() const |
| QGeoRouteRequest & | operator=(const QGeoRouteRequest &other) |
関連する非メンバー
| bool | operator!=(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs) |
| bool | operator==(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs) |
詳細な説明
QGeoRouteRequest インスタンスのデフォルトの状態では、指定されたウェイポイントを結ぶ、自動車による最速のルートを記述する基本的なルートセグメントおよびナビゲーション操作が要求されます。
ルート情報プロバイダによってサポートされる機能には大きな違いがあるほか、同じプロバイダであっても、認証レベルが異なればサポートされる機能も異なる場合があります。
QGeoRoutingManager には、現在のプロバイダおよび認証レベルでどの機能がサポートされているかを確認するために使用できる関数がいくつかあります。
QGeoRoutingManagerも参照してください 。
メンバータイプのドキュメント
enum QGeoRouteRequest::FeatureType
flags QGeoRouteRequest::FeatureTypes
ルートの計画において重要な要素を定義します。
これらの値は、QGeoRouteRequest::FeatureWeight と組み合わせて使用され、その地点をルートに含めるべきか否かを決定します。
| 定数 | 値 | 説明 |
|---|---|---|
QGeoRouteRequest::NoFeature | 0x00000000 | QGeoRoutingManager::supportedFeatureTypes() によって、ルートの計画においてそのフィーチャーが一切考慮されないことを示すために使用されます。 |
QGeoRouteRequest::TollFeature | 0x00000001 | 定数値説明xml-ph-0000@deepl.internal () によって使用され、ルート計画時にフィーチャーを考慮しないことを示します。 |
QGeoRouteRequest::HighwayFeature | 0x00000002 | ルート計画時に高速道路を考慮する。 |
QGeoRouteRequest::PublicTransitFeature | 0x00000004 | ルート計画時に公共交通機関を考慮します。 |
QGeoRouteRequest::FerryFeature | 0x00000008 | ルート計画時にフェリーを考慮する。 |
QGeoRouteRequest::TunnelFeature | 0x00000010 | ルート計画時にトンネルを考慮する。 |
QGeoRouteRequest::DirtRoadFeature | 0x00000020 | ルートを計画する際は、未舗装道路を考慮してください。 |
QGeoRouteRequest::ParksFeature | 0x00000040 | ルートを計画する際は、公園を考慮してください。 |
QGeoRouteRequest::MotorPoolLaneFeature | 0x00000080 | ルートを計画する際は、カープール専用レーンを考慮してください。 |
QGeoRouteRequest::TrafficFeature | 0x00000100 | ルートを計画する際は、現在の交通状況を考慮してください。QtLocation 5.10 以降 |
FeatureTypes 型は、QFlags<FeatureType> の typedef です。これは、FeatureType 値の OR 組み合わせを格納します。
enum QGeoRouteRequest::FeatureWeight
flags QGeoRouteRequest::FeatureWeights
ルートの計画時に、フィーチャーに関連付ける重みを定義します。
これらの値は、QGeoRouteRequest::Feature と組み合わせて使用され、そのフィーチャーをルートに含めるかどうかを決定します。
| 定数 | 値 | 説明 |
|---|---|---|
QGeoRouteRequest::NeutralFeatureWeight | 0x00000000 | フィーチャの有無は、ルートの計画には影響しません。 |
QGeoRouteRequest::PreferFeatureWeight | 0x00000001 | このフィーチャーを含むルートは、含まないルートよりも優先されます。 |
QGeoRouteRequest::RequireFeatureWeight | 0x00000002 | その特徴を含むルートのみが考慮され、それ以外の場合、ルートは返されません。 |
QGeoRouteRequest::AvoidFeatureWeight | 0x00000004 | その特徴を含まないルートが、その特徴を含むルートよりも優先されます。 |
QGeoRouteRequest::DisallowFeatureWeight | 0x00000008 | そのフィーチャーを含まないルートのみが考慮され、それ以外の場合はルートは返されません。 |
FeatureWeights 型は、QFlags<FeatureWeight> の typedef です。これは、FeatureWeight 値の OR 組み合わせを格納します。
enum QGeoRouteRequest::ManeuverDetail
flags QGeoRouteRequest::ManeuverDetails
ルートに含めるべき機動情報の量を定義します。
| 定数 | 値 | 説明 |
|---|---|---|
QGeoRouteRequest::NoManeuvers | 0x0000 | ルートにはマニューバを含めない。 |
QGeoRouteRequest::BasicManeuvers | 0x0001 | ルートには基本的なマニューバが含まれます。これには、QGeoManeuver::instructionText() が含まれます。 |
ManeuverDetails 型は、QFlags<ManeuverDetail> の typedef です。これは、ManeuverDetail 値の論理和（OR）の組み合わせを格納します。
enum QGeoRouteRequest::RouteOptimization
flags QGeoRouteRequest::RouteOptimizations
ルートの計画に適用される最適化のタイプを定義します。
| 定数 | 値 | 説明 |
|---|---|---|
QGeoRouteRequest::ShortestRoute | 0x0001 | 移動距離を最小限に抑えます。 |
QGeoRouteRequest::FastestRoute | 0x0002 | 移動時間を最小化します。 |
QGeoRouteRequest::MostEconomicRoute | 0x0004 | 移動のコストを最小化する。 |
QGeoRouteRequest::MostScenicRoute | 0x0008 | 移動の景観的魅力を最大化する。 |
RouteOptimizations型は、QFlags<RouteOptimization>のtypedefです。これは、RouteOptimization値の論理和（OR）の組み合わせを格納します。
enum QGeoRouteRequest::SegmentDetail
flags QGeoRouteRequest::SegmentDetails
ルートに含めるルート区間の情報の量を指定します。
| 定数 | 値 | 説明 |
|---|---|---|
QGeoRouteRequest::NoSegmentData | 0x0000 | ルートにはセグメントデータを含めない。このレベルのセグメント詳細で要求されたルートでは、QGeoRouteSegment::path() が、前のQGeoManeuver インスタンスと次の インスタンスの位置を結ぶ直線として初期化される。 |
QGeoRouteRequest::BasicSegmentData | 0x0001 | ルートには基本的なセグメントデータが含まれます。これにはQGeoRouteSegment::path()も含まれます。 |
SegmentDetails 型は、QFlags<SegmentDetail> の typedef です。これは、SegmentDetail 値の論理和（OR）を格納します。
enum QGeoRouteRequest::TravelMode
flags QGeoRouteRequest::TravelModes
ルートで使用する移動手段を定義します。
| 定数 | 値 | 説明 |
|---|---|---|
QGeoRouteRequest::CarTravel | 0x0001 | ルートは、自動車を運転する人を対象に最適化されます。 |
QGeoRouteRequest::PedestrianTravel | 0x0002 | 徒歩で移動する人を対象にルートが最適化されます。 |
QGeoRouteRequest::BicycleTravel | 0x0004 | 自転車を利用する人向けにルートが最適化されます。 |
QGeoRouteRequest::PublicTransitTravel | 0x0008 | このルートは、公共交通機関を利用する人に最適化されます。 |
QGeoRouteRequest::TruckTravel | 0x0010 | ルートは、トラックを運転する人に最適化されます。 |
TravelModes 型は、QFlags<TravelMode> の typedef です。TravelMode 値の OR 組み合わせを格納します。
メンバ関数のドキュメント
[explicit] QGeoRouteRequest::QGeoRouteRequest(const QList<QGeoCoordinate> &waypoints = QList<QGeoCoordinate>())
座標waypoints を通る経路を計算するためのリクエストを作成します。
ルートは、waypoints に含まれるオブジェクトを順に経由します。
QGeoRouteRequest::QGeoRouteRequest(const QGeoCoordinate &origin, const QGeoCoordinate &destination)
origin とdestination の間のルートを計算するためのリクエストを作成します。
[noexcept] QGeoRouteRequest::QGeoRouteRequest(const QGeoRouteRequest &other)
other の内容から、ルートリクエストオブジェクトを構築します。
[constexpr noexcept default] QGeoRouteRequest::QGeoRouteRequest(QGeoRouteRequest &&other)
QGeoRouteRequest のインスタンスをMoveコンストラクタで生成します。
[noexcept] QGeoRouteRequest::~QGeoRouteRequest()
リクエストを破棄します。
QDateTime QGeoRouteRequest::departureTime() const
リクエストに含まれる出発時刻を返します。
setDepartureTime()も参照してください 。
QList<QGeoRectangle> QGeoRouteRequest::excludeAreas() const
ルートが通過してはならない領域を返します。
setExcludeAreas()も参照してください 。
QList<QGeoRouteRequest::FeatureType> QGeoRouteRequest::featureTypes() const
経路計画の際に考慮されるフィーチャのリストを返します。重みがNeutralFeatureWeight のフィーチャは返されません。
QGeoRouteRequest::FeatureWeight QGeoRouteRequest::featureWeight(QGeoRouteRequest::FeatureType featureType) const
経路計画において、featureType に割り当てられた重みを返します。
featureType に対してフィーチャの重みが指定されていない場合、NeutralFeatureWeight が返されます。
setFeatureWeight()も参照してください 。
QGeoRouteRequest::ManeuverDetail QGeoRouteRequest::maneuverDetail() const
ルーティング操作の表現に使用される詳細度を返します。
setManeuverDetail()も参照してください 。
int QGeoRouteRequest::numberAlternativeRoutes() const
要求される代替ルートの数を返します。
setNumberAlternativeRoutes()も参照してください 。
QGeoRouteRequest::RouteOptimizations QGeoRouteRequest::routeOptimization() const
このリクエストで指定された、ルート計画時に使用すべき最適化基準を返します。
setRouteOptimization()も参照してください 。
QGeoRouteRequest::SegmentDetail QGeoRouteRequest::segmentDetail() const
ルーティングセグメントの表現に使用される詳細度を返します。
setSegmentDetail()も参照してください 。
void QGeoRouteRequest::setDepartureTime(const QDateTime &departureTime)
ルート計算のための出発時刻departureTime を設定します。この情報は、バックエンドが、例えばラッシュアワーの渋滞を避けるなどして、より速いルートを計算するために利用できます。
デフォルト値は無効なQDateTime です。
departureTime()も参照してください 。
void QGeoRouteRequest::setExcludeAreas(const QList<QGeoRectangle> &areas)
areas を、ルートが通過してはならない除外エリアとして設定します。
excludeAreas()も参照してください 。
void QGeoRouteRequest::setFeatureWeight(QGeoRouteRequest::FeatureType featureType, QGeoRouteRequest::FeatureWeight featureWeight)
経路計画の際、特徴「featureType 」に重み「featureWeight 」を割り当てます。
デフォルトでは、すべてのフィーチャに重みNeutralFeatureWeight が割り当てられます。
QGeoRouteRequest::NoFeature に重みを割り当てることはできません。
featureWeight()も参照してください 。
void QGeoRouteRequest::setManeuverDetail(QGeoRouteRequest::ManeuverDetail maneuverDetail)
maneuverDetail へのルーティング操作を表現する際に使用する詳細レベルを設定します。
デフォルト値は `QGeoRouteRequest::BasicManeuvers` です。
maneuverDetail()も参照してください 。
void QGeoRouteRequest::setNumberAlternativeRoutes(int alternatives)
alternatives にリクエストする代替ルートの数を設定します。alternatives が負の値の場合、代替ルートの数は0に設定されます。
デフォルト値は 0 です。
numberAlternativeRoutes()も参照してください 。
void QGeoRouteRequest::setRouteOptimization(QGeoRouteRequest::RouteOptimizations optimization)
optimization へのルート計画時に使用する最適化基準を設定します。
デフォルト値はQGeoRouteRequest::FastestRoute です。
routeOptimization()も参照してください 。
void QGeoRouteRequest::setSegmentDetail(QGeoRouteRequest::SegmentDetail segmentDetail)
segmentDetail へのルーティングセグメントの表現に使用する詳細レベルを設定します。
segmentDetail()も参照してください 。
void QGeoRouteRequest::setTravelModes(QGeoRouteRequest::TravelModes travelModes)
ルート計画の際に考慮すべき移動モードを、travelModes に設定します。
デフォルト値は `QGeoRouteRequest::CarTravel` です。
travelModes()も参照してください 。
void QGeoRouteRequest::setWaypoints(const QList<QGeoCoordinate> &waypoints)
waypoints を、ルートが通過すべきウェイポイントとして設定します。
ウェイポイントは、出発地から目的地への順に指定する必要があります。
ウェイポイントが 2 つ以上の座標を含むリストとして設定されるまでは、このリクエストは無効となります。
waypoints()も参照してください 。
QGeoRouteRequest::TravelModes QGeoRouteRequest::travelModes() const
このリクエストで指定された、経路計画の際に考慮すべき移動手段を返します。
setTravelModes()も参照してください 。
QList<QGeoCoordinate> QGeoRouteRequest::waypoints() const
そのルートが通過するウェイポイントを返します。
setWaypoints()も参照してください 。
[noexcept] QGeoRouteRequest &QGeoRouteRequest::operator=(const QGeoRouteRequest &other)
このルートリクエストオブジェクトにother を割り当て、その後、このルートリクエストオブジェクトへの参照を返します。
関連する非メンバー
[noexcept] bool operator!=(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs)
ルートリクエストの `lhs ` と `rhs ` が等しくないかどうかを返します。
[noexcept] bool operator==(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs)
ルートリクエスト「lhs 」と「rhs 」が等しいかどうかを返します。
© 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.
