En esta página

QGeoRoute Class

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

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

Propiedades

Funciones públicas

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)

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 general sobre una ruta, como su longitud, el tiempo estimado de recorrido y datos suficientes 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 las subsecciones de la ruta con mayor detalle.

La información de la ruta se suele solicitar mediante ` QGeoRoutingManager::calculateRoute()` (), que devuelve una instancia de ` QGeoRouteReply `. Si la operación se completa con éxito, se puede acceder a la información de la ruta con ` QGeoRouteReply::routes()`

Véase también QGeoRoutingManager.

Documentación de propiedades

[read-only] bounds : const QGeoRectangle

Esta propiedad contiene el rectángulo 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 extendidos 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 « QGeoRoute::routeLegs » que lo contiene puede utilizarse para encontrar los siguientes tramos.

Funciones de acceso:

int legIndex() const

[read-only] overallRoute : const QGeoRoute

Esta propiedad contiene la ruta que incluye este tramo de ruta

Si esta ruta no forma parte 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 aparecer en el orden en que las atravesaría alguien que recorriera este tramo 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 admiten la actualización de rutas suelen asignar identificadores a las mismas. Si esta ruta procede de uno de esos proveedores de servicios, es probable que, al cambiar el identificador, las actualizaciones de la ruta dejen de funcionar.

Funciones de acceso:

QString routeId() const

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

Esta propiedad contiene la ruta legs correspondiente a una ruta con varios puntos de paso

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 indica el número de tramos de la ruta

Funciones de acceso:

qsizetype segmentsCount() const

[read-only] travelTime : const int

Esta propiedad contiene el tiempo estimado que se tardará en recorrer esta ruta, en segundos

Funciones de acceso:

int travelTime() const

Documentación de las funciones de miembro

QGeoRoute::QGeoRoute()

Crea un objeto de ruta.

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

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

[constexpr noexcept default] QGeoRoute::QGeoRoute(QGeoRoute &&other)

Crea mediante la construcción por movimiento una instancia de ` QGeoRoute`.

[noexcept] QGeoRoute::~QGeoRoute()

Elimina 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 no válido si no hay segmentos de ruta asociados a la ruta.

Se puede acceder a los segmentos de ruta restantes de forma secuencial mediante ` QGeoRouteSegment::nextRouteSegment`.

Véase también ` setFirstRouteSegment()`.

void QGeoRoute::setFirstRouteSegment(const QGeoRouteSegment &routeSegment)

Establece el primer tramo de la ruta hacia routeSegment.

Véase también ` firstRouteSegment()`.

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

Establece el modo de viaje para esta ruta en « mode ».

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

Véase también travelMode().

QGeoRouteRequest::TravelMode QGeoRoute::travelMode() const

Devuelve el modo de transporte 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 dicha ruta.

Relacionado: No miembros

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