En esta página

QGeoRoutingManagerEngine Class

La clase `QGeoRoutingManagerEngine` proporciona una interfaz y métodos de conveniencia a los desarrolladores de complementos de ` QGeoServiceProvider ` que deseen ofrecer acceso a información de rutas geográficas. Más...

Header: #include <QGeoRoutingManagerEngine>
qmake: QT += location
Inherits: QObject

Funciones públicas

QGeoRoutingManagerEngine(const QVariantMap &parameters, QObject *parent = nullptr)
virtual ~QGeoRoutingManagerEngine()
virtual QGeoRouteReply *calculateRoute(const QGeoRouteRequest &request) = 0
QLocale locale() const
QString managerName() const
int managerVersion() const
QLocale::MeasurementSystem measurementSystem() const
void setLocale(const QLocale &locale)
void setMeasurementSystem(QLocale::MeasurementSystem system)
QGeoRouteRequest::FeatureTypes supportedFeatureTypes() const
QGeoRouteRequest::FeatureWeights supportedFeatureWeights() const
QGeoRouteRequest::ManeuverDetails supportedManeuverDetails() const
QGeoRouteRequest::RouteOptimizations supportedRouteOptimizations() const
QGeoRouteRequest::SegmentDetails supportedSegmentDetails() const
QGeoRouteRequest::TravelModes supportedTravelModes() const
virtual QGeoRouteReply *updateRoute(const QGeoRoute &route, const QGeoCoordinate &position)

Señales

void errorOccurred(QGeoRouteReply *reply, QGeoRouteReply::Error error, const QString &errorString = QString())
void finished(QGeoRouteReply *reply)

Funciones protegidas

void setSupportedFeatureTypes(QGeoRouteRequest::FeatureTypes featureTypes)
void setSupportedFeatureWeights(QGeoRouteRequest::FeatureWeights featureWeights)
void setSupportedManeuverDetails(QGeoRouteRequest::ManeuverDetails maneuverDetails)
void setSupportedRouteOptimizations(QGeoRouteRequest::RouteOptimizations optimizations)
void setSupportedSegmentDetails(QGeoRouteRequest::SegmentDetails segmentDetails)
void setSupportedTravelModes(QGeoRouteRequest::TravelModes travelModes)

Descripción detallada

Nota: Nohay garantías de compatibilidad ni en código fuente ni en binario para las clases de backend. Solo se garantiza que la API funcione con la versión de Qt con la que se desarrolló. No obstante, los cambios en la API solo se realizarán en versiones menores (6.6, 6.7, etc.).

Las subclases de `QGeoRoutingManagerEngine` deben proporcionar una implementación de ` calculateRoute()`.

En la implementación predeterminada, `supportsRouteUpdates()` devuelve `false` y ` updateRoute()` devuelve un objeto ` QGeoRouteReply ` que contiene un ` QGeoRouteReply::UnsupportedOptionError`.

Si el servicio de cálculo de rutas admite la actualización de las rutas mientras se recorren, la subclase debe proporcionar una implementación de ` updateRoute()` y llamar a `setSupportsRouteUpdates(true)` en algún momento antes de que se llame a ` updateRoute()`.

La función `setSupportsRouteUpdates()` es una de las varias funciones que configuran las capacidades declaradas del motor. Si las capacidades de un motor difieren de los valores predeterminados, deben utilizarse estas funciones para que las capacidades declaradas sean precisas.

Es importante que esto se haga antes de utilizar calculateRoute(), updateRoute() o cualquiera de las funciones de notificación de capacidades, para evitar un comportamiento incorrecto o incoherente.

Una subclase de `QGeoRouteManagerEngine` suele utilizar internamente una subclase de ` QGeoRouteReply `, con el fin de añadir cualquier dato específico del motor (como un objeto ` QNetworkReply ` para servicios basados en red) a las instancias de ` QGeoRouteReply ` utilizadas por el motor.

Véase también QGeoRoutingManager.

Documentación de las funciones miembro

[explicit] QGeoRoutingManagerEngine::QGeoRoutingManagerEngine(const QVariantMap &parameters, QObject *parent = nullptr)

Crea un nuevo motor con el ` parent` especificado, utilizando ` parameters ` para pasar al motor cualquier dato específico de la implementación.

[virtual noexcept] QGeoRoutingManagerEngine::~QGeoRoutingManagerEngine()

Destruye este motor.

[pure virtual] QGeoRouteReply *QGeoRoutingManagerEngine::calculateRoute(const QGeoRouteRequest &request)

Inicia el cálculo de la ruta especificada por ` request`.

Se devolverá un objeto ` QGeoRouteReply `, que se puede utilizar para gestionar la operación de cálculo de ruta y para obtener los resultados de la misma.

