QGeoCodeReply Class
La clase QGeoCodeReply gestiona una operación iniciada por una instancia de QGeoCodingManager. Más...
| 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 ha finalizado y si lo ha hecho con éxito.
Las señales finished() y errorOccurred(QGeoCodeReply::Error,QString) pueden utilizarse para controlar el progreso de la operación.
Es posible que un QGeoCodeReply recién creado se encuentre en un estado finalizado, más comúnmente porque se ha producido un error. Dado que una instancia de este tipo nunca emitirá las señales finished() o errorOccurred(QGeoCodeReply::Error,QString), es importante comprobar el resultado de isFinished() antes de realizar las conexiones con las señales. La documentación de QGeoCodingManager muestra cómo hacerlo.
Si la operación se completa con éxito, se podrá acceder a los resultados con locations().
Documentación de los tipos de miembros
enum QGeoCodeReply::Error
Describe un error que ha impedido completar la operación.
| Constante | Valor | Descripción |
|---|---|---|
QGeoCodeReply::NoError | 0 | No se ha producido ningún error. |
QGeoCodeReply::EngineNotSetError | 1 | El gestor de geocodificación utilizado no tenía asociada una instancia de QGeoCodingManagerEngine. |
QGeoCodeReply::CommunicationError | 2 | Se ha producido un error durante la comunicación con el proveedor de servicios. |
QGeoCodeReply::ParseError | 3 | La respuesta del proveedor de servicios estaba en un formato irreconocible. |
QGeoCodeReply::UnsupportedOptionError | 4 | La operación solicitada o una de las opciones de la operación no son compatibles con el proveedor de servicios. |
QGeoCodeReply::CombinationError | 5 | Se ha producido un error al combinar resultados de varias fuentes. |
QGeoCodeReply::UnknownError | 6 | Se ha producido un error que no encaja en ninguna de las otras categorías. |
Documentación de las funciones miembro
[explicit protected] QGeoCodeReply::QGeoCodeReply(QObject *parent = nullptr)
Construye una respuesta de geocodificación con la dirección parent especificada.
[explicit] QGeoCodeReply::QGeoCodeReply(QGeoCodeReply::Error error, const QString &errorString, QObject *parent = nullptr)
Construye una respuesta de geocodificación con un error y errorString dados y el parent especificado.
[virtual noexcept] QGeoCodeReply::~QGeoCodeReply()
Destruye este objeto de respuesta.
[virtual] void QGeoCodeReply::abort()
Cancela la operación inmediatamente.
Esto no hará nada si la respuesta ha finalizado.
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 entonces 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 elimine este objeto de respuesta en la ranura conectada a esta señal. Utilice deleteLater() en su lugar.
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 representación textual asociada, en cuyo caso también devolverá una cadena vacía.
Para determinar si se ha producido un error, compruebe si QGeoCodeReply::error() es igual a QGeoCodeReply::NoError.
[signal] void QGeoCodeReply::finished()
Esta señal se emite cuando la respuesta ha terminado de procesarse.
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 elimine este objeto de respuesta en la ranura conectada a esta señal. Utilice deleteLater() en su lugar.
Véase también setFinished().
bool QGeoCodeReply::isFinished() const
Devuelve true si la operación se ha completado con éxito o ha encontrado un error que ha provocado la detención de la operación.
qsizetype QGeoCodeReply::limit() const
Devuelve el límite en el número de respuestas de cada fuente de datos.
Si no se estableció ningún límite, esta función devolverá -1.
Puede ser superior a locations().length() si el número de respuestas es inferior al solicitado.
Véase también setLimit().
QList<QGeoLocation> QGeoCodeReply::locations() const
Devuelve una lista de localizaciones.
Las ubicaciones son los resultados de la operación correspondiente a la función QGeoCodingManager que creó esta respuesta.
Véase también setLocations().
qsizetype QGeoCodeReply::offset() const
Devuelve el desplazamiento en todo el conjunto de resultados en el que comenzar a obtener 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 hará 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 terminado o no en finished.
Si finished es verdadero, se emitirá la señal finished().
Si la operación se completó con éxito, QGeoCodeReply::setLocations() debe ser llamado antes de esta función. Si se ha producido un error, debe utilizarse QGeoCodeReply::setError() en su lugar.
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 en 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 en el que se empezará a obtener el resultado en offset.
Véase también offset().
[protected] void QGeoCodeReply::setViewport(const QGeoShape &viewport)
Establece la ventana que contiene los resultados en viewport.
Véase también viewport().
QGeoShape QGeoCodeReply::viewport() const
Devuelve la ventana que contiene los resultados.
Esta función devolverá nullptr si no se especificó ningún sesgo de vista 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.
