En esta página

QGeoRoute Class

La clase QGeoRoute representa una ruta entre dos puntos. Más...

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

Propiedades

Funciones públicas

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)

Funciones protegidas

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

Descripción Detallada

Un objeto QGeoRoute contiene información de alto nivel sobre una ruta, como la longitud de la ruta, el tiempo de viaje estimado para la ruta y suficiente información para representar una imagen básica de la ruta en un mapa.

El objeto QGeoRoute también contiene una lista de objetos QGeoRouteSegment que describen subsecciones de la ruta con mayor detalle.

La información sobre la ruta se solicita normalmente utilizando QGeoRoutingManager::calculateRoute(), que devuelve una instancia de QGeoRouteReply. Si la operación se completa con éxito, se puede acceder a la información de enrutamiento con QGeoRouteReply::routes()

Véase también QGeoRoutingManager.

Documentación de propiedades

[read-only] bounds : const QGeoRectangle

Esta propiedad contiene el cuadro delimitador que abarca toda la ruta

Funciones de acceso:

QGeoRectangle bounds() const

[read-only] distance : const qreal

Esta propiedad contiene la distancia recorrida por esta ruta, en metros

Funciones de acceso:

qreal distance() const

[read-only] extendedAttributes : const QVariantMap

Esta propiedad contiene los atributos ampliados asociados a esta ruta

Funciones de acceso:

QVariantMap extendedAttributes() const

[read-only] legIndex : const int

Esta propiedad contiene el índice del tramo de esta ruta

El índice del tramo dentro de la lista que contiene QGeoRoute::routeLegs puede utilizarse para encontrar los siguientes tramos.

Funciones de acceso:

int legIndex() const

[read-only] overallRoute : const QGeoRoute

Esta propiedad contiene la ruta que contiene este tramo de ruta

Si esta ruta no es un tramo dentro de una ruta global, esta propiedad contiene una ruta vacía.

Funciones de acceso:

QGeoRoute overallRoute() const

path : QList<QGeoCoordinate>

Esta propiedad contiene la forma geométrica de la ruta

Las coordenadas deben enumerarse en el orden en que serían recorridas por alguien que viajara a lo largo de este segmento de la ruta.

Funciones de acceso:

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

[read-only] routeId : const QString

Esta propiedad contiene el identificador de esta ruta

Los proveedores de servicios que soportan la actualización de rutas suelen asignar identificadores a las rutas. Si esta ruta proviene de un proveedor de servicios de este tipo, cambiar el identificador probablemente hará que las actualizaciones de ruta dejen de funcionar.

Funciones de acceso:

QString routeId() const

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

Esta propiedad contiene la ruta legs para una ruta multipunto

Funciones de acceso:

QList<QGeoRoute> routeLegs() const

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

Esta propiedad contiene la lista de objetos QGeoRouteSegment de esta ruta

Funciones de acceso:

QList<QGeoRouteSegment> segments() const

[read-only] segmentsCount : const qsizetype

Esta propiedad contiene el número de segmentos de la ruta

Funciones de acceso:

qsizetype segmentsCount() const

[read-only] travelTime : const int

Esta propiedad contiene la cantidad estimada de tiempo que se tardará en recorrer esta ruta, en segundos

Funciones de acceso:

int travelTime() const

Documentación de funciones miembro

QGeoRoute::QGeoRoute()

Construye un objeto de ruta.

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

Construye un objeto de ruta a partir del contenido de other.

[noexcept] QGeoRoute::~QGeoRoute()

Destruye este objeto de ruta.

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

Devuelve la implementación privada.

QGeoRouteSegment QGeoRoute::firstRouteSegment() const

Devuelve el primer segmento de ruta de la ruta.

Devolverá un segmento de ruta inválido si no hay segmentos de ruta asociados a la ruta.

Se puede acceder a los segmentos de ruta restantes secuencialmente con QGeoRouteSegment::nextRouteSegment.

Véase también setFirstRouteSegment().

void QGeoRoute::setFirstRouteSegment(const QGeoRouteSegment &routeSegment)

Establece el primer segmento de la ruta en routeSegment.

Véase también firstRouteSegment().

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

Establece el modo de viaje de esta ruta en mode.

Debe ser uno de los modos de viaje devueltos por request().travelModes().

Véase también travelMode().

QGeoRouteRequest::TravelMode QGeoRoute::travelMode() const

Devuelve el modo de viaje de esta ruta.

Debe ser uno de los modos de viaje devueltos por request().travelModes().

Véase también setTravelMode().

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

Asigna el contenido de other a esta ruta y devuelve una referencia a esta ruta.

No miembros relacionados

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

Devuelve si las rutas lhs y rhs no son iguales.

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

Devuelve si las rutas lhs y rhs son iguales.

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