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() |
Elementos no miembros relacionados
| 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.
© 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.