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
features] ルートを計画する際に考慮されるフィーチャのリストを返します。重みが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 が等しいかどうかを返します。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
