QGeoRouteRequest Class
Die Klasse „QGeoRouteRequest“ repräsentiert die Parameter und Einschränkungen, die eine Anfrage nach Routeninformationen definieren. Mehr...
| Header: | #include <QGeoRouteRequest> |
| qmake: | QT += location |
Öffentliche Typen
| 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 |
Öffentliche Funktionen
| 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) |
Verwandte Nicht-Mitglieder
| bool | operator!=(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs) |
| bool | operator==(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs) |
Ausführliche Beschreibung
Der Standardzustand einer QGeoRouteRequest-Instanz führt zu einer Anfrage nach grundlegenden Routensegmenten und Navigationsmanövern, die die schnellste Route mit dem Auto beschreiben, die die angegebenen Wegpunkte abdeckt.
Es kann erhebliche Unterschiede bei den von verschiedenen Anbietern von Routeninformationen unterstützten Funktionen geben, oder sogar bei den vom selben Anbieter unterstützten Funktionen, wenn unterschiedliche Autorisierungsstufen verwendet werden.
QGeoRoutingManager enthält mehrere Funktionen, mit denen überprüft werden kann, welche Funktionen beim aktuellen Anbieter und auf der aktuellen Berechtigungsstufe unterstützt werden.
Siehe auch QGeoRoutingManager.
Dokumentation zum Mitgliedstyp
enum QGeoRouteRequest::FeatureType
flags QGeoRouteRequest::FeatureTypes
Definiert ein Merkmal, das für die Planung einer Route wichtig ist.
Diese Werte werden in Kombination mit „ QGeoRouteRequest::FeatureWeight “ verwendet, um zu bestimmen, ob sie Teil der Route sein sollen oder nicht.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoRouteRequest::NoFeature | 0x00000000 | Wird von „ QGeoRoutingManager::supportedFeatureTypes()“ verwendet, um anzugeben, dass bei der Routenplanung keine Merkmale berücksichtigt werden sollen. |
QGeoRouteRequest::TollFeature | 0x00000001 | Mautstraßen bei der Routenplanung berücksichtigen. |
QGeoRouteRequest::HighwayFeature | 0x00000002 | Autobahnen bei der Routenplanung berücksichtigen. |
QGeoRouteRequest::PublicTransitFeature | 0x00000004 | Öffentliche Verkehrsmittel bei der Routenplanung berücksichtigen. |
QGeoRouteRequest::FerryFeature | 0x00000008 | Fähren bei der Routenplanung berücksichtigen. |
QGeoRouteRequest::TunnelFeature | 0x00000010 | Berücksichtige Tunnel bei der Routenplanung. |
QGeoRouteRequest::DirtRoadFeature | 0x00000020 | Berücksichtigen Sie bei der Routenplanung unbefestigte Straßen. |
QGeoRouteRequest::ParksFeature | 0x00000040 | Berücksichtigen Sie bei der Routenplanung Parks. |
QGeoRouteRequest::MotorPoolLaneFeature | 0x00000080 | Berücksichtigen Sie bei der Routenplanung Fahrspuren für Fahrgemeinschaften. |
QGeoRouteRequest::TrafficFeature | 0x00000100 | Berücksichtigen Sie bei der Routenplanung die aktuelle Verkehrslage. Seit „ QtLocation “ 5.10 |
Der Typ „FeatureTypes“ ist eine Typdefinition für „QFlags<FeatureType>“. Er speichert eine ODER-Kombination von „FeatureType“-Werten.
enum QGeoRouteRequest::FeatureWeight
flags QGeoRouteRequest::FeatureWeights
Legt die Gewichtung fest, die einem Objekt bei der Routenplanung zugewiesen werden soll.
Diese Werte werden in Kombination mit `QGeoRouteRequest::Feature` verwendet, um zu bestimmen, ob die Objekte in die Route einbezogen werden sollen oder nicht.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoRouteRequest::NeutralFeatureWeight | 0x00000000 | Das Vorhandensein oder Fehlen des Objekts hat keinen Einfluss auf die Routenplanung. |
QGeoRouteRequest::PreferFeatureWeight | 0x00000001 | Routen, die das Objekt enthalten, werden gegenüber solchen bevorzugt, die es nicht enthalten. |
QGeoRouteRequest::RequireFeatureWeight | 0x00000002 | Es werden nur Routen berücksichtigt, die das Merkmal enthalten; andernfalls wird keine Route zurückgegeben. |
QGeoRouteRequest::AvoidFeatureWeight | 0x00000004 | Routen, die das Merkmal nicht enthalten, werden gegenüber solchen bevorzugt, die es enthalten. |
QGeoRouteRequest::DisallowFeatureWeight | 0x00000008 | Es werden nur Routen berücksichtigt, die das Merkmal nicht enthalten; andernfalls wird keine Route zurückgegeben. |
Der Typ „FeatureWeights“ ist eine Typdefinition für „QFlags<FeatureWeight>“. Er speichert eine ODER-Kombination von „FeatureWeight“-Werten.
enum QGeoRouteRequest::ManeuverDetail
flags QGeoRouteRequest::ManeuverDetails
Legt fest, wie viele Manöverinformationen in die Route aufgenommen werden sollen.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoRouteRequest::NoManeuvers | 0x0000 | Es sollen keine Manöver in die Route aufgenommen werden. |
QGeoRouteRequest::BasicManeuvers | 0x0001 | Grundlegende Manöver werden in die Route aufgenommen. Dazu gehört „ QGeoManeuver::instructionText()“. |
Der Typ „ManeuverDetails“ ist eine Typdefinition für „QFlags<ManeuverDetail>“. Er speichert eine OR-Kombination von „ManeuverDetail“-Werten.
enum QGeoRouteRequest::RouteOptimization
flags QGeoRouteRequest::RouteOptimizations
Legt die Art der Optimierung fest, die bei der Routenplanung angewendet wird.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoRouteRequest::ShortestRoute | 0x0001 | Minimieren Sie die Länge der Fahrt. |
QGeoRouteRequest::FastestRoute | 0x0002 | Minimierung der Fahrzeit für die Fahrt. |
QGeoRouteRequest::MostEconomicRoute | 0x0004 | Minimiere die Kosten der Reise. |
QGeoRouteRequest::MostScenicRoute | 0x0008 | Maximieren Sie das landschaftliche Potenzial der Reise. |
Der Typ „RouteOptimizations“ ist eine Typdefinition für „QFlags<RouteOptimization>“. Er speichert eine ODER-Kombination von „RouteOptimization“-Werten.
enum QGeoRouteRequest::SegmentDetail
flags QGeoRouteRequest::SegmentDetails
Legt fest, wie viele Informationen zu den Routenabschnitten in der Route enthalten sein sollen.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoRouteRequest::NoSegmentData | 0x0000 | Es sollen keine Segmentdaten in die Route aufgenommen werden. Eine Route, die mit diesem Detaillierungsgrad angefordert wird, initialisiert ` QGeoRouteSegment::path()` als gerade Linie zwischen den Positionen der vorherigen und der nächsten ` QGeoManeuver `-Instanz. |
QGeoRouteRequest::BasicSegmentData | 0x0001 | Grundlegende Segmentdaten werden in die Route aufgenommen. Dazu gehört auch ` QGeoRouteSegment::path()`. |
Der Typ „SegmentDetails“ ist ein typedef für QFlags<SegmentDetail>. Er speichert eine ODER-Kombination von SegmentDetail-Werten.
enum QGeoRouteRequest::TravelMode
flags QGeoRouteRequest::TravelModes
Legt die für eine Route zu verwendenden Verkehrsmittel fest.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoRouteRequest::CarTravel | 0x0001 | Die Route wird für jemanden optimiert, der mit dem Auto unterwegs ist. |
QGeoRouteRequest::PedestrianTravel | 0x0002 | Die Route wird für eine Person optimiert, die zu Fuß unterwegs ist. |
QGeoRouteRequest::BicycleTravel | 0x0004 | Die Route wird für jemanden optimiert, der mit dem Fahrrad unterwegs ist. |
QGeoRouteRequest::PublicTransitTravel | 0x0008 | Die Route wird für Personen optimiert, die öffentliche Verkehrsmittel nutzen. |
QGeoRouteRequest::TruckTravel | 0x0010 | Die Route wird für Personen optimiert, die mit einem Lkw unterwegs sind. |
Der Typ „TravelModes“ ist eine Typdefinition für „QFlags<TravelMode>“. Er speichert eine ODER-Kombination von „TravelMode“-Werten.
Dokumentation der Mitgliedsfunktionen
[explicit] QGeoRouteRequest::QGeoRouteRequest(const QList<QGeoCoordinate> &waypoints = QList<QGeoCoordinate>())
Erstellt eine Anfrage zur Berechnung einer Route durch die Koordinaten waypoints.
Die Route verläuft der Reihe nach durch die Objekte von waypoints.
QGeoRouteRequest::QGeoRouteRequest(const QGeoCoordinate &origin, const QGeoCoordinate &destination)
Erstellt eine Anfrage zur Berechnung einer Route zwischen origin und destination.
[noexcept] QGeoRouteRequest::QGeoRouteRequest(const QGeoRouteRequest &other)
Erstellt ein Routenanfrageobjekt aus dem Inhalt von other.
[constexpr noexcept default] QGeoRouteRequest::QGeoRouteRequest(QGeoRouteRequest &&other)
Erstellt eine Instanz von „ QGeoRouteRequest “ mithilfe von „Move“.
[noexcept] QGeoRouteRequest::~QGeoRouteRequest()
Löscht die Anfrage.
QDateTime QGeoRouteRequest::departureTime() const
Gibt die Abfahrtszeit aus der Anfrage zurück.
Siehe auch setDepartureTime().
QList<QGeoRectangle> QGeoRouteRequest::excludeAreas() const
Gibt Bereiche zurück, die die Route nicht kreuzen darf.
Siehe auch „ setExcludeAreas()“.
QList<QGeoRouteRequest::FeatureType> QGeoRouteRequest::featureTypes() const
Gibt die Liste der Merkmale zurück, die bei der Routenplanung berücksichtigt werden. Merkmale mit der Gewichtung „ NeutralFeatureWeight “ werden nicht zurückgegeben.
QGeoRouteRequest::FeatureWeight QGeoRouteRequest::featureWeight(QGeoRouteRequest::FeatureType featureType) const
Gibt die Gewichtung zurück, die „ featureType “ bei der Routenplanung zugewiesen wurde.
Wenn für „ featureType “ kein Merkmalsgewicht angegeben wurde, wird „ NeutralFeatureWeight “ zurückgegeben.
Siehe auch „ setFeatureWeight()“.
QGeoRouteRequest::ManeuverDetail QGeoRouteRequest::maneuverDetail() const
Gibt den Detaillierungsgrad zurück, der bei der Darstellung von Routing-Manövern verwendet wird.
Siehe auch „ setManeuverDetail()“.
int QGeoRouteRequest::numberAlternativeRoutes() const
Gibt die Anzahl der alternativen Routen zurück, die angefordert werden.
Siehe auch setNumberAlternativeRoutes().
QGeoRouteRequest::RouteOptimizations QGeoRouteRequest::routeOptimization() const
Gibt die Optimierungskriterien zurück, die laut dieser Anfrage bei der Routenplanung verwendet werden sollen.
Siehe auch „ setRouteOptimization()“.
QGeoRouteRequest::SegmentDetail QGeoRouteRequest::segmentDetail() const
Gibt den Detaillierungsgrad zurück, der bei der Darstellung von Routensegmenten verwendet wird.
Siehe auch „ setSegmentDetail()“.
void QGeoRouteRequest::setDepartureTime(const QDateTime &departureTime)
Legt die Abfahrtszeit departureTime für die Routenberechnung fest. Diese Information kann vom Backend genutzt werden, um eine schnellere Route zu berechnen, beispielsweise durch die Umgehung von Staus während der Hauptverkehrszeit.
Der Standardwert ist ein ungültiges „ QDateTime “.
Siehe auch departureTime().
void QGeoRouteRequest::setExcludeAreas(const QList<QGeoRectangle> &areas)
Legt areas als ausgeschlossene Bereiche fest, die die Route nicht durchqueren darf.
Siehe auch excludeAreas().
void QGeoRouteRequest::setFeatureWeight(QGeoRouteRequest::FeatureType featureType, QGeoRouteRequest::FeatureWeight featureWeight)
Weist dem Merkmal „ featureType “ bei der Routenplanung das Gewicht „ featureWeight “ zu.
Standardmäßig wird allen Merkmalen das Gewicht „ NeutralFeatureWeight “ zugewiesen.
Es ist nicht möglich, „ QGeoRouteRequest::NoFeature “ eine Gewichtung zuzuweisen.
Siehe auch featureWeight().
void QGeoRouteRequest::setManeuverDetail(QGeoRouteRequest::ManeuverDetail maneuverDetail)
Legt den Detaillierungsgrad fest, der bei der Darstellung von Routing-Manövern in „ maneuverDetail “ verwendet werden soll.
Der Standardwert ist „ QGeoRouteRequest::BasicManeuvers “.
Siehe auch ` maneuverDetail()`.
void QGeoRouteRequest::setNumberAlternativeRoutes(int alternatives)
Legt die Anzahl der alternativen Routen fest, die bei alternatives angefordert werden sollen. Ist alternatives negativ, wird die Anzahl der alternativen Routen auf 0 gesetzt.
Der Standardwert ist 0.
Siehe auch numberAlternativeRoutes().
void QGeoRouteRequest::setRouteOptimization(QGeoRouteRequest::RouteOptimizations optimization)
Legt die Optimierungskriterien fest, die bei der Routenplanung zu optimization verwendet werden sollen.
Der Standardwert ist „ QGeoRouteRequest::FastestRoute “.
Siehe auch routeOptimization().
void QGeoRouteRequest::setSegmentDetail(QGeoRouteRequest::SegmentDetail segmentDetail)
Legt den Detaillierungsgrad fest, der bei der Darstellung von Routing-Segmenten in „ segmentDetail “ verwendet werden soll.
Siehe auch „ segmentDetail()“.
void QGeoRouteRequest::setTravelModes(QGeoRouteRequest::TravelModes travelModes)
Legt die Verkehrsmittel fest, die bei der Routenplanung berücksichtigt werden sollen: travelModes.
Der Standardwert ist QGeoRouteRequest::CarTravel.
Siehe auch ` travelModes()`.
void QGeoRouteRequest::setWaypoints(const QList<QGeoCoordinate> &waypoints)
Legt „ waypoints “ als Wegpunkte fest, die die Route durchlaufen soll.
Die Wegpunkte sollten in der Reihenfolge vom Startpunkt zum Zielpunkt angegeben werden.
Diese Anfrage ist so lange ungültig, bis die Wegpunkte auf eine Liste mit zwei oder mehr Koordinaten festgelegt wurden.
Siehe auch waypoints().
QGeoRouteRequest::TravelModes QGeoRouteRequest::travelModes() const
Gibt die Verkehrsmittel zurück, die laut dieser Anfrage bei der Routenplanung berücksichtigt werden sollen.
Siehe auch „ setTravelModes()“.
QList<QGeoCoordinate> QGeoRouteRequest::waypoints() const
Gibt die Wegpunkte zurück, die die Route durchläuft.
Siehe auch „ setWaypoints()“.
[noexcept] QGeoRouteRequest &QGeoRouteRequest::operator=(const QGeoRouteRequest &other)
Weist diesem Routenanfrageobjekt die Eigenschaft „ other “ zu und gibt anschließend eine Referenz auf dieses Routenanfrageobjekt zurück.
Verwandte Nicht-Mitglieder
[noexcept] bool operator!=(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs)
Gibt zurück, ob die Routenanfragen lhs und rhs nicht identisch sind.
[noexcept] bool operator==(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs)
Gibt zurück, ob die Routenanfragen lhs und rhs identisch sind.
© 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.