QGeoCodingManagerEngine Class
La clase `QGeoCodingManagerEngine` proporciona una interfaz y métodos de conveniencia a los desarrolladores de complementos de ` QGeoServiceProvider ` que deseen ofrecer compatibilidad con operaciones de geocodificación. Más...
| Header: | #include <QGeoCodingManagerEngine> |
| qmake: | QT += location |
| Inherits: | QObject |
Funciones públicas
| QGeoCodingManagerEngine(const QVariantMap ¶meters, QObject *parent = nullptr) | |
| virtual | ~QGeoCodingManagerEngine() |
| virtual QGeoCodeReply * | geocode(const QGeoAddress &address, const QGeoShape &bounds) |
| virtual QGeoCodeReply * | geocode(const QString &address, int limit, int offset, const QGeoShape &bounds) |
| QLocale | locale() const |
| QString | managerName() const |
| int | managerVersion() const |
| virtual QGeoCodeReply * | reverseGeocode(const QGeoCoordinate &coordinate, const QGeoShape &bounds) |
| 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
Nota: Nohay garantías de compatibilidad ni a nivel de código fuente ni de binarios 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.).
En la implementación predeterminada, las funciones `supportsGeocoding()` y `supportsReverseGeocoding()` devuelven `false`, mientras que ` geocode()` y ` reverseGeocode()` provocan un error de tipo ` QGeoCodeReply::UnsupportedOptionError `.
Si el proveedor de servicios admite la geocodificación, la subclase debe proporcionar una implementación de geocode() y llamar a setSupportsGeocoding(true) en algún momento antes de que se llame a geocode().
Del mismo modo, si el proveedor de servicios admite la geocodificación inversa, la subclase debe proporcionar una implementación de reverseGeocode() y llamar a setSupportsReverseGeocoding(true) en algún momento antes de que se llame a reverseGeocode().
Una subclase de `QGeoCodingManagerEngine` suele utilizar internamente una subclase de ` QGeoCodeReply `, 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 ` QGeoCodeReply ` utilizadas por el motor.
Véase también QGeoCodingManager.
Documentación de las funciones miembro
[explicit] QGeoCodingManagerEngine::QGeoCodingManagerEngine(const QVariantMap ¶meters, 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] QGeoCodingManagerEngine::~QGeoCodingManagerEngine()
Destruye este motor.
[signal] void QGeoCodingManagerEngine::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 QGeoCodingManagerEngine::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 QGeoCodingManagerEngine::finished(QGeoCodeReply *reply)
Esta señal se emite cuando « reply » ha finalizado el procesamiento.
Si reply::error() es igual a QGeoCodeReply::NoError, 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()`.
[virtual] QGeoCodeReply *QGeoCodingManagerEngine::geocode(const QGeoAddress &address, const QGeoShape &bounds)
Inicia la geocodificación de address. La geocodificación es el proceso de hallar unas coordenadas que se correspondan con una dirección determinada.
Se devolverá un objeto QGeoCodeReply, que se puede utilizar para gestionar la operación de geocodificación y para obtener los resultados de la misma.
Este motor 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 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.
Los datos de dirección devueltos en los resultados pueden diferir 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 se puede hacer en la ranura conectada a QGeoCodingManagerEngine::finished(), QGeoCodingManagerEngine::errorOccurred(), QGeoCodeReply::finished() o QGeoCodeReply::errorOccurred() mediante deleteLater().
[virtual] QGeoCodeReply *QGeoCodingManagerEngine::geocode(const QString &address, int limit, int offset, const QGeoShape &bounds)
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 motor 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 QGeoCodingManagerEngine::finished(), QGeoCodingManagerEngine::errorOccurred(), QGeoCodeReply::finished() o QGeoCodeReply::errorOccurred() mediante deleteLater().
QLocale QGeoCodingManagerEngine::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 QGeoCodingManagerEngine::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 QGeoCodingManagerEngine::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.
[virtual] QGeoCodeReply *QGeoCodingManagerEngine::reverseGeocode(const QGeoCoordinate &coordinate, const QGeoShape &bounds)
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 motor 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 devolverán pares de direcciones y coordenadas para la dirección postal, la ciudad, la región y el país.
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 QGeoCodingManagerEngine::finished(), QGeoCodingManagerEngine::errorOccurred(), QGeoCodeReply::finished() o QGeoCodeReply::errorOccurred() mediante deleteLater().
void QGeoCodingManagerEngine::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 ninguna configuración, 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.