QGeoRouteRequest Class
Die Klasse QGeoRouteRequest repräsentiert die Parameter und Einschränkungen, die eine Anfrage nach Routing-Informationen 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() | |
| 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) |
Detaillierte Beschreibung
Der Standardzustand einer QGeoRouteRequest-Instanz führt zu einer Anfrage für ein grundlegendes Routensegment und Navigationsmanöver, die die schnellste Route mit dem Auto beschreiben, die die angegebenen Wegpunkte abdeckt.
Die von verschiedenen Anbietern von Routing-Informationen unterstützten Funktionen können erheblich voneinander abweichen, oder sogar die von ein und demselben Anbieter unterstützten Funktionen, wenn unterschiedliche Autorisierungsebenen verwendet werden.
Es gibt mehrere Funktionen in QGeoRoutingManager, mit denen Sie prüfen können, welche Funktionen vom aktuellen Anbieter und der Berechtigungsstufe unterstützt werden.
Siehe auch QGeoRoutingManager.
Member Typ Dokumentation
enum QGeoRouteRequest::FeatureType
flags QGeoRouteRequest::FeatureTypes
Definiert ein Feature, 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 Planung der Route keine Merkmale berücksichtigt werden sollen. |
QGeoRouteRequest::TollFeature | 0x00000001 | Mautstraßen bei der Planung der Route berücksichtigen. |
QGeoRouteRequest::HighwayFeature | 0x00000002 | Autobahnen bei der Planung der Route berücksichtigen. |
QGeoRouteRequest::PublicTransitFeature | 0x00000004 | Öffentliche Verkehrsmittel bei der Planung der Route berücksichtigen. |
QGeoRouteRequest::FerryFeature | 0x00000008 | Berücksichtigen Sie Fähren bei der Routenplanung. |
QGeoRouteRequest::TunnelFeature | 0x00000010 | Berücksichtigen Sie bei der Planung der Route Tunnel. |
QGeoRouteRequest::DirtRoadFeature | 0x00000020 | Berücksichtigen Sie bei der Planung der Route unbefestigte Straßen. |
QGeoRouteRequest::ParksFeature | 0x00000040 | Berücksichtigen Sie bei der Planung der Route Parks. |
QGeoRouteRequest::MotorPoolLaneFeature | 0x00000080 | Berücksichtigen Sie bei der Routenplanung Schwimmbadspuren. |
QGeoRouteRequest::TrafficFeature | 0x00000100 | Berücksichtigen Sie bei der Routenplanung die aktuelle Verkehrssituation. Seit QtLocation 5.10 |
Der Typ FeatureTypes ist ein Typedef für QFlags<FeatureType>. Er speichert eine ODER-Kombination von FeatureType-Werten.
enum QGeoRouteRequest::FeatureWeight
flags QGeoRouteRequest::FeatureWeights
Legt die Gewichtung fest, die einem Feature bei der Planung einer Route zugeordnet wird.
Diese Werte werden in Kombination mit QGeoRouteRequest::Feature verwendet, um zu bestimmen, ob sie Teil der Route sein sollen oder nicht.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoRouteRequest::NeutralFeatureWeight | 0x00000000 | Das Vorhandensein oder Nichtvorhandensein des Merkmals hat keinen Einfluss auf die Planung der Route. |
QGeoRouteRequest::PreferFeatureWeight | 0x00000001 | Routen, die das Merkmal enthalten, werden gegenüber solchen, die es nicht enthalten, bevorzugt. |
QGeoRouteRequest::RequireFeatureWeight | 0x00000002 | Nur Routen, die das Merkmal enthalten, werden berücksichtigt, ansonsten wird keine Route zurückgegeben. |
QGeoRouteRequest::AvoidFeatureWeight | 0x00000004 | Routen, die das Merkmal nicht enthalten, werden gegenüber Routen, die es enthalten, bevorzugt. |
QGeoRouteRequest::DisallowFeatureWeight | 0x00000008 | Nur Routen, die das Merkmal nicht enthalten, werden berücksichtigt, andernfalls wird keine Route zurückgegeben. |
Der Typ FeatureWeights ist ein Typedef für QFlags<FeatureWeight>. Er speichert eine ODER-Kombination von FeatureWeight-Werten.
enum QGeoRouteRequest::ManeuverDetail
flags QGeoRouteRequest::ManeuverDetails
Definiert den Umfang der Manöverinformationen, die 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 ein Typedef für QFlags<ManeuverDetail>. Er speichert eine ODER-Kombination von ManeuverDetail-Werten.
enum QGeoRouteRequest::RouteOptimization
flags QGeoRouteRequest::RouteOptimizations
Definiert die Art der Optimierung, die auf die Planung der Route angewendet wird.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoRouteRequest::ShortestRoute | 0x0001 | Minimiere die Länge der Fahrt. |
QGeoRouteRequest::FastestRoute | 0x0002 | Minimierung der Fahrtzeit für die Fahrt. |
QGeoRouteRequest::MostEconomicRoute | 0x0004 | Minimiere die Kosten der Reise. |
QGeoRouteRequest::MostScenicRoute | 0x0008 | Maximiere das landschaftliche Potential der Reise. |
Der Typ RouteOptimizations ist ein Typedef für QFlags<RouteOptimization>. Er speichert eine ODER-Kombination von RouteOptimization-Werten.
enum QGeoRouteRequest::SegmentDetail
flags QGeoRouteRequest::SegmentDetails
Definiert die Menge der Routensegmentinformationen, die in die Route aufgenommen werden sollen.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoRouteRequest::NoSegmentData | 0x0000 | Es sollen keine Segmentdaten in die Route aufgenommen werden. Eine Route, die mit dieser Detailstufe angefordert wird, initialisiert QGeoRouteSegment::path() als eine 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 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
Definiert die Reisemodi, die für eine Route verwendet werden sollen.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoRouteRequest::CarTravel | 0x0001 | Die Route wird für jemanden optimiert, der ein Auto fährt. |
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 fährt. |
QGeoRouteRequest::PublicTransitTravel | 0x0008 | Die Route wird für jemanden optimiert, der den öffentlichen Nahverkehr nutzt. |
QGeoRouteRequest::TruckTravel | 0x0010 | Die Route wird für jemanden optimiert, der einen LKW fährt. |
Der Typ TravelModes ist ein Typedef für QFlags<TravelMode>. Er speichert eine ODER-Kombination von TravelMode-Werten.
Dokumentation der Mitgliedsfunktionen
[explicit] QGeoRouteRequest::QGeoRouteRequest(const QList<QGeoCoordinate> &waypoints = QList<QGeoCoordinate>())
Konstruiert eine Anfrage zur Berechnung einer Route durch die Koordinaten waypoints.
Die Route wird die Objekte von waypoints der Reihe nach durchlaufen.
QGeoRouteRequest::QGeoRouteRequest(const QGeoCoordinate &origin, const QGeoCoordinate &destination)
Konstruiert eine Anfrage zur Berechnung einer Route zwischen origin und destination.
[noexcept] QGeoRouteRequest::QGeoRouteRequest(const QGeoRouteRequest &other)
Konstruiert ein Route-Request-Objekt aus dem Inhalt von other.
[noexcept] QGeoRouteRequest::~QGeoRouteRequest()
Zerstört die Anfrage.
QDateTime QGeoRouteRequest::departureTime() const
Gibt die Abfahrtszeit in der Anfrage zurück.
Siehe auch setDepartureTime().
QList<QGeoRectangle> QGeoRouteRequest::excludeAreas() const
Gibt Gebiete zurück, die die Route nicht durchqueren darf.
Siehe auch setExcludeAreas().
QList<QGeoRouteRequest::FeatureType> QGeoRouteRequest::featureTypes() const
Gibt die Liste der Merkmale zurück, die bei der Planung der Route berücksichtigt werden sollen. Merkmale mit einem Gewicht von NeutralFeatureWeight werden nicht zurückgegeben.
QGeoRouteRequest::FeatureWeight QGeoRouteRequest::featureWeight(QGeoRouteRequest::FeatureType featureType) const
Gibt die Gewichtung zurück, die featureType bei der Planung der Route zugewiesen wurde.
Wenn für featureType keine Merkmalsgewichtung angegeben wurde, wird NeutralFeatureWeight zurückgegeben.
Siehe auch setFeatureWeight().
QGeoRouteRequest::ManeuverDetail QGeoRouteRequest::maneuverDetail() const
Gibt den Detaillierungsgrad zurück, der für die 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 Planung der Route verwendet werden sollen.
Siehe auch setRouteOptimization().
QGeoRouteRequest::SegmentDetail QGeoRouteRequest::segmentDetail() const
Gibt den Detaillierungsgrad zurück, der bei der Darstellung von Routing-Segmenten verwendet werden soll.
Siehe auch setSegmentDetail().
void QGeoRouteRequest::setDepartureTime(const QDateTime &departureTime)
Legt die Abfahrtszeit departureTime für die Routenberechnung fest. Diese Information kann vom Backend verwendet werden, um eine schnellere Route zu berechnen, z. B. durch Umgehung von Verkehrsstaus während der Hauptverkehrszeit.
Der Standardwert ist ein ungültiger QDateTime.
Siehe auch departureTime().
void QGeoRouteRequest::setExcludeAreas(const QList<QGeoRectangle> &areas)
Legt areas als Ausschlussgebiete 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 Planung der Route die Gewichtung featureWeight zu.
Standardmäßig wird allen Merkmalen eine Gewichtung von 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 auf maneuverDetail verwendet wird.
Der Standardwert ist QGeoRouteRequest::BasicManeuvers.
Siehe auch maneuverDetail().
void QGeoRouteRequest::setNumberAlternativeRoutes(int alternatives)
Legt die Anzahl der an alternatives anzufordernden Alternativrouten fest. Wenn alternatives negativ ist, wird die Anzahl der Alternativrouten auf 0 gesetzt.
Der Standardwert ist 0.
Siehe auch numberAlternativeRoutes().
void QGeoRouteRequest::setRouteOptimization(QGeoRouteRequest::RouteOptimizations optimization)
Legt die Optimierungskriterien fest, die bei der Planung der Route zu optimization verwendet werden sollen.
Der Standardwert ist QGeoRouteRequest::FastestRoute.
Siehe auch routeOptimization().
void QGeoRouteRequest::setSegmentDetail(QGeoRouteRequest::SegmentDetail segmentDetail)
Legt die Detailebene fest, die bei der Darstellung von Routing-Segmenten auf segmentDetail verwendet werden soll.
Siehe auch segmentDetail().
void QGeoRouteRequest::setTravelModes(QGeoRouteRequest::TravelModes travelModes)
Legt die Reisearten fest, die bei der Planung der Route zu travelModes berücksichtigt werden sollen.
Der Standardwert ist QGeoRouteRequest::CarTravel.
Siehe auch travelModes().
void QGeoRouteRequest::setWaypoints(const QList<QGeoCoordinate> &waypoints)
Legt waypoints als Wegpunkte fest, durch die die Route führen soll.
Die Wegpunkte sollten in der Reihenfolge vom Ursprung zum Ziel angegeben werden.
Diese Anfrage ist ungültig, bis die Wegpunkte auf eine Liste mit zwei oder mehr Koordinaten gesetzt wurden.
Siehe auch waypoints().
QGeoRouteRequest::TravelModes QGeoRouteRequest::travelModes() const
Gibt die Verkehrsmittel zurück, die laut dieser Anfrage bei der Planung der Route berücksichtigt werden sollen.
Siehe auch setTravelModes().
QList<QGeoCoordinate> QGeoRouteRequest::waypoints() const
Gibt die Wegpunkte zurück, durch die die Route führt.
Siehe auch setWaypoints().
[noexcept] QGeoRouteRequest &QGeoRouteRequest::operator=(const QGeoRouteRequest &other)
Weist other diesem Routenanforderungsobjekt zu und gibt dann einen Verweis auf dieses Routenanforderungsobjekt zurück.
Verwandte Nicht-Mitglieder
[noexcept] bool operator!=(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs)
Gibt zurück, ob die Routenanfragen lhs und rhs ungleich sind.
[noexcept] bool operator==(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs)
Gibt zurück, ob die Routenanfragen lhs und rhs gleich sind.
© 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.
