Plugin QML Type
Le type de plugin décrit un plugin de services basés sur la localisation. Plus d'informations...
| Import Statement: | import QtLocation 6.10 |
| Since: | QtLocation 5.5 |
Propriétés
- allowExperimental : bool
- availableServiceProviders : stringlist
- isAttached : bool
- locales : stringlist
- name : string
- parameters : list<PluginParameter>
- preferred : stringlist
- required : enumeration
Méthodes
- bool supportsGeocoding(GeocodingFeatures features)
- bool supportsMapping(MappingFeatures features)
- bool supportsNavigation(NavigationFeatures features)
- bool supportsPlaces(PlacesFeatures features)
- bool supportsRouting(RoutingFeatures features)
Description détaillée
Le type Plugin est utilisé pour spécifier de manière déclarative quel plugin GeoServices disponible doit être utilisé pour diverses tâches dans l'API de localisation. Les plugins sont utilisés par les types Map, RouteModel, et GeocodeModel, ainsi que par une variété d'autres.
Les plugins reconnus par le système ont une propriété name, une simple chaîne de caractères indiquant normalement le nom du service auprès duquel le plugin récupère des données. Ils possèdent également diverses caractéristiques, qui peuvent être testées à l'aide des méthodes supportsRouting(), supportsGeocoding(), supportsMapping(), supportsPlaces() et supportsNavigation().
Lorsqu'un objet Plugin est créé, il est "détaché" et n'est associé à aucun plugin de service réel. Une fois qu'il a reçu des informations en définissant ses propriétés name, preferred ou required, il choisit un plugin de service approprié auquel s'attacher. Les objets Plugin ne peuvent être attachés qu'une seule fois ; pour utiliser plusieurs plugins, il faut créer plusieurs objets Plugin.
Exemple d'utilisation
L'extrait suivant montre un objet Plugin créé avec les propriétés required et preferred. Ce plugin s'attachera au premier plugin trouvé qui supporte à la fois la cartographie et le géocodage, et préférera les plugins nommés "here" ou "osm" à tous les autres.
Plugin { id: plugin preferred: ["here", "osm"] required: Plugin.AnyMappingFeatures | Plugin.AnyGeocodingFeatures }
Propriété Documentation
allowExperimental : bool |
Cette propriété indique si des plugins expérimentaux peuvent être utilisés.
availableServiceProviders : stringlist |
isAttached : bool |
Cette propriété indique si l'élément Plugin est attaché à un plugin de fournisseur de géoservices.
locales : stringlist |
Cette propriété contient une liste ordonnée des paramètres locaux préférés du plugin. Si la première locale ne peut pas être prise en compte, le backend utilise la deuxième, et ainsi de suite. Par défaut, la propriété locales contient la locale du système.
Les locales sont spécifiées sous forme de chaînes de caractères ayant le format "language[_script][_country]" ou "C", où :
- language est un code de langue ISO 639 à deux lettres minuscules,
- script est un code de script en minuscules, à quatre lettres, de la norme ISO 15924,
- country est un code de pays en majuscules, à deux ou trois lettres, de la norme ISO 3166 (également "419" selon la définition des Nations unies),
- les paramètres régionaux "C" ont un comportement identique à celui de English/UnitedStates, conformément à l'article 6.1.1 de la loi sur la protection de l'environnement. QLocale
Si la première locale spécifiée ne peut être prise en compte, Plugin passe à la suivante, et ainsi de suite. Certains backends de Plugin peuvent ne pas prendre en charge un ensemble de paramètres régionaux définis de manière rigide. Un exemple arbitraire est que certains sites Place en France pourraient avoir des localisations en français et en anglais, alors que certaines régions d'Amérique pourraient n'avoir que la localisation en anglais. Dans le scénario ci-dessus, l'ensemble des langues prises en charge dépend du contexte de l'emplacement de la recherche.
Si le site Plugin ne peut prendre en charge aucune des langues préférées, le gestionnaire se rabat sur l'utilisation d'une langue prise en charge qui est spécifique au backend.
Pour les sites Plugin qui ne prennent pas en charge les langues locales, la liste des langues locales est toujours vide.
Le code suivant montre comment définir une ou plusieurs langues :
name : string |
Cette propriété contient le nom du plugin. En définissant cette propriété, le plugin ne s'attachera qu'à un plugin portant exactement ce nom. La valeur de required sera ignorée.
parameters : list<PluginParameter> |
Cette propriété contient la liste des paramètres du plugin.
preferred : stringlist |
Cette propriété contient une liste ordonnée de noms de plugins préférés, qui seront vérifiés pour les caractéristiques requises définies dans required avant que tout autre plugin disponible ne soit vérifié.
required : enumeration |
Cette propriété contient l'ensemble des caractéristiques qui seront exigées par l'objet Plugin lors du choix du plugin de service auquel il doit s'attacher. Si la propriété name est définie, cela n'a aucun effet.
L'une des valeurs suivantes ou une combinaison bit à bit de plusieurs valeurs peut être définie :
- Plugin.NoFeatures
- Plugin.GeocodingFeature
- Plugin.ReverseGeocodingFeature
- Plugin.RoutingFeature
- Plugin.MappingFeature
- Plugin.AnyPlacesFeature
Documentation de la méthode
bool supportsGeocoding(GeocodingFeatures features) |
Cette méthode renvoie un booléen indiquant si l'ensemble spécifié de features est pris en charge par le plugin de fournisseur de services géographiques. True est renvoyé si tous les features spécifiés sont pris en charge, sinon false est renvoyé.
Le paramètre features peut être n'importe quelle combinaison de drapeaux :
| Fonctionnalité | Description |
|---|---|
| Plugin.NoGeocodingFeatures | Aucune caractéristique de géocodage n'est prise en charge. |
| Plugin.OnlineGeocodingFeature | Le géocodage en ligne est pris en charge. |
| Plugin.OfflineGeocodingFeature | Le géocodage hors ligne est pris en charge. |
| Plugin.ReverseGeocodingFeature | Le géocodage inversé est pris en charge. |
| Plugin.LocalizedGeocodingFeature | Permet de renvoyer les résultats du géocodage avec des adresses localisées. |
| Plugin.AnyGeocodingFeatures | Correspond à un fournisseur de services géographiques qui propose toutes les fonctionnalités de géocodage. |
bool supportsMapping(MappingFeatures features) |
Cette méthode renvoie un booléen indiquant si l'ensemble spécifié de features est pris en charge par le plugin du fournisseur de services géographiques. True est renvoyé si tous les features spécifiés sont pris en charge, sinon false est renvoyé.
Le paramètre features peut être n'importe quelle combinaison de drapeaux :
| Fonctionnalité | Description |
|---|---|
| Plugin.NoMappingFeatures | Aucune caractéristique de cartographie n'est prise en charge. |
| Plugin.OnlineMappingFeature | La cartographie en ligne est prise en charge. |
| Plugin.OfflineMappingFeature | La cartographie hors ligne est prise en charge. |
| Plugin.LocalizedMappingFeature | Prise en charge du retour des données cartographiques localisées. |
| Plugin.AnyMappingFeatures | Correspond à un fournisseur de services géographiques qui fournit toutes les fonctionnalités de cartographie. |
bool supportsNavigation(NavigationFeatures features) |
Cette méthode renvoie un booléen indiquant si l'ensemble spécifié de features est pris en charge par le plugin du fournisseur de services géographiques. La valeur True est renvoyée si tous les features spécifiés sont pris en charge, sinon la valeur false est renvoyée.
Le paramètre features peut être n'importe quelle combinaison de drapeaux :
| Fonctionnalité | Description |
|---|---|
| Plugin.NoNavigationFeatures | Aucune fonctionnalité de navigation n'est prise en charge. |
| Plugin.OnlineNavigationFeature | La navigation en ligne est prise en charge. |
| Plugin.OfflineNavigationFeature | La navigation hors ligne est prise en charge. |
| Plugin.AnyNavigationFeatures | Correspond à un fournisseur de services géographiques qui propose des fonctions de navigation. |
bool supportsPlaces(PlacesFeatures features) |
Cette méthode renvoie un booléen indiquant si l'ensemble spécifié de features est pris en charge par le plugin du fournisseur de services géographiques. La valeur True est renvoyée si tous les features spécifiés sont pris en charge, sinon la valeur false est renvoyée.
Le paramètre features peut être n'importe quelle combinaison de drapeaux :
| Fonctionnalité | Description |
|---|---|
| Plugin.NoPlacesFeatures | Aucune caractéristique de lieu n'est prise en charge. |
| Plugin.OnlinePlacesFeature | Les lieux en ligne sont pris en charge. |
| Plugin.OfflinePlacesFeature | Les lieux hors ligne sont pris en charge. |
| Plugin.SavePlaceFeature | La sauvegarde des catégories est prise en charge. |
| Plugin.RemovePlaceFeature | Le retrait ou la suppression de lieux est pris en charge. |
| Plugin.PlaceRecommendationsFeature | La recherche de lieux recommandés similaires à un autre lieu est prise en charge. |
| Plugin.SearchSuggestionsFeature | La recherche de suggestions est prise en charge. |
| Plugin.LocalizedPlacesFeature | Prise en charge du renvoi de données localisées sur les lieux. |
| Plugin.NotificationsFeature | La notification des changements de lieux et de catégories est prise en charge. |
| Plugin.PlaceMatchingFeature | Permet de faire correspondre des lieux provenant de deux fournisseurs de services géographiques différents. |
| Plugin.AnyPlacesFeatures | Correspond à un fournisseur de services géographiques qui propose des caractéristiques de lieux quelconques. |
bool supportsRouting(RoutingFeatures features) |
Cette méthode renvoie un booléen indiquant si l'ensemble spécifié de features est pris en charge par le plugin du fournisseur de services géographiques. La valeur True est renvoyée si tous les features spécifiés sont pris en charge, sinon la valeur false est renvoyée.
Le paramètre features peut être une combinaison de drapeaux :
| Fonctionnalité | Description |
|---|---|
| Plugin.NoRoutingFeatures | Aucune fonctionnalité de routage n'est prise en charge. |
| Plugin.OnlineRoutingFeature | Le routage en ligne est pris en charge. |
| Plugin.OfflineRoutingFeature | Le routage hors ligne est pris en charge. |
| Plugin.LocalizedRoutingFeature | Prend en charge le retour des itinéraires avec des adresses et des instructions localisées. |
| Plugin.RouteUpdatesFeature | La mise à jour d'un itinéraire existant en fonction de la position actuelle est prise en charge. |
| Plugin.AlternativeRoutesFeature | Permet de renvoyer des itinéraires alternatifs. |
| Plugin.ExcludeAreasRoutingFeature | Permet de spécifier les zones que l'itinéraire retourné ne doit pas traverser. |
| Plugin.AnyRoutingFeatures | Correspond à un fournisseur de services géographiques qui propose toutes les fonctionnalités d'acheminement. |
© 2025 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.