Auf dieser Seite

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)
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.

KonstanteWertBeschreibung
QGeoRouteRequest::NoFeature0x00000000Wird von „ QGeoRoutingManager::supportedFeatureTypes()“ verwendet, um anzugeben, dass bei der Routenplanung keine Merkmale berücksichtigt werden sollen.
QGeoRouteRequest::TollFeature0x00000001Mautstraßen bei der Routenplanung berücksichtigen.
QGeoRouteRequest::HighwayFeature0x00000002Autobahnen bei der Routenplanung berücksichtigen.
QGeoRouteRequest::PublicTransitFeature0x00000004Öffentliche Verkehrsmittel bei der Routenplanung berücksichtigen.
QGeoRouteRequest::FerryFeature0x00000008Fähren bei der Routenplanung berücksichtigen.
QGeoRouteRequest::TunnelFeature0x00000010Berücksichtige Tunnel bei der Routenplanung.
QGeoRouteRequest::DirtRoadFeature0x00000020Berücksichtigen Sie bei der Routenplanung unbefestigte Straßen.
QGeoRouteRequest::ParksFeature0x00000040Berücksichtigen Sie bei der Routenplanung Parks.
QGeoRouteRequest::MotorPoolLaneFeature0x00000080Berücksichtigen Sie bei der Routenplanung Fahrspuren für Fahrgemeinschaften.
QGeoRouteRequest::TrafficFeature0x00000100Berü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.

KonstanteWertBeschreibung
QGeoRouteRequest::NeutralFeatureWeight0x00000000Das Vorhandensein oder Fehlen des Objekts hat keinen Einfluss auf die Routenplanung.
QGeoRouteRequest::PreferFeatureWeight0x00000001Routen, die das Objekt enthalten, werden gegenüber solchen bevorzugt, die es nicht enthalten.
QGeoRouteRequest::RequireFeatureWeight0x00000002Es werden nur Routen berücksichtigt, die das Merkmal enthalten; andernfalls wird keine Route zurückgegeben.
QGeoRouteRequest::AvoidFeatureWeight0x00000004Routen, die das Merkmal nicht enthalten, werden gegenüber solchen bevorzugt, die es enthalten.
QGeoRouteRequest::DisallowFeatureWeight0x00000008Es 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.

KonstanteWertBeschreibung
QGeoRouteRequest::NoManeuvers0x0000Es sollen keine Manöver in die Route aufgenommen werden.
QGeoRouteRequest::BasicManeuvers0x0001Grundlegende 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.

KonstanteWertBeschreibung
QGeoRouteRequest::ShortestRoute0x0001Minimieren Sie die Länge der Fahrt.
QGeoRouteRequest::FastestRoute0x0002Minimierung der Fahrzeit für die Fahrt.
QGeoRouteRequest::MostEconomicRoute0x0004Minimiere die Kosten der Reise.
QGeoRouteRequest::MostScenicRoute0x0008Maximieren 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.

KonstanteWertBeschreibung
QGeoRouteRequest::NoSegmentData0x0000Es 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::BasicSegmentData0x0001Grundlegende 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.

KonstanteWertBeschreibung
QGeoRouteRequest::CarTravel0x0001Die Route wird für jemanden optimiert, der mit dem Auto unterwegs ist.
QGeoRouteRequest::PedestrianTravel0x0002Die Route wird für eine Person optimiert, die zu Fuß unterwegs ist.
QGeoRouteRequest::BicycleTravel0x0004Die Route wird für jemanden optimiert, der mit dem Fahrrad unterwegs ist.
QGeoRouteRequest::PublicTransitTravel0x0008Die Route wird für Personen optimiert, die öffentliche Verkehrsmittel nutzen.
QGeoRouteRequest::TruckTravel0x0010Die 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.