QGeoServiceProvider Class
La clase `QGeoServiceProvider` agrupa el acceso a los servicios que proporcionan información geográfica. Más información...
| Header: | #include <QGeoServiceProvider> |
| qmake: | QT += location |
| Inherits: | QObject |
Tipos públicos
| enum | Error { NoError, NotSupportedError, UnknownParameterError, MissingRequiredParameterError, ConnectionError, LoaderError } |
| enum | GeocodingFeature { NoGeocodingFeatures, OnlineGeocodingFeature, OfflineGeocodingFeature, ReverseGeocodingFeature, LocalizedGeocodingFeature, AnyGeocodingFeatures } |
| flags | GeocodingFeatures |
| enum | MappingFeature { NoMappingFeatures, OnlineMappingFeature, OfflineMappingFeature, LocalizedMappingFeature, AnyMappingFeatures } |
| flags | MappingFeatures |
| enum | NavigationFeature { NoNavigationFeatures, OnlineNavigationFeature, OfflineNavigationFeature, AnyNavigationFeatures } |
| flags | NavigationFeatures |
| enum | PlacesFeature { NoPlacesFeatures, OnlinePlacesFeature, OfflinePlacesFeature, SavePlaceFeature, RemovePlaceFeature, …, AnyPlacesFeatures } |
| flags | PlacesFeatures |
| enum | RoutingFeature { NoRoutingFeatures, OnlineRoutingFeature, OfflineRoutingFeature, LocalizedRoutingFeature, RouteUpdatesFeature, …, AnyRoutingFeatures } |
| flags | RoutingFeatures |
Funciones públicas
| QGeoServiceProvider(const QString &providerName, const QVariantMap ¶meters = QVariantMap(), bool allowExperimental = false) | |
| virtual | ~QGeoServiceProvider() |
| QGeoServiceProvider::Error | error() const |
| QString | errorString() const |
| QGeoServiceProvider::Error | geocodingError() const |
| QString | geocodingErrorString() const |
| QGeoServiceProvider::GeocodingFeatures | geocodingFeatures() const |
| QGeoCodingManager * | geocodingManager() const |
| QGeoServiceProvider::Error | mappingError() const |
| QString | mappingErrorString() const |
| QGeoServiceProvider::MappingFeatures | mappingFeatures() const |
| QGeoServiceProvider::Error | navigationError() const |
| QString | navigationErrorString() const |
(since QtLocation 5.11) QGeoServiceProvider::NavigationFeatures | navigationFeatures() const |
| QPlaceManager * | placeManager() const |
| QGeoServiceProvider::Error | placesError() const |
| QString | placesErrorString() const |
| QGeoServiceProvider::PlacesFeatures | placesFeatures() const |
| QGeoServiceProvider::Error | routingError() const |
| QString | routingErrorString() const |
| QGeoServiceProvider::RoutingFeatures | routingFeatures() const |
| QGeoRoutingManager * | routingManager() const |
| void | setAllowExperimental(bool allow) |
| void | setLocale(const QLocale &locale) |
| void | setParameters(const QVariantMap ¶meters) |
Miembros públicos estáticos
| QStringList | availableServiceProviders() |
Descripción detallada
La API de mapas y navegación permite a los usuarios acceder a diversos tipos de información geográfica, incluyendo funcionalidades para realizar geocodificación, cálculo de rutas y visualización de mapas. QGeoServiceProvider agrupa el acceso a un conjunto de estos servicios proporcionados por un único proveedor.
Es posible combinar proveedores de servicios para los distintos ámbitos, de modo que se pueda utilizar un gestor de geocodificación de un proveedor de servicios junto con un gestor de cálculo de rutas geográficas de otro proveedor.
Esto no se recomienda a menos que el cliente pueda verificar que los datos proporcionados por los distintos servicios sean compatibles, ya que las diferencias en los conjuntos de datos subyacentes podrían provocar graves incongruencias entre los servicios.
Las subclases de QGeoServiceProvider garantizan que los distintos servicios que proporcionan sean interoperables.
Cada proveedor de servicios debe seguir una convención de nomenclatura para los nombres o claves de los parámetros específicos de su servicio. Utilizan el nombre del proveedor como prefijo para todos los nombres de sus parámetros. Cuando se carga un proveedor, solo se pasan aquellos parámetros cuyos nombres comiencen por el nombre del proveedor. Esto evita compartir parámetros sensibles, como los confidenciales token o app_id, con otros complementos.
Consulte la documentación específica del complemento GeoServices para obtener una lista completa de los nombres o claves de los parámetros disponibles y sus valores.
Documentación sobre los tipos de miembros
enum QGeoServiceProvider::Error
Describe un error relacionado con la carga y la configuración de un complemento de proveedor de servicios.
| Constante | Valor | Descripción |
|---|---|---|
QGeoServiceProvider::NoError | 0 | No se ha producido ningún error. |
QGeoServiceProvider::NotSupportedError | 1 | El complemento no admite esta funcionalidad. |
QGeoServiceProvider::UnknownParameterError | 2 | El complemento no ha reconocido uno de los parámetros que se le han proporcionado. |
QGeoServiceProvider::MissingRequiredParameterError | 3 | El complemento no ha encontrado uno de los parámetros que esperaba. |
QGeoServiceProvider::ConnectionError | 4 | El complemento no ha podido conectarse a su servicio de fondo ni a su base de datos. |
QGeoServiceProvider::LoaderError | 5 | El complemento no se ha podido cargar. |
enum QGeoServiceProvider::GeocodingFeature
flags QGeoServiceProvider::GeocodingFeatures
Describe las funciones de geocodificación que admite el proveedor de servicios geográficos.
| Constante | Valor | Descripción |
|---|---|---|
QGeoServiceProvider::NoGeocodingFeatures | 0 | No se admite ninguna función de geocodificación. |
QGeoServiceProvider::OnlineGeocodingFeature | (1<<0) | Se admite la geocodificación en línea. |
QGeoServiceProvider::OfflineGeocodingFeature | (1<<1) | Se admite la geocodificación sin conexión. |
QGeoServiceProvider::ReverseGeocodingFeature | (1<<2) | Se admite la geocodificación inversa. |
QGeoServiceProvider::LocalizedGeocodingFeature | (1<<3) | Admite la devolución de resultados de geocodificación con direcciones localizadas. |
QGeoServiceProvider::AnyGeocodingFeatures | ~(0) | Se corresponde con un proveedor de servicios geográficos que ofrece cualquier función de geocodificación. |
El tipo `GeocodingFeatures` es una definición de tipo (typedef) para ` QFlags<GeocodingFeature>`. Almacena una combinación OR de valores de `GeocodingFeature`.
enum QGeoServiceProvider::MappingFeature
flags QGeoServiceProvider::MappingFeatures
Describe las funciones de cartografía que admite el proveedor de servicios geográficos.
| Constante | Valor | Descripción |
|---|---|---|
QGeoServiceProvider::NoMappingFeatures | 0 | No se admite ninguna función de cartografía. |
QGeoServiceProvider::OnlineMappingFeature | (1<<0) | Se admite la cartografía en línea. |
QGeoServiceProvider::OfflineMappingFeature | (1<<1) | Se admite la visualización de mapas sin conexión. |
QGeoServiceProvider::LocalizedMappingFeature | (1<<2) | Admite la devolución de datos cartográficos localizados. |
QGeoServiceProvider::AnyMappingFeatures | ~(0) | Se corresponde con un proveedor de servicios geográficos que ofrece cualquier función de mapas. |
El tipo `MappingFeatures` es una definición de tipo para `QFlags<MappingFeature>`. Almacena una combinación «o» de valores de `MappingFeature`.
enum QGeoServiceProvider::NavigationFeature
flags QGeoServiceProvider::NavigationFeatures
Describe las funciones de navegación compatibles con el proveedor de servicios geográficos.
| Constante | Valor | Descripción |
|---|---|---|
QGeoServiceProvider::NoNavigationFeatures | 0 | No se admite ninguna función de navegación. |
QGeoServiceProvider::OnlineNavigationFeature | (1<<0) | Se admite la navegación en línea. |
QGeoServiceProvider::OfflineNavigationFeature | (1<<1) | Se admite la navegación sin conexión. |
QGeoServiceProvider::AnyNavigationFeatures | ~(0) | Se corresponde con un proveedor de servicios geográficos que ofrece cualquier función de navegación. |
El tipo NavigationFeatures es una definición de tipo para QFlags<NavigationFeature>. Almacena una combinación «O» de valores de NavigationFeature.
enum QGeoServiceProvider::PlacesFeature
flags QGeoServiceProvider::PlacesFeatures
Describe las características de los lugares que admite el proveedor de servicios geográficos.
| Constante | Valor | Descripción |
|---|---|---|
QGeoServiceProvider::NoPlacesFeatures | 0 | No se admite ninguna característica de lugares. |
QGeoServiceProvider::OnlinePlacesFeature | (1<<0) | Se admiten lugares en línea. |
QGeoServiceProvider::OfflinePlacesFeature | (1<<1) | Se admiten lugares sin conexión. |
QGeoServiceProvider::SavePlaceFeature | (1<<2) | Se admite el guardado de lugares. |
QGeoServiceProvider::RemovePlaceFeature | (1<<3) | Se admite la eliminación de lugares. |
QGeoServiceProvider::SaveCategoryFeature | (1<<4) | Se admite el guardado de categorías. |
QGeoServiceProvider::RemoveCategoryFeature | (1<<5) | Se admite la eliminación o supresión de categorías. |
QGeoServiceProvider::PlaceRecommendationsFeature | (1<<6) | Se admite la búsqueda de lugares recomendados similares a otro lugar. |
QGeoServiceProvider::SearchSuggestionsFeature | (1<<7) | Se admiten las sugerencias de búsqueda. |
QGeoServiceProvider::LocalizedPlacesFeature | (1<<8) | Se admite la devolución de datos de lugares localizados. |
QGeoServiceProvider::NotificationsFeature | (1<<9) | Se admiten notificaciones de cambios en lugares y categorías. |
QGeoServiceProvider::PlaceMatchingFeature | (1<<10) | Se admite la coincidencia de lugares de dos proveedores de servicios geográficos diferentes. |
QGeoServiceProvider::AnyPlacesFeatures | ~(0) | Coincide con un proveedor de servicios geográficos que ofrezca cualquier característica de lugares. |
El tipo «PlacesFeatures» es una definición de tipo para «QFlags<PlacesFeature>». Almacena una combinación «OR» de valores de «PlacesFeature».
enum QGeoServiceProvider::RoutingFeature
flags QGeoServiceProvider::RoutingFeatures
Describe las funciones de enrutamiento que admite el proveedor de servicios geográficos.
| Constante | Valor | Descripción |
|---|---|---|
QGeoServiceProvider::NoRoutingFeatures | 0 | No se admite ninguna función de enrutamiento. |
QGeoServiceProvider::OnlineRoutingFeature | (1<<0) | Se admite el enrutamiento en línea. |
QGeoServiceProvider::OfflineRoutingFeature | (1<<1) | Se admite el cálculo de rutas sin conexión. |
QGeoServiceProvider::LocalizedRoutingFeature | (1<<2) | Admite la devolución de rutas con direcciones e instrucciones localizadas. |
QGeoServiceProvider::RouteUpdatesFeature | (1<<3) | Se admite la actualización de una ruta existente en función de la posición actual. |
QGeoServiceProvider::AlternativeRoutesFeature | (1<<4) | Admite la devolución de rutas alternativas. |
QGeoServiceProvider::ExcludeAreasRoutingFeature | (1<<5) | Admite la especificación de zonas que la ruta devuelta no debe atravesar. |
QGeoServiceProvider::AnyRoutingFeatures | ~(0) | Se ajusta a un proveedor de servicios geográficos que ofrezca cualquier función de cálculo de rutas. |
El tipo RoutingFeatures es una definición de tipo (typedef) para QFlags<RoutingFeature>. Almacena una combinación «O» de valores de RoutingFeature.
Documentación de las funciones de miembro
QGeoServiceProvider::QGeoServiceProvider(const QString &providerName, const QVariantMap ¶meters = QVariantMap(), bool allowExperimental = false)
Crea un QGeoServiceProvider cuyo backend se denomina « providerName », utilizando el « parameters » facilitado.
Si varios complementos tienen el mismo providerName, se utilizará el complemento con el valor más alto de providerVersion().
Si allowExperimental es true, se podrán utilizar los complementos marcados como experimentales. Por defecto, los complementos experimentales no se tienen en cuenta.
Si no se ha podido cargar ningún complemento que coincida con ` providerName `, entonces ` error()` y ` errorString()` proporcionarán detalles sobre el motivo de ello.
Nota: Antes de que la lista de parameters se pase al complemento de proveedor que se va a cargar, la lista se filtra para evitar que se compartan parámetros específicos del complemento con complementos de proveedores no relacionados. Las claves de los parámetros específicos del complemento deben ir precedidas del nombre del proveedor (p. ej., here.app_id).
[virtual noexcept] QGeoServiceProvider::~QGeoServiceProvider()
Elimina el objeto del proveedor de servicios.
[static] QStringList QGeoServiceProvider::availableServiceProviders()
Devuelve una lista con los nombres de los proveedores de servicios disponibles, para su uso con los constructores de ` QGeoServiceProvider `.
QGeoServiceProvider::Error QGeoServiceProvider::error() const
Devuelve un código de error que describe el error que se produjo durante la última operación realizada por esta clase.
QString QGeoServiceProvider::errorString() const
Devuelve una cadena que describe el error que se produjo durante la última operación realizada por esta clase.
QGeoServiceProvider::Error QGeoServiceProvider::geocodingError() const
Devuelve un código de error que describe el error que se produjo durante el último intento de crear un gestor de geocodificación.
QString QGeoServiceProvider::geocodingErrorString() const
Devuelve una cadena que describe el error que se produjo durante el último intento de crear un gestor de geocodificación.
QGeoServiceProvider::GeocodingFeatures QGeoServiceProvider::geocodingFeatures() const
Devuelve las funciones de geocodificación compatibles con el proveedor de servicios geográficos.
QGeoCodingManager *QGeoServiceProvider::geocodingManager() const
Devuelve el ` QGeoCodingManager ` facilitado por el proveedor de servicios.
Esta función devolverá « nullptr » si el proveedor de servicios no ofrece ningún servicio de geocodificación.
Esta función intentará crear una instancia de ` QGeoCodingManager ` cuando se llame a ella por primera vez. Si el intento tiene éxito, el ` QGeoCodingManager ` se almacenará en caché; de lo contrario, cada llamada a esta función intentará crear una instancia de ` QGeoCodingManager ` hasta que la creación se realice con éxito.
La instancia ` QGeoCodingManager ` pertenece a este ` QGeoServiceProvider ` y no debe eliminarse por separado. Los usuarios deben tener en cuenta que, al eliminar la instancia ` QGeoServiceProvider `, el puntero devuelto por este método deja de ser válido.
Una vez llamada esta función, error() y errorString() informarán de cualquier error que se haya producido durante la creación de QGeoCodingManager.
QGeoServiceProvider::Error QGeoServiceProvider::mappingError() const
Devuelve un código de error que describe el error que se produjo durante el último intento de crear un gestor de asignaciones.
QString QGeoServiceProvider::mappingErrorString() const
Devuelve una cadena que describe el error que se produjo durante el último intento de crear un gestor de asignaciones.
QGeoServiceProvider::MappingFeatures QGeoServiceProvider::mappingFeatures() const
Devuelve las características de cartografía compatibles con el proveedor de servicios geográficos.
QGeoServiceProvider::Error QGeoServiceProvider::navigationError() const
Devuelve un código de error que describe el error que se produjo durante el último intento de crear un gestor de navegación.
QString QGeoServiceProvider::navigationErrorString() const
Devuelve una cadena que describe el error que se produjo durante el último intento de crear un gestor de navegación.
[since QtLocation 5.11] QGeoServiceProvider::NavigationFeatures QGeoServiceProvider::navigationFeatures() const
Devuelve las funciones de navegación compatibles con el proveedor de servicios geográficos.
Esta función se introdujo en QtLocation 5.11.
QPlaceManager *QGeoServiceProvider::placeManager() const
Devuelve el objeto ` QPlaceManager ` facilitado por el proveedor de servicios.
Esta función intentará crear una instancia de ` QPlaceManager ` cuando se llame a ella por primera vez. Si el intento tiene éxito, el ` QPlaceManager ` se almacenará en caché; de lo contrario, cada llamada a esta función intentará crear una instancia de ` QPlace ` hasta que la creación se realice con éxito.
El `QGeoPlaceManager` es propiedad de este ` QGeoServiceProvider ` y no debe eliminarse por separado. Los usuarios deben tener en cuenta que la eliminación del ` QGeoServiceProvider ` invalida el puntero devuelto por este método.
Una vez llamada esta función, error() y errorString() informarán de cualquier error que se haya producido durante la construcción de QPlaceManager.
QGeoServiceProvider::Error QGeoServiceProvider::placesError() const
Devuelve un código de error que describe el error que se produjo durante el último intento de crear un gestor de lugares.
QString QGeoServiceProvider::placesErrorString() const
Devuelve una cadena que describe el error que se produjo durante el último intento de crear un gestor de lugares.
QGeoServiceProvider::PlacesFeatures QGeoServiceProvider::placesFeatures() const
Devuelve los elementos de «lugares» compatibles con el proveedor de servicios geográficos.
QGeoServiceProvider::Error QGeoServiceProvider::routingError() const
Devuelve un código de error que describe el error que se produjo durante el último intento de crear un gestor de enrutamiento.
QString QGeoServiceProvider::routingErrorString() const
Devuelve una cadena que describe el error que se produjo durante el último intento de crear un gestor de enrutamiento.
QGeoServiceProvider::RoutingFeatures QGeoServiceProvider::routingFeatures() const
Devuelve las funciones de cálculo de rutas que admite el proveedor de servicios geográficos.
QGeoRoutingManager *QGeoServiceProvider::routingManager() const
Devuelve el servicio de enrutamiento geográfico ( QGeoRoutingManager ) que ofrece el proveedor de servicios.
Esta función devolverá « nullptr » si el proveedor de servicios no ofrece ningún servicio de enrutamiento geográfico.
Esta función intentará crear una instancia de « QGeoRoutingManager » cuando se llame a ella por primera vez. Si el intento tiene éxito, el « QGeoRoutingManager » se almacenará en caché; de lo contrario, cada llamada a esta función intentará crear una instancia de « QGeoRoutingManager » hasta que la creación se realice con éxito.
La instancia ` QGeoRoutingManager ` es propiedad de este ` QGeoServiceProvider ` y no debe eliminarse por separado. Los usuarios deben tener en cuenta que, al eliminar la instancia ` QGeoServiceProvider `, el puntero devuelto por este método deja de ser válido.
Una vez llamada esta función, error() y errorString() informarán de cualquier error que se haya producido durante la creación de QGeoRoutingManager.
void QGeoServiceProvider::setAllowExperimental(bool allow)
Establece si se tienen en cuenta los complementos experimentales a la hora de localizar la biblioteca de complementos correcta para este proveedor de servicios en allow.
Importante: esto eliminará cualquier gestor existente que tenga esta instancia del proveedor de servicios. Debes asegurarte de no intentar utilizar ningún puntero que hayas obtenido previamente tras llamar a este método.
void QGeoServiceProvider::setLocale(const QLocale &locale)
Establece la configuración regional utilizada por este proveedor de servicios en locale. Si se activan las funciones correspondientes (véase LocalizedMappingFeature, etc.), esto modificará los idiomas, las unidades y otros atributos específicos de la configuración regional de los datos del proveedor.
void QGeoServiceProvider::setParameters(const QVariantMap ¶meters)
Establece los parámetros utilizados para crear clases de gestor individuales para este proveedor de servicios en parameters.
Antes de que la lista de parameters se transmita al proveedor de servicios que se va a cargar, la lista se filtra para evitar que se compartan parámetros específicos del proveedor con proveedores de servicios no relacionados. Las claves de los parámetros específicos del proveedor deben ir precedidas del nombre del proveedor (p. ej., here.app_id).
Importante: esto eliminará cualquier gestor existente que tenga esta instancia del proveedor de servicios. Debes asegurarte de no intentar utilizar ningún puntero que hayas recuperado previamente tras llamar a este método.
© 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.