QGeoRoute Class

Die Klasse QGeoRoute stellt eine Route zwischen zwei Punkten dar. Mehr...

Header: #include <QGeoRoute>
qmake: QT += location

Eigenschaften

Öffentliche Funktionen

QGeoRoute()
QGeoRoute(const QGeoRoute &other)
~QGeoRoute()
QGeoRectangle bounds() const
qreal distance() const
QVariantMap extendedAttributes() const
QGeoRouteSegment firstRouteSegment() const
int legIndex() const
QGeoRoute overallRoute() const
QList<QGeoCoordinate> path() const
QString routeId() const
QList<QGeoRoute> routeLegs() const
QList<QGeoRouteSegment> segments() const
qsizetype segmentsCount() const
void setFirstRouteSegment(const QGeoRouteSegment &routeSegment)
void setPath(const QList<QGeoCoordinate> &path)
void setTravelMode(QGeoRouteRequest::TravelMode mode)
QGeoRouteRequest::TravelMode travelMode() const
int travelTime() const
QGeoRoute &operator=(const QGeoRoute &other)

Geschützte Funktionen

QExplicitlySharedDataPointer<QGeoRoutePrivate> &d()
bool operator!=(const QGeoRoute &lhs, const QGeoRoute &rhs)
bool operator==(const QGeoRoute &lhs, const QGeoRoute &rhs)

Detaillierte Beschreibung

Ein QGeoRoute-Objekt enthält übergeordnete Informationen über eine Route, wie z.B. die Länge der Route, die geschätzte Reisezeit für die Route und genügend Informationen, um ein grundlegendes Bild der Route auf einer Karte darzustellen.

Das QGeoRoute-Objekt enthält auch eine Liste von QGeoRouteSegment -Objekten, die Teilabschnitte der Route detaillierter beschreiben.

Routing-Informationen werden normalerweise mit QGeoRoutingManager::calculateRoute() angefordert, das eine QGeoRouteReply -Instanz zurückgibt. Wenn die Operation erfolgreich abgeschlossen wurde, kann auf die Routing-Informationen mit QGeoRouteReply::routes() zugegriffen werden.

Siehe auch QGeoRoutingManager.

Dokumentation der Eigenschaften

[read-only] bounds : const QGeoRectangle

Diese Eigenschaft enthält den Begrenzungsrahmen, der die gesamte Route umschließt

Zugriffsfunktionen:

QGeoRectangle bounds() const

[read-only] distance : const qreal

Diese Eigenschaft enthält die von dieser Route zurückgelegte Entfernung in Metern

Zugriffsfunktionen:

qreal distance() const

[read-only] extendedAttributes : const QVariantMap

Diese Eigenschaft enthält die erweiterten Attribute, die mit dieser Route verbunden sind

Zugriffsfunktionen:

QVariantMap extendedAttributes() const

[read-only] legIndex : const int

Diese Eigenschaft enthält den Etappenindex dieser Route

Der Index der Etappe in der Liste QGeoRoute::routeLegs kann verwendet werden, um die nächsten Etappen zu finden.

Zugriffsfunktionen:

int legIndex() const

[read-only] overallRoute : const QGeoRoute

Diese Eigenschaft enthält die Route, die diesen Streckenabschnitt enthält.

Handelt es sich bei dieser Strecke nicht um eine Teilstrecke innerhalb einer Gesamtstrecke, so enthält diese Eigenschaft eine leere Strecke.

Zugriffsfunktionen:

QGeoRoute overallRoute() const

path : QList<QGeoCoordinate>

Diese Eigenschaft enthält die geometrische Form der Route

Die Koordinaten sollten in der Reihenfolge aufgeführt werden, in der sie von einem Reisenden auf diesem Streckenabschnitt durchquert werden würden.

Zugriffsfunktionen:

QList<QGeoCoordinate> path() const
void setPath(const QList<QGeoCoordinate> &path)

[read-only] routeId : const QString

Diese Eigenschaft enthält den Bezeichner dieser Route

Dienstanbieter, die die Aktualisierung von Routen unterstützen, weisen den Routen in der Regel Bezeichner zu. Wenn diese Route von einem solchen Dienstanbieter stammt, wird eine Änderung des Bezeichners wahrscheinlich dazu führen, dass die Aktualisierung der Route nicht mehr funktioniert.

Zugriffsfunktionen:

QString routeId() const

[read-only] routeLegs : const QList<QGeoRoute>

Diese Eigenschaft enthält die Route legs für eine Multi-Wegpunkt-Route

Zugriffsfunktionen:

QList<QGeoRoute> routeLegs() const

[read-only] segments : const QList<QGeoRouteSegment>

Diese Eigenschaft enthält die Liste der QGeoRouteSegment Objekte dieser Route

Zugriffsfunktionen:

QList<QGeoRouteSegment> segments() const

[read-only] segmentsCount : const qsizetype

Diese Eigenschaft enthält die Anzahl der Segmente in der Route

Zugriffsfunktionen:

qsizetype segmentsCount() const

[read-only] travelTime : const int

Diese Eigenschaft enthält die geschätzte Zeit, die für die Durchquerung dieser Route benötigt wird, in Sekunden

Zugriffsfunktionen:

int travelTime() const

Dokumentation der Mitgliedsfunktionen

QGeoRoute::QGeoRoute()

Konstruiert ein Routenobjekt.

[noexcept] QGeoRoute::QGeoRoute(const QGeoRoute &other)

Konstruiert ein Routenobjekt aus dem Inhalt von other.

[noexcept] QGeoRoute::~QGeoRoute()

Zerstört dieses Routenobjekt.

[protected] QExplicitlySharedDataPointer<QGeoRoutePrivate> &QGeoRoute::d()

Gibt die private Implementierung zurück.

QGeoRouteSegment QGeoRoute::firstRouteSegment() const

Gibt das erste Routensegment in der Route zurück.

Gibt ein ungültiges Routensegment zurück, wenn keine Routensegmente mit der Route verbunden sind.

Auf die verbleibenden Routensegmente kann mit QGeoRouteSegment::nextRouteSegment sequentiell zugegriffen werden.

Siehe auch setFirstRouteSegment().

void QGeoRoute::setFirstRouteSegment(const QGeoRouteSegment &routeSegment)

Setzt das erste Routensegment in der Route auf routeSegment.

Siehe auch firstRouteSegment().

void QGeoRoute::setTravelMode(QGeoRouteRequest::TravelMode mode)

Setzt den Reisemodus für diese Route auf mode.

Dies sollte einer der Reisemodi sein, die von request().travelModes() zurückgegeben werden.

Siehe auch travelMode().

QGeoRouteRequest::TravelMode QGeoRoute::travelMode() const

Gibt den Reisemodus für diese Route zurück.

Dies sollte einer der Reisemodi sein, die von request().travelModes() zurückgegeben werden.

Siehe auch setTravelMode().

[noexcept] QGeoRoute &QGeoRoute::operator=(const QGeoRoute &other)

Weist den Inhalt von other dieser Route zu und gibt einen Verweis auf diese Route zurück.

Verwandte Nicht-Mitglieder

[noexcept] bool operator!=(const QGeoRoute &lhs, const QGeoRoute &rhs)

Gibt zurück, ob die Routen lhs und rhs ungleich sind.

[noexcept] bool operator==(const QGeoRoute &lhs, const QGeoRoute &rhs)

Gibt zurück, ob die Routen 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.