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() | |
| 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 | ルート計画時に有料道路を考慮する。 |
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 | ルートにはセグメントデータは含まれません。このレベルのセグメント詳細で要求されたルートは、前と次のQGeoManeuver インスタンスの位置間の直線としてQGeoRouteSegment::path() を初期化します。 |
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 の内容からルートリクエストオブジェクトを構築する。
[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 が等しいかどうかを返す。
© 2025 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.
