En esta página

Plugin QML Type

El tipo de complemento describe un complemento de servicios basados en la ubicación. Más información...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.5

Propiedades

Métodos

Descripción detallada

El tipo «Plugin» se utiliza para especificar de forma declarativa qué complemento de GeoServices disponible debe utilizarse para diversas tareas en la API de ubicación. Los complementos son utilizados por los tipos « Map », « RouteModel » y « GeocodeModel », así como por muchos otros.

Los complementos reconocidos por el sistema tienen una propiedad ` name `, una cadena simple que normalmente indica el nombre del servicio del que el complemento recupera datos. También cuentan con diversas características, que pueden comprobarse mediante los métodos ` supportsRouting()`, ` supportsGeocoding()`, ` supportsMapping()`, ` supportsPlaces()` y ` supportsNavigation()`.

Cuando se crea un objeto «Plugin», este está «desvinculado» y no está asociado a ningún complemento de servicio real. Una vez que haya recibido información mediante la configuración de sus propiedades « name », « preferred » o « required », elegirá un complemento de servicio adecuado al que vincularse. Los objetos «Plugin» solo pueden vincularse una vez; para utilizar varios complementos, crea varios objetos «Plugin».

Ejemplo de uso

El siguiente fragmento de código muestra la creación de un objeto Plugin con las propiedades required y preferred configuradas. Este Plugin se asociará al primer complemento que encuentre que admita tanto el mapeo como la geocodificación, y dará preferencia a los complementos denominados «here» u «osm» frente a cualquier otro.

Plugin {
    id: plugin
    preferred: ["here", "osm"]
    required: Plugin.AnyMappingFeatures | Plugin.AnyGeocodingFeatures
}

Documentación de las propiedades

allowExperimental : bool

Esta propiedad indica si se pueden utilizar complementos experimentales.

availableServiceProviders : stringlist

Esta propiedad contiene una lista con los nombres de todos los complementos de servicio disponibles. Se puede utilizar para enumerar manualmente los complementos disponibles si el control que ofrecen name y required no es suficiente para tus necesidades.

isAttached : bool

Esta propiedad indica si el elemento «Plugin» está asociado a un complemento de proveedor de geoservicios.

locales : stringlist

Esta propiedad contiene una lista ordenada de configuraciones regionales preferidas para los complementos. Si no es posible utilizar la primera configuración regional, el backend recurre a la segunda, y así sucesivamente. Por defecto, la propiedad «locales» contiene la configuración regional del sistema.

Las configuraciones regionales se especifican como cadenas con el formato «idioma[_alfabeto][_país]» o «C», donde:

  • «language» es un código de idioma ISO 639 de dos letras en minúsculas,
  • script es un código de escritura ISO 15924 de cuatro letras, con la primera letra mayúscula,
  • país es un código de país ISO 3166 de dos o tres letras en mayúsculas (también «419», tal y como lo definen las Naciones Unidas),
  • la configuración regional «C» tiene un comportamiento idéntico al de English/UnitedStates, según QLocale

Si no se puede atender la primera configuración regional especificada, el servidor de localizaciones ( Plugin ) recurre a la siguiente y así sucesivamente. Es posible que algunos servidores de localizaciones ( Plugin ) no admitan un conjunto de configuraciones regionales definidas de forma rígida. Un ejemplo arbitrario es que algunos Place en Francia podrían tener localizaciones en francés e inglés, mientras que en determinadas zonas de América quizá solo esté disponible la localización en inglés. En el escenario anterior, el conjunto de configuraciones regionales admitidas depende del contexto de la ubicación de la búsqueda.

Si el Plugin no puede adaptarse a ninguna de las configuraciones regionales preferidas, el gestor recurre a utilizar un idioma compatible específico del backend.

En el caso de los « Plugin » que no admiten configuraciones regionales, la lista de configuraciones regionales siempre estará vacía.

El siguiente código muestra cómo configurar una o varias configuraciones regionales:

//single locale
Plugin {
    locales: "en_US"
}

//multiple locales
Plugin {
    locales: ["fr_FR","en_US"]
}

name : string

Esta propiedad contiene el nombre del complemento. Al configurar esta propiedad, el complemento solo se asociará a un complemento que tenga exactamente este nombre. Se ignorará el valor de « required ».

parameters : list<PluginParameter> [default]

Esta propiedad contiene la lista de parámetros del complemento.

preferred : stringlist

Esta propiedad contiene una lista ordenada de nombres de complementos preferidos, que se comprobarán para ver si cumplen con el conjunto de características requeridas establecido en required antes de comprobar cualquier otro complemento disponible.

required : enumeration

Esta propiedad contiene el conjunto de características que el objeto Plugin requerirá a la hora de elegir a qué complemento de servicio se va a asociar. Si se establece la propiedad « name », esto no tiene ningún efecto.

Se puede establecer cualquiera de los siguientes valores o una combinación bit a bit de varios de ellos:

  • Plugin.NoFeatures
  • Plugin.GeocodingFeature
  • Plugin.ReverseGeocodingFeature
  • Plugin.RoutingFeature
  • Plugin.MappingFeature
  • Plugin.CualquierLugar

Documentación de métodos

