QGeoCodingManager Class
La clase QGeoCodingManager ofrece soporte para operaciones de geocodificación. Más información...
| Header: | #include <QGeoCodingManager> |
| qmake: | QT += location |
| Inherits: | QObject |
Funciones públicas
| virtual | ~QGeoCodingManager() |
| QGeoCodeReply * | geocode(const QGeoAddress &address, const QGeoShape &bounds = QGeoShape()) |
| QGeoCodeReply * | geocode(const QString &address, int limit = -1, int offset = 0, const QGeoShape &bounds = QGeoShape()) |
| QLocale | locale() const |
| QString | managerName() const |
| int | managerVersion() const |
| QGeoCodeReply * | reverseGeocode(const QGeoCoordinate &coordinate, const QGeoShape &bounds = QGeoShape()) |
| void | setLocale(const QLocale &locale) |
Señales
| void | errorOccurred(QGeoCodeReply *reply, QGeoCodeReply::Error error, const QString &errorString = QString()) |
| void | finished(QGeoCodeReply *reply) |
Descripción detallada
Las funciones ` geocode()` y ` reverseGeocode()` devuelven objetos ` QGeoCodeReply `, que gestionan estas operaciones e informan sobre el resultado de las mismas y sobre cualquier error que pueda haberse producido.
Las funciones geocode() y reverseGeocode() pueden utilizarse para convertir instancias de QGeoAddress en instancias de QGeoCoordinate y viceversa.
La función geocode() también está sobrecargada para permitir al usuario realizar una operación de geocodificación de texto libre; si la cadena proporcionada puede interpretarse como una dirección, se puede geocodificar para obtener información de coordenadas.
Se puede acceder a las instancias de QGeoCodingManager mediante QGeoServiceProvider::geocodingManager().
Documentación de las funciones de miembro
[virtual noexcept] QGeoCodingManager::~QGeoCodingManager()
Elimina este gestor.
[signal] void QGeoCodingManager::errorOccurred(QGeoCodeReply *reply, QGeoCodeReply::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 QGeoCodingManager::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 QGeoCodeReply::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 QGeoCodingManager::finished(QGeoCodeReply *reply)
Esta señal se emite cuando reply ha finalizado el procesamiento.
Si reply::error() es igual a QGeoCodeReply::NoError, significa que el procesamiento ha finalizado correctamente.
Esta señal y QGeoCodeReply::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()`.
QGeoCodeReply *QGeoCodingManager::geocode(const QGeoAddress &address, const QGeoShape &bounds = QGeoShape())
Inicia la geocodificación de address. La geocodificación es el proceso de determinar las coordenadas que corresponden a una dirección determinada.
Se devolverá un objeto ` QGeoCodeReply `, que puede utilizarse para gestionar la operación de geocodificación y para devolver los resultados de la misma.
Este gestor y el objeto QGeoCodeReply devuelto emitirán señales que indicarán si la operación se completa o si se producen errores.
Si supportsGeocoding() devuelve «false», se producirá un QGeoCodeReply::UnsupportedOptionError.
Una vez completada la operación, se puede utilizar ` QGeoCodeReply::locations()` para recuperar los resultados, que consistirán en una lista de objetos ` QGeoLocation `. Estos objetos representan una combinación de datos de coordenadas y direcciones.
Los datos de dirección devueltos en los resultados pueden diferir de los de ` address`. Esto suele ocurrir si el servicio de geocodificación utiliza una forma canónica diferente de las direcciones o si ` address ` solo se ha rellenado parcialmente.
Si bounds no es nulo y es un QGeoShape válido, se utilizará para limitar los resultados a aquellos que estén contenidos en bounds. Esto resulta especialmente útil si address solo se ha rellenado parcialmente, ya que el servicio intentará geocodificar todas las coincidencias con los datos especificados.
El usuario es responsable de eliminar el objeto de respuesta devuelto, aunque esto puede hacerse en el slot vinculado a QGeoCodingManager::finished(), QGeoCodingManager::errorOccurred(), QGeoCodeReply::finished() o QGeoCodeReply::errorOccurred() mediante deleteLater().
QGeoCodeReply *QGeoCodingManager::geocode(const QString &address, int limit = -1, int offset = 0, const QGeoShape &bounds = QGeoShape())
Inicia la geocodificación de una ubicación que coincida con address.
Se devolverá un objeto ` QGeoCodeReply `, que se puede utilizar para gestionar la operación de geocodificación y para devolver los resultados de la misma.
Este gestor y el objeto ` QGeoCodeReply ` 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 QGeoCodeReply::locations() para recuperar los resultados, que consistirán en una lista de objetos QGeoLocation. Estos objetos representan una combinación de datos de coordenadas y direcciones.
Si limit es -1, se devolverá el conjunto completo de resultados; de lo contrario, se devolverán como máximo limit resultados.
El parámetro ` offset ` se utiliza para indicar al servicio de geocodificación que no devuelva los primeros ` offset ` resultados.
Los resultados de « limit » y « offset » se utilizan conjuntamente para implementar la paginación.
Si bounds no es nulo y es un QGeoShape válido, se utilizará para limitar los resultados a aquellos que estén contenidos en bounds.
El usuario es responsable de eliminar el objeto de respuesta devuelto, aunque esto puede hacerse en la ranura conectada a QGeoCodingManager::finished(), QGeoCodingManager::errorOccurred(), QGeoCodeReply::finished() o QGeoCodeReply::errorOccurred() mediante deleteLater().
QLocale QGeoCodingManager::locale() const
Devuelve la configuración regional utilizada para indicar a este gestor de geocodificación qué idioma debe emplearse en los resultados.
Véase también setLocale().
QString QGeoCodingManager::managerName() const
Devuelve el nombre del motor que implementa el comportamiento de este gestor de geocodificación.
La combinación de `managerName()` y ` managerVersion()` debe ser única entre las implementaciones del complemento.
int QGeoCodingManager::managerVersion() const
Devuelve la versión del motor que implementa el comportamiento de este gestor de geocodificación.
La combinación de ` managerName()` y `managerVersion()` debe ser única entre las implementaciones del complemento.
QGeoCodeReply *QGeoCodingManager::reverseGeocode(const QGeoCoordinate &coordinate, const QGeoShape &bounds = QGeoShape())
Inicia la geocodificación inversa de coordinate. La geocodificación inversa es el proceso de encontrar una dirección que se corresponda con unas coordenadas determinadas.
Se devolverá un objeto ` QGeoCodeReply `, que se puede utilizar para gestionar la operación de geocodificación inversa y para devolver los resultados de la misma.
Este gestor y el objeto ` QGeoCodeReply ` devuelto emitirán señales que indicarán si la operación se completa o si se producen errores.
Si supportsReverseGeocoding() devuelve «false», se producirá un QGeoCodeReply::UnsupportedOptionError.
En ese momento, se puede utilizar ` QGeoCodeReply::locations()` para recuperar los resultados, que consistirán en una lista de objetos ` QGeoLocation `. Estos objetos representan una combinación de datos de coordenadas y direcciones.
Los datos de coordenadas devueltos en los resultados pueden diferir de los de ` coordinate`. Esto suele ocurrir si el backend del servicio de geocodificación inversa desplaza las coordenadas para acercarlas a las direcciones coincidentes, o si el backend devuelve resultados con varios niveles de detalle.
Si el backend del servicio de geocodificación inversa devuelve varios resultados, estos se proporcionarán por orden de especificidad. Esto suele ocurrir si el backend está configurado para realizar la geocodificación inversa en varios niveles de detalle. Por ejemplo, algunos servicios devuelven pares de direcciones y coordenadas correspondientes a la calle, la ciudad, la región y el país.
Si ` bounds ` no es nulo y es un ` QGeoRectangle ` válido, se utilizará para limitar los resultados a aquellos que estén contenidos en ` bounds`.
El usuario es responsable de eliminar el objeto de respuesta devuelto, aunque esto puede hacerse en la ranura conectada a QGeoCodingManager::finished(), QGeoCodingManager::errorOccurred(), QGeoCodeReply::finished() o QGeoCodeReply::errorOccurred() mediante deleteLater().
void QGeoCodingManager::setLocale(const QLocale &locale)
Establece la configuración regional que utilizará este gestor en locale.
Si este gestor de geocodificación admite la devolución de resultados en diferentes idiomas, estos 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().
© 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.