En esta página

Qt Location GeoServices

El « Qt Location » ofrece la mayor parte de su funcionalidad a través de complementos de GeoService. Este documento describe cómo desarrollar un nuevo complemento de GeoService.

Descripción del complemento

Cada complemento se describe mediante un archivo JSON. El JSON describe las capacidades y la versión del complemento. A continuación se muestra un ejemplo de un archivo JSON utilizado por el complemento OpenStreetMap:

{
    "Keys": ["osm"],
    "Provider": "osm",
    "Version": 100,
    "Experimental": false,
    "Features": [
        "OnlineMappingFeature",
        "OnlineGeocodingFeature",
        "ReverseGeocodingFeature",
        "OnlineRoutingFeature",
        "OnlinePlacesFeature"
    ]
}

Las entradas tienen el siguiente significado:

ClaveDescripción
ClavesEl nombre o clave único del complemento. Cada complemento GeoService debe tener un nombre único.
ProveedorEl nombre del proveedor de los servicios. Varios complementos pueden tener el mismo nombre. En tales casos, se utilizará la cadena «Versión» para distinguir mejor los complementos.
ExperimentalMarca el complemento de servicio como experimental. Los desarrolladores de la API pueden optar por ignorar dichos complementos al instanciar ` QGeoServiceProvider::QGeoServiceProvider()`.
VersiónLa versión del complemento. Si varios complementos tienen el mismo nombre de proveedor, se utilizará el complemento con la versión más alta.
CaracterísticasLista de características que ofrece el complemento o servicio. Cada característica es una representación en forma de cadena de las características correspondientes en QGeoServiceProvider. Para obtener más detalles, consulta QGeoServiceProvider::routingFeatures(), QGeoServiceProvider::geocodingFeatures() y QGeoServiceProvider::placesFeatures().

Implementación de complementos

Quien desee implementar un complemento debe crear una subclase de `QGeoServiceProviderFactory` y de tantas clases de `ManagerEngine` como desee para las que quiera proporcionar implementaciones.

La subclasificación de `QGeoServiceProviderFactory` solo implica sobrescribir uno de los siguientes métodos:

Si un complemento no proporciona un motor, la función correspondiente debe devolver ` nullptr`.

QGeoCodingManagerEngine

Métodos de interfaz y de conveniencia para los implementadores de complementos de QGeoServiceProvider que deseen proporcionar soporte para operaciones de geocodificación

QGeoRoutingManagerEngine

Interfaz y métodos de conveniencia para los desarrolladores de complementos de QGeoServiceProvider que deseen proporcionar acceso a información de rutas geográficas

QPlaceManagerEngine

Interfaz para los desarrolladores de complementos de QGeoServiceProvider que deseen proporcionar acceso a la funcionalidad de lugares

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