En esta página

QGeoCodeReply Class

La clase `QGeoCodeReply` gestiona una operación iniciada por una instancia de ` QGeoCodingManager`. Más información...

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

Tipos públicos

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

Funciones públicas

QGeoCodeReply(QGeoCodeReply::Error error, const QString &errorString, QObject *parent = nullptr)
virtual ~QGeoCodeReply()
virtual void abort()
QGeoCodeReply::Error error() const
QString errorString() const
bool isFinished() const
qsizetype limit() const
QList<QGeoLocation> locations() const
qsizetype offset() const
QGeoShape viewport() const

Señales

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

Funciones protegidas

QGeoCodeReply(QObject *parent = nullptr)
void addLocation(const QGeoLocation &location)
void setError(QGeoCodeReply::Error error, const QString &errorString)
void setFinished(bool finished)
void setLimit(qsizetype limit)
void setLocations(const QList<QGeoLocation> &locations)
void setOffset(qsizetype offset)
void setViewport(const QGeoShape &viewport)

Descripción detallada

Las instancias de QGeoCodeReply 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(QGeoCodeReply::Error,QString) pueden utilizarse para supervisar el progreso de la operación.

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

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

Documentación sobre tipos de miembros

enum QGeoCodeReply::Error

Describe un error que ha impedido completar la operación.

ConstanteValorDescripción
QGeoCodeReply::NoError0No se ha producido ningún error.
QGeoCodeReply::EngineNotSetError1El gestor de geocodificación utilizado no tenía asociada ninguna instancia de « QGeoCodingManagerEngine ».
QGeoCodeReply::CommunicationError2Se ha producido un error al comunicarse con el proveedor de servicios.
QGeoCodeReply::ParseError3La respuesta del proveedor de servicios tenía un formato no reconocible.
QGeoCodeReply::UnsupportedOptionError4El proveedor de servicios no admite la operación solicitada ni una de las opciones de dicha operación.
QGeoCodeReply::CombinationError5Se ha producido un error al combinar resultados procedentes de varias fuentes.
QGeoCodeReply::UnknownError6Se ha producido un error que no encaja en ninguna de las demás categorías.

Documentación de funciones de miembro

[explicit protected] QGeoCodeReply::QGeoCodeReply(QObject *parent = nullptr)

Genera una respuesta de geocodificación con el « parent » especificado.

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

Genera una respuesta de geocodificación con los valores proporcionados en « error » y « errorString », así como con el valor especificado en « parent ».

[virtual noexcept] QGeoCodeReply::~QGeoCodeReply()

Elimina este objeto de respuesta.

[virtual] void QGeoCodeReply::abort()

Cancela la operación de inmediato.

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

Véase también aborted().

[signal] void QGeoCodeReply::aborted()

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

Véase también abort().

[protected] void QGeoCodeReply::addLocation(const QGeoLocation &location)

Añade location a la lista de ubicaciones de esta respuesta.

QGeoCodeReply::Error QGeoCodeReply::error() const

Devuelve el estado de error de esta respuesta.

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

Véase también setError().

[signal] void QGeoCodeReply::errorOccurred(QGeoCodeReply::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 QGeoCodingManager::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 QGeoCodeReply::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 ` QGeoCodeReply::error()` es igual a ` QGeoCodeReply::NoError`.

[signal] void QGeoCodeReply::finished()

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

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

Esta señal y QGeoCodingManager::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 QGeoCodeReply::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.

qsizetype QGeoCodeReply::limit() const

Devuelve el límite del número de respuestas de cada fuente de datos.

Si no se ha establecido ningún límite, esta función devolverá -1.

Este valor puede ser superior a ` locations().length()` si el número de respuestas fue inferior al número solicitado.

Véase también setLimit().

QList<QGeoLocation> QGeoCodeReply::locations() const

Devuelve una lista de ubicaciones.

Las ubicaciones son el resultado de la operación correspondiente a la función QGeoCodingManager que ha generado esta respuesta.

Véase también setLocations().

qsizetype QGeoCodeReply::offset() const

Devuelve el desplazamiento dentro del conjunto de resultados completo a partir del cual comenzar a recuperar resultados.

Véase también setOffset().

[protected] void QGeoCodeReply::setError(QGeoCodeReply::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 QGeoCodeReply::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 con éxito, se debe llamar a QGeoCodeReply::setLocations() antes de esta función. Si se ha producido un error, se debe utilizar en su lugar QGeoCodeReply::setError().

Véase también finished().

[protected] void QGeoCodeReply::setLimit(qsizetype limit)

Establece el límite del número de respuestas de cada fuente de datos a limit.

Si limit es -1, se devolverán todas las respuestas disponibles.

Véase también limit().

[protected] void QGeoCodeReply::setLocations(const QList<QGeoLocation> &locations)

Establece la lista de « locations » en la respuesta.

Véase también locations().

[protected] void QGeoCodeReply::setOffset(qsizetype offset)

Establece el desplazamiento en todo el conjunto de resultados a partir del cual comenzar a recuperar resultados en offset.

Véase también offset().

[protected] void QGeoCodeReply::setViewport(const QGeoShape &viewport)

Establece la ventana gráfica que contiene los resultados en viewport.

Véase también viewport().

QGeoShape QGeoCodeReply::viewport() const

Devuelve la ventana de visualización que contiene los resultados.

Esta función devolverá ` nullptr ` si no se especificó ningún sesgo de ventana gráfica en la función ` QGeoCodingManager ` que creó esta respuesta.

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

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