Este motor y el objeto ` QGeoRouteReply ` devuelto emitirán señales que indicarán si la operación se completa o si se producen errores.

Una vez finalizada la operación, se puede utilizar QGeoRouteReply::routes para recuperar la ruta o rutas calculadas.

Si request incluye características que no son compatibles con este motor, tal y como indican los métodos de este motor, se producirá un error de « QGeoRouteReply::UnsupportedOptionError ».

El usuario es responsable de eliminar el objeto de respuesta devuelto, aunque esto puede hacerse en la ranura conectada a ` QGeoRoutingManagerEngine::finished()`, ` QGeoRoutingManagerEngine::errorOccurred()`, ` QGeoRouteReply::finished()` o ` QGeoRouteReply::errorOccurred()` mediante ` deleteLater()`.

[signal] void QGeoRoutingManagerEngine::errorOccurred(QGeoRouteReply *reply, QGeoRouteReply::Error error, const QString &errorString = QString())

Esta señal se emite cuando se ha detectado un error en el procesamiento de reply. Probablemente le seguirá la señal QGeoRoutingManagerEngine::finished().

El error se describirá mediante el código de error error. Si errorString no está vacío, contendrá una descripción textual del error.

Esta señal y QGeoRouteReply::errorOccurred() se emitirán al mismo tiempo.

Nota: No elimines el objeto reply en la ranura conectada a esta señal. Utiliza deleteLater() en su lugar.

[signal] void QGeoRoutingManagerEngine::finished(QGeoRouteReply *reply)

Esta señal se emite cuando « reply » ha finalizado el procesamiento.

Si reply::error() es igual a QGeoRouteReply::NoError, el procesamiento ha finalizado correctamente.

Esta señal y QGeoRouteReply::finished() se emitirán al mismo tiempo.

Nota: No elimines el objeto ` reply ` en la ranura conectada a esta señal. Utiliza en su lugar ` deleteLater()`.

QLocale QGeoRoutingManagerEngine::locale() const

Devuelve la configuración regional utilizada para indicar a este gestor de enrutamiento qué idioma debe emplearse para las direcciones y las instrucciones.

Véase también setLocale().

QString QGeoRoutingManagerEngine::managerName() const

Devuelve el nombre que utiliza esta implementación del motor para distinguirse de las implementaciones proporcionadas por otros complementos.

La combinación de `managerName()` y ` managerVersion()` debe ser única entre las implementaciones de los complementos.

int QGeoRoutingManagerEngine::managerVersion() const

Devuelve la versión de esta implementación del motor.

La combinación de managerName() y managerVersion() debe ser única entre las implementaciones de los complementos.

QLocale::MeasurementSystem QGeoRoutingManagerEngine::measurementSystem() const

Devuelve el sistema de unidades utilizado por este gestor.

Si se ha llamado a setMeasurementSystem(), el valor devuelto por esta función puede ser diferente al devuelto por locale() omeasurementSystem(). En ese caso, el valor devuelto por esta función es el que utilizará el gestor.

Véanse también ` setMeasurementSystem()` y ` setLocale()`.

void QGeoRoutingManagerEngine::setLocale(const QLocale &locale)

Establece la configuración regional que utilizará este gestor en locale.

Si este gestor de enrutamiento admite la devolución de direcciones e instrucciones en diferentes idiomas, estas se mostrarán en el idioma de locale.

Si no se ha establecido, la configuración regional utilizada será, por defecto, la del sistema.

Véase también locale().

void QGeoRoutingManagerEngine::setMeasurementSystem(QLocale::MeasurementSystem system)

Establece el sistema de medidas utilizado por este gestor en « system ».

El sistema de medidas se puede configurar independientemente de la configuración regional. Tanto setLocale() como esta función establecen el sistema de medidas. Se utilizará el valor establecido por la última función llamada.

Véanse también measurementSystem(), locale() y setLocale().

[protected] void QGeoRoutingManagerEngine::setSupportedFeatureTypes(QGeoRouteRequest::FeatureTypes featureTypes)

Establece los tipos de características que este motor puede tener en cuenta durante la planificación de rutas en featureTypes.

Es importante que las subclases utilicen este método para garantizar que el motor informe correctamente de sus capacidades. Si no se utiliza esta función, el motor indicará que no admite ningún tipo de característica.

Véase también supportedFeatureTypes().

[protected] void QGeoRoutingManagerEngine::setSupportedFeatureWeights(QGeoRouteRequest::FeatureWeights featureWeights)

Establece las ponderaciones que este motor puede aplicar a diferentes características durante la planificación de rutas a featureWeights.

Es importante que las subclases utilicen este método para garantizar que el motor informe correctamente de sus capacidades. Si no se utiliza esta función, el motor indicará que no admite ninguna ponderación de características.

