En esta página

QGeoRouteReply Class

La clase `QGeoRouteReply` gestiona una operación iniciada por una instancia de ` QGeoRoutingManager`. Más...

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

Tipos públicos

enum Error { NoError, EngineNotSetError, CommunicationError, ParseError, UnsupportedOptionError, UnknownError }

Funciones públicas

QGeoRouteReply(QGeoRouteReply::Error error, const QString &errorString, QObject *parent = nullptr)
virtual ~QGeoRouteReply()
virtual void abort()
QGeoRouteReply::Error error() const
QString errorString() const
bool isFinished() const
QGeoRouteRequest request() const
QList<QGeoRoute> routes() const

Señales

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

Funciones protegidas

QGeoRouteReply(const QGeoRouteRequest &request, QObject *parent = nullptr)
void addRoutes(const QList<QGeoRoute> &routes)
void setError(QGeoRouteReply::Error error, const QString &errorString)
void setFinished(bool finished)
void setRoutes(const QList<QGeoRoute> &routes)

Descripción detallada

Las instancias de QGeoRouteReply gestionan el estado y los resultados de estas operaciones.

Los métodos isFinished(), error() y errorString() proporcionan información sobre si la operación se ha completado y si se ha completado con éxito.

Las señales finished() y errorOccurred(QGeoRouteReply::Error,QString) pueden utilizarse para supervisar el progreso de la operación.

Es posible que un objeto `QGeoRouteReply` recién creado se encuentre en estado «finished», lo que suele deberse a que se ha producido un error. Dado que dicha instancia nunca emitirá las señales ` finished()` ni ` errorOccurred` (QGeoRouteReply::Error,QString), es importante comprobar el resultado de ` isFinished()` antes de establecer las conexiones con las señales. La documentación de ` QGeoRoutingManager ` muestra cómo se puede llevar a cabo esto.

Si la operación se completa con éxito, se podrá acceder a los resultados mediante ` routes()`.

Documentación sobre los tipos de miembros

enum QGeoRouteReply::Error

Describe un error que ha impedido que se completara la operación.

ConstanteValorDescripción
QGeoRouteReply::NoError0No se ha producido ningún error.
QGeoRouteReply::EngineNotSetError1El gestor de enrutamiento utilizado no tenía asociada ninguna instancia de « QGeoRoutingManagerEngine ».
QGeoRouteReply::CommunicationError2Se ha producido un error al comunicarse con el proveedor de servicios.
QGeoRouteReply::ParseError3La respuesta del proveedor de servicios tenía un formato no reconocible.
QGeoRouteReply::UnsupportedOptionError4El proveedor de servicios no admite la operación solicitada ni ninguna de sus opciones.
QGeoRouteReply::UnknownError5Se ha producido un error que no encaja en ninguna de las demás categorías.

Documentación de las funciones miembro

[explicit protected] QGeoRouteReply::QGeoRouteReply(const QGeoRouteRequest &request, QObject *parent = nullptr)

Crea un objeto de respuesta de ruta basado en request, con el parent especificado.

[explicit] QGeoRouteReply::QGeoRouteReply(QGeoRouteReply::Error error, const QString &errorString, QObject *parent = nullptr)

Crea una respuesta de ruta con los valores dados de « error » y « errorString », así como con el valor especificado de « parent ».

[virtual noexcept] QGeoRouteReply::~QGeoRouteReply()

Elimina este objeto de respuesta de ruta.

[virtual] void QGeoRouteReply::abort()

Cancela la operación de inmediato.

Esto no tendrá ningún efecto si la respuesta ya se ha completado.

[signal] void QGeoRouteReply::aborted()

Esta señal se emite cuando se ha cancelado la operación.

Véase también abort().

[protected] void QGeoRouteReply::addRoutes(const QList<QGeoRoute> &routes)

Añade la lista de routes a la lista existente.

QGeoRouteReply::Error QGeoRouteReply::error() const

Devuelve el estado de error de esta respuesta.

Si el resultado es « QGeoRouteReply::NoError », significa que no se ha producido ningún error.

Véase también setError().

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

Esta señal se emite cuando se ha detectado un error en el procesamiento de esta respuesta. Probablemente le seguirá la señal 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 QGeoRoutingManager::errorOccurred() se emitirán al mismo tiempo.

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

QString QGeoRouteReply::errorString() const

Devuelve la representación textual del estado de error de esta respuesta.

Si no se ha producido ningún error, devolverá una cadena vacía. Es posible que se haya producido un error que no tenga una representación textual asociada, en cuyo caso también devolverá una cadena vacía.

Para determinar si se ha producido un error, comprueba si ` QGeoRouteReply::error()` es igual a ` QGeoRouteReply::NoError`.

[signal] void QGeoRouteReply::finished()

Esta señal se emite cuando ha finalizado el procesamiento de esta respuesta.

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

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

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

Véase también setFinished().

bool QGeoRouteReply::isFinished() const

Devuelve «true» si la operación se ha completado correctamente o si se ha producido un error que ha provocado que la operación se interrumpa.

QGeoRouteRequest QGeoRouteReply::request() const

Devuelve la solicitud de ruta que especificó la ruta.

QList<QGeoRoute> QGeoRouteReply::routes() const

Devuelve la lista de rutas que se han solicitado.

Véase también setRoutes().

[protected] void QGeoRouteReply::setError(QGeoRouteReply::Error error, const QString &errorString)

Establece el estado de error de esta respuesta en « error » y la representación textual del error en « errorString ».

Esto también provocará que se emitan las señales ` errorOccurred()` y ` finished()`, en ese orden.

Véase también error().

[protected] void QGeoRouteReply::setFinished(bool finished)

Establece si esta respuesta ha finalizado o no en finished.

Si finished es verdadero, esto provocará que se emita la señal finished().

Si la operación se ha completado correctamente, se debe llamar a ` QGeoRouteReply::setRoutes()` antes de esta función. Si se ha producido un error, se debe utilizar en su lugar ` QGeoRouteReply::setError()`.

Véase también finished().

[protected] void QGeoRouteReply::setRoutes(const QList<QGeoRoute> &routes)

Establece la lista de rutas en la respuesta a routes.

Véase también routes().

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