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(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() |
Verwandte Nicht-Mitglieder
| bool | operator!=(const QGeoRoute &lhs, const QGeoRoute &rhs) |
| bool | operator==(const QGeoRoute &lhs, const QGeoRoute &rhs) |
Detaillierte Beschreibung
Ein QGeoRoute-Objekt enthält allgemeine Informationen zu einer Route, wie beispielsweise die Länge der Route, die geschätzte Fahrzeit für die Route sowie ausreichende Informationen, um eine einfache Darstellung der Route auf einer Karte zu rendern.
Das QGeoRoute-Objekt enthält außerdem eine Liste von „ QGeoRouteSegment “-Objekten, die Teilabschnitte der Route detaillierter beschreiben.
Routeninformationen werden normalerweise mit der Funktion ` QGeoRoutingManager::calculateRoute()` angefordert, die eine ` QGeoRouteReply `-Instanz zurückgibt. Wenn der Vorgang erfolgreich abgeschlossen wurde, können die Routeninformationen mit ` QGeoRouteReply::routes()` abgerufen werden.
Siehe auch QGeoRoutingManager.
Dokumentation zu den Eigenschaften
[read-only] bounds : const QGeoRectangle
Diese Eigenschaft enthält den Begrenzungsrahmen, der die gesamte Route umfasst
Zugriffsfunktionen:
| QGeoRectangle | bounds() const |
[read-only] distance : const qreal
Diese Eigenschaft gibt die von dieser Route zurückgelegte Strecke in Metern an
Zugriffsfunktionen:
| qreal | distance() const |
[read-only] extendedAttributes : const QVariantMap
Diese Eigenschaft enthält die mit dieser Route verknüpften erweiterten Attribute
Zugriffsfunktionen:
| QVariantMap | extendedAttributes() const |
[read-only] legIndex : const int
Diese Eigenschaft enthält den Abschnittsindex dieser Route
Der Index der Etappe innerhalb der übergeordneten 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, zu der dieser Routenabschnitt gehört
Ist diese Route kein Teilabschnitt einer Gesamtroute, enthält diese Eigenschaft eine leere Route.
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 einer Person durchlaufen würden, die diesen Streckenabschnitt zurücklegt.
Zugriffsfunktionen:
| QList<QGeoCoordinate> | path() const |
| void | setPath(const QList<QGeoCoordinate> &path) |
[read-only] routeId : const QString
Diese Eigenschaft enthält die Kennung dieser Route
Dienstanbieter, die die Aktualisierung von Routen unterstützen, weisen Routen üblicherweise Kennungen zu. Stammt diese Route von einem solchen Dienstanbieter, führt eine Änderung der Kennung wahrscheinlich dazu, dass Routenaktualisierungen nicht mehr funktionieren.
Zugriffsfunktionen:
| QString | routeId() const |
[read-only] routeLegs : const QList<QGeoRoute>
Diese Eigenschaft enthält die Routen- legs en für eine Route mit mehreren Wegpunkten
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 gibt die Anzahl der Segmente in der Route an
Zugriffsfunktionen:
| qsizetype | segmentsCount() const |
[read-only] travelTime : const int
Diese Eigenschaft enthält die geschätzte Zeit, die für die Durchfahrt dieser Route benötigt wird, in Sekunden
Zugriffsfunktionen:
| int | travelTime() const |
Dokumentation der Mitgliedsfunktionen
QGeoRoute::QGeoRoute()
Erstellt ein Routenobjekt.
[noexcept] QGeoRoute::QGeoRoute(const QGeoRoute &other)
Erstellt ein Routenobjekt aus dem Inhalt von other.
[constexpr noexcept default] QGeoRoute::QGeoRoute(QGeoRoute &&other)
Erstellt eine Instanz von ` QGeoRoute` mithilfe von `Move`.
[noexcept] QGeoRoute::~QGeoRoute()
Löscht dieses Routenobjekt.
[protected] QExplicitlySharedDataPointer<QGeoRoutePrivate> &QGeoRoute::d()
Gibt die private Implementierung zurück.
QGeoRouteSegment QGeoRoute::firstRouteSegment() const
Gibt das erste Routenabschnitt der Route zurück.
Gibt ein ungültiges Routenabschnitt zurück, wenn der Route keine Routenabschnitte zugeordnet sind.
Auf die übrigen Routenabschnitte kann nacheinander mit ` QGeoRouteSegment::nextRouteSegment` zugegriffen werden.
Siehe auch ` setFirstRouteSegment()`.
void QGeoRoute::setFirstRouteSegment(const QGeoRouteSegment &routeSegment)
Legt das erste Routenabschnitt der Route auf routeSegment fest.
Siehe auch firstRouteSegment().
void QGeoRoute::setTravelMode(QGeoRouteRequest::TravelMode mode)
Legt den Reisemodus für diese Route auf „ mode “ fest.
Dies sollte einer der von `request().travelModes()` zurückgegebenen Reisemodi sein.
Siehe auch ` travelMode()`.
QGeoRouteRequest::TravelMode QGeoRoute::travelMode() const
Gibt den Reisemodus für diese Route zurück.
Dies sollte einer der von `request().travelModes()` zurückgegebenen Reisemodi sein.
Siehe auch ` setTravelMode()`.
[noexcept] QGeoRoute &QGeoRoute::operator=(const QGeoRoute &other)
Weist dieser Route den Inhalt von ` other ` zu und gibt eine Referenz auf diese Route zurück.
© 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.