Véase también supportedFeatureWeights().

[protected] void QGeoRoutingManagerEngine::setSupportedManeuverDetails(QGeoRouteRequest::ManeuverDetails maneuverDetails)

Establece los niveles de detalle de las maniobras de navegación que este motor puede solicitar a maneuverDetails.

Es importante que las subclases utilicen este método para garantizar que el motor informe correctamente de sus capacidades. Si no se utiliza esta función, el motor informará de que no admite ningún detalle de maniobra.

Véase también supportedManeuverDetails().

[protected] void QGeoRoutingManagerEngine::setSupportedRouteOptimizations(QGeoRouteRequest::RouteOptimizations optimizations)

Establece las optimizaciones de ruta compatibles con este motor en « optimizations ».

Es importante que las subclases utilicen este método para garantizar que el motor informe correctamente de sus capacidades. Si no se utiliza esta función, el motor indicará que no admite ninguna optimización de rutas.

Véase también supportedRouteOptimizations().

[protected] void QGeoRoutingManagerEngine::setSupportedSegmentDetails(QGeoRouteRequest::SegmentDetails segmentDetails)

Establece los niveles de detalle de los segmentos de ruta que este motor puede solicitar a segmentDetails.

Es importante que las subclases utilicen este método para garantizar que el motor informe correctamente de sus capacidades. Si no se utiliza esta función, el motor indicará que no admite ningún tipo de detalle de segmento.

Véase también supportedSegmentDetails().

[protected] void QGeoRoutingManagerEngine::setSupportedTravelModes(QGeoRouteRequest::TravelModes travelModes)

Establece los modos de desplazamiento compatibles con este motor en travelModes.

Es importante que las subclases utilicen este método para garantizar que el motor informe correctamente de sus capacidades. Si no se utiliza esta función, el motor indicará que no admite ningún modo de desplazamiento.

Véase también supportedTravelModes().

QGeoRouteRequest::FeatureTypes QGeoRoutingManagerEngine::supportedFeatureTypes() const

Devuelve los tipos de elementos que este motor puede tener en cuenta durante la planificación de rutas.

Véase también setSupportedFeatureTypes().

QGeoRouteRequest::FeatureWeights QGeoRoutingManagerEngine::supportedFeatureWeights() const

Devuelve las ponderaciones que este motor puede aplicar a diferentes características durante la planificación de la ruta.

Véase también setSupportedFeatureWeights().

QGeoRouteRequest::ManeuverDetails QGeoRoutingManagerEngine::supportedManeuverDetails() const

Devuelve los niveles de detalle de las maniobras de navegación que puede solicitar este motor.

Véase también setSupportedManeuverDetails().

QGeoRouteRequest::RouteOptimizations QGeoRoutingManagerEngine::supportedRouteOptimizations() const

Devuelve las optimizaciones de rutas compatibles con este motor.

Véase también setSupportedRouteOptimizations().

QGeoRouteRequest::SegmentDetails QGeoRoutingManagerEngine::supportedSegmentDetails() const

Devuelve los niveles de detalle de los segmentos de ruta que puede solicitar este motor.

Véase también setSupportedSegmentDetails().

QGeoRouteRequest::TravelModes QGeoRoutingManagerEngine::supportedTravelModes() const

Devuelve los modos de desplazamiento compatibles con este motor.

Véase también setSupportedTravelModes().

[virtual] QGeoRouteReply *QGeoRoutingManagerEngine::updateRoute(const QGeoRoute &route, const QGeoCoordinate &position)

Inicia el proceso de actualización de ` route ` en función de la posición actual ` position`.

Se devolverá un objeto ` QGeoRouteReply `, que se puede utilizar para gestionar la operación de enrutamiento y para devolver los resultados de la misma.

Este motor y el objeto ` QGeoRouteReply ` devuelto emitirán señales que indicarán si la operación se completa o si se producen errores.

Si supportsRouteUpdates() devuelve «false», se producirá un QGeoRouteReply::UnsupportedOptionError.

Una vez completada la operación, se puede utilizar ` QGeoRouteReply::routes ` para recuperar la ruta actualizada.

La ruta devuelta podría ser totalmente diferente a la ruta original, especialmente si position se encuentra lo suficientemente lejos de la ruta inicial. En caso contrario, la ruta será similar, aunque se actualizarán el tiempo restante y la distancia, y se eliminarán los segmentos de la ruta original que ya se hayan recorrido.

El usuario es responsable de eliminar el objeto de respuesta devuelto, aunque esto puede hacerse en la ranura conectada a QGeoRoutingManagerEngine::finished(), QGeoRoutingManagerEngine::errorOccurred(), QGeoRouteReply::finished() o QGeoRouteReply::errorOccurred() mediante deleteLater().

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