bool supportsGeocoding(GeocodingFeatures features)

Este método devuelve un valor booleano que indica si el complemento del proveedor de servicios geográficos admite el conjunto especificado de « features ». Se devuelve « True » si se admiten todos los « features » especificados; en caso contrario, se devuelve « false ».

El parámetro features puede ser cualquier combinación de los siguientes indicadores:

CaracterísticaDescripción
Plugin.NoGeocodingFeaturesNo se admite ninguna función de geocodificación.
Plugin.OnlineGeocodingFeatureSe admite la geocodificación en línea.
Plugin.OfflineGeocodingFeatureSe admite la geocodificación sin conexión.
Plugin.ReverseGeocodingFeatureSe admite la geocodificación inversa.
Plugin.LocalizedGeocodingFeatureAdmite la devolución de resultados de geocodificación con direcciones localizadas.
Plugin.AnyGeocodingFeaturesCoincide con un proveedor de servicios geográficos que ofrezca cualquier función de geocodificación.

bool supportsMapping(MappingFeatures features)

Este método devuelve un valor booleano que indica si el complemento del proveedor de servicios geográficos admite el conjunto especificado de « features ». Se devuelve «true» si se admiten todos los « features » especificados; en caso contrario, se devuelve «false».

El parámetro « features » puede ser cualquier combinación de los siguientes indicadores:

FeatureDescripción
Plugin.NoMappingFeaturesNo se admiten elementos de mapeo.
Plugin.OnlineMappingFeatureSe admite la cartografía en línea.
Plugin.OfflineMappingFeatureSe admite el mapeo sin conexión.
Plugin.LocalizedMappingFeatureAdmite la devolución de datos de mapas localizados.
Plugin.AnyMappingFeaturesCoincide con un proveedor de servicios geográficos que ofrece cualquier función de mapas.

bool supportsNavigation(NavigationFeatures features)

Este método devuelve un valor booleano que indica si el complemento del proveedor de servicios geográficos admite el conjunto especificado de « features ». Se devuelve «true» si se admiten todos los « features » especificados; en caso contrario, se devuelve «false».

El parámetro features puede ser cualquier combinación de los siguientes indicadores:

FeatureDescripción
Plugin.NoNavigationFeaturesNo se admiten funciones de navegación.
Plugin.OnlineNavigationFeatureSe admite la navegación en línea.
Plugin.OfflineNavigationFeatureSe admite la navegación sin conexión.
Plugin.AnyNavigationFeaturesCoincide con un proveedor de servicios geográficos que ofrece cualquier función de navegación.

bool supportsPlaces(PlacesFeatures features)

Este método devuelve un valor booleano que indica si el complemento del proveedor de servicios geográficos admite el conjunto especificado de « features ». Se devuelve «True» si se admiten todas las « features » especificadas; en caso contrario, se devuelve «False».

El parámetro « features » puede ser cualquier combinación de los siguientes indicadores:

FeatureDescripción
Plugin.NoPlacesFeaturesNo se admiten características de lugares.
Plugin.OnlinePlacesFeatureSe admiten lugares en línea.
Plugin.OfflinePlacesFeatureSe admiten las funciones de lugares sin conexión.
Plugin.SavePlaceFeatureSe admite el guardado de categorías.
Plugin.RemovePlaceFeatureSe admite la eliminación de lugares.
Plugin.PlaceRecommendationsFeatureSe admite la búsqueda de lugares recomendados similares a otro lugar.
Plugin.SearchSuggestionsFeatureSe admiten las sugerencias de búsqueda.
Plugin.LocalizedPlacesFeatureAdmite la devolución de datos de lugares localizados.
Plugin.NotificationsFeatureSe admiten notificaciones de cambios en lugares y categorías.
Plugin.PlaceMatchingFeatureAdmite la coincidencia de lugares de dos proveedores de servicios geográficos diferentes.
Plugin.AnyPlacesFeaturesBusca un proveedor de servicios geográficos que ofrezca cualquier tipo de características de lugares.

bool supportsRouting(RoutingFeatures features)

Este método devuelve un valor booleano que indica si el complemento del proveedor de servicios geográficos admite el conjunto especificado de « features ». Se devuelve «True» si se admiten todos los « features » especificados; en caso contrario, se devuelve «False».

El parámetro ` features ` puede ser cualquier combinación de los siguientes indicadores:

FeatureDescripción
Plugin.NoRoutingFeaturesNo se admiten funciones de cálculo de rutas.
Plugin.OnlineRoutingFeatureSe admite el cálculo de rutas en línea.
Plugin.OfflineRoutingFeatureSe admite el cálculo de rutas sin conexión.
Plugin.LocalizedRoutingFeatureAdmite la devolución de rutas con direcciones e instrucciones localizadas.
Plugin.RouteUpdatesFeatureSe admite la actualización de una ruta existente en función de la posición actual.
Plugin.AlternativeRoutesFeaturePermite devolver rutas alternativas.
Plugin.ExcludeAreasRoutingFeaturePermite especificar áreas por las que la ruta devuelta no debe pasar.
Plugin.AnyRoutingFeaturesCoincide con un proveedor de servicios geográficos que ofrezca cualquier función de cálculo de rutas.

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