Plugin QML Type

Der Plugin-Typ beschreibt ein Plugin für standortbezogene Dienste. Mehr...

Import Statement:	`import QtLocation 6.8`
Since:	QtLocation 5.5

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

allowExperimental : bool
availableServiceProviders : stringlist
isAttached : bool
locales : stringlist
name : string
parameters : list<PluginParameter>
preferred : stringlist
required : enumeration

Methoden

bool supportsGeocoding(GeocodingFeatures features)
bool supportsMapping(MappingFeatures features)
bool supportsNavigation(NavigationFeatures features)
bool supportsPlaces(PlacesFeatures features)
bool supportsRouting(RoutingFeatures features)

Detaillierte Beschreibung

Der Plugin-Typ wird verwendet, um deklarativ anzugeben, welches verfügbare GeoServices-Plugin für verschiedene Aufgaben in der Location API verwendet werden soll. Plugins werden von den Typen Map, RouteModel und GeocodeModel sowie von einer Vielzahl anderer Typen verwendet.

Plugins, die vom System erkannt werden, haben eine name Eigenschaft, eine einfache Zeichenkette, die normalerweise den Namen des Dienstes angibt, von dem das Plugin Daten abruft. Sie haben auch eine Vielzahl von Eigenschaften, die mit den Methoden supportsRouting(), supportsGeocoding(), supportsMapping(), supportsPlaces() und supportsNavigation() getestet werden können.

Wenn ein Plugin-Objekt erstellt wird, ist es "losgelöst" und nicht mit einem tatsächlichen Service-Plugin verbunden. Sobald es über die Eigenschaften name, preferred oder required Informationen erhalten hat, wählt es ein geeignetes Service-Plugin aus, dem es sich anschließen kann. Plugin-Objekte können nur einmal angehängt werden; um mehrere Plugins zu verwenden, erstellen Sie mehrere Plugin-Objekte.

Beispielverwendung

Der folgende Ausschnitt zeigt ein Plugin-Objekt, das mit den Eigenschaften required und preferred erstellt wurde. Dieses Plugin verbindet sich mit dem ersten gefundenen Plugin, das sowohl Mapping als auch Geokodierung unterstützt, und bevorzugt Plugins mit den Namen "here" oder "osm" vor allen anderen.

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

Eigenschaft Dokumentation

allowExperimental : bool

Diese Eigenschaft zeigt an, ob experimentelle Plugins verwendet werden können.

availableServiceProviders : stringlist

Diese Eigenschaft enthält eine Liste mit den Namen aller verfügbaren Service-Plugins. Sie kann verwendet werden, um die verfügbaren Plugins manuell aufzuzählen, wenn die von name und required bereitgestellte Kontrolle für Ihre Bedürfnisse nicht ausreicht.

isAttached : bool

Diese Eigenschaft zeigt an, ob das Plugin-Element mit einem Geodienstanbieter-Plugin verbunden ist.

locales : stringlist

Diese Eigenschaft enthält eine geordnete Liste der bevorzugten Plugin-Sprachumgebungen. Wenn das erste Gebietsschema nicht untergebracht werden kann, greift das Backend auf das zweite zurück, und so weiter. Standardmäßig enthält die Eigenschaft locales das Systemgebietsschema.

Die Gebietsschemata werden als Zeichenketten angegeben, die das Format "language[_script][_country]" oder "C" haben, wobei:

language ein klein geschriebener, zweistelliger ISO 639-Sprachcode ist,
script ein aus vier Buchstaben bestehender ISO 15924-Schriftcode in Großbuchstaben ist,
country ein zwei- oder dreibuchstabiger ISO-3166-Ländercode in Großbuchstaben ist (auch "419" gemäß der Definition der Vereinten Nationen),
das Gebietsschema "C" verhält sich identisch zu English/UnitedStates gemäß QLocale

Wenn das erste angegebene Gebietsschema nicht untergebracht werden kann, greift Plugin auf das nächste zurück und so weiter. Einige Plugin Backends unterstützen möglicherweise keine fest definierten Locales. Ein willkürliches Beispiel ist, dass einige Place's in Frankreich französische und englische Lokalisierungen haben könnten, während bestimmte Gebiete in Amerika nur die englische Lokalisierung zur Verfügung haben könnten. Im obigen Szenario ist die Menge der unterstützten Gebietsschemata kontextabhängig vom Suchort.

Wenn Plugin keine der bevorzugten Gebietsschemata unterstützen kann, greift der Manager auf eine unterstützte Sprache zurück, die Backend-spezifisch ist.

Für Plugin, die keine Sprachumgebungen unterstützen, ist die Liste der Sprachumgebungen immer leer.

Der folgende Code veranschaulicht, wie ein einzelnes und mehrere Gebietsschemata festgelegt werden können:

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

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

name : string

Diese Eigenschaft enthält den Namen des Plugins. Das Setzen dieser Eigenschaft bewirkt, dass das Plugin nur mit einem Plugin mit genau diesem Namen verbunden wird. Der Wert von required wird ignoriert.

parameters : list<PluginParameter> [default]

Diese Eigenschaft enthält die Liste der Plugin-Parameter.

preferred : stringlist

Diese Eigenschaft enthält eine geordnete Liste der bevorzugten Plugin-Namen, die auf die unter required festgelegten erforderlichen Merkmale geprüft werden, bevor andere verfügbare Plugins überprüft werden.

required : enumeration

Diese Eigenschaft enthält den Satz von Merkmalen, die vom Plugin-Objekt bei der Auswahl des zuzuordnenden Service-Plugins benötigt werden. Wenn die Eigenschaft name gesetzt ist, hat dies keine Auswirkung.

Jeder der folgenden Werte oder eine bitweise Kombination mehrerer Werte kann gesetzt werden:

Plugin.NoFeatures
Plugin.GeocodingFeature
Plugin.ReverseGeocodingFeature
Plugin.RoutingFeature
Plugin.MappingFeature
Plugin.AnyPlacesFeature

Dokumentation der Methode

bool supportsGeocoding(GeocodingFeatures features)

Diese Methode gibt einen booleschen Wert zurück, der angibt, ob der angegebene Satz von features vom Geodienstanbieter-Plugin unterstützt wird. True wird zurückgegeben, wenn alle angegebenen features unterstützt werden; andernfalls wird false zurückgegeben.

Der Parameter features kann eine beliebige Flag-Kombination von sein:

Merkmal	Beschreibung
Plugin.NoGeocodingFeatures	Es werden keine Geokodierungsmerkmale unterstützt.
Plugin.OnlineGeocodingFeature	Online-Geokodierung wird unterstützt.
Plugin.OfflineGeocodingFeature	Offline-Geokodierung wird unterstützt.
Plugin.ReverseGeocodingFeature	Umgekehrte Geokodierung wird unterstützt.
Plugin.LocalizedGeocodingFeature	Unterstützt die Rückgabe von Geokodierungsergebnissen mit lokalisierten Adressen.
Plugin.AnyGeocodingFeatures	Passt zu einem Geodienstanbieter, der beliebige Geokodierungsmerkmale anbietet.

bool supportsMapping(MappingFeatures features)

Diese Methode gibt einen booleschen Wert zurück, der angibt, ob der angegebene Satz von features vom Geodienstanbieter-Plugin unterstützt wird. True wird zurückgegeben, wenn alle angegebenen features unterstützt werden; andernfalls wird false zurückgegeben.

Der Parameter features kann eine beliebige Flag-Kombination sein aus:

Merkmal	Beschreibung
Plugin.NoMappingFeatures	Es werden keine Mapping-Features unterstützt.
Plugin.OnlineMappingFeature	Online Mapping wird unterstützt.
Plugin.OfflineMappingFeature	Offline Mapping wird unterstützt.
Plugin.LocalizedMappingFeature	Unterstützt die Rückgabe von lokalisierten Kartendaten.
Plugin.AnyMappingFeatures	Passt zu einem Geodienstanbieter, der beliebige Kartierungsmerkmale anbietet.

bool supportsNavigation(NavigationFeatures features)

Diese Methode gibt einen booleschen Wert zurück, der angibt, ob der angegebene Satz von features von dem Geodienstanbieter-Plugin unterstützt wird. True wird zurückgegeben, wenn alle angegebenen features unterstützt werden; andernfalls wird false zurückgegeben.

Der Parameter features kann eine beliebige Flag-Kombination von sein:

Merkmal	Beschreibung
Plugin.NoNavigationFeatures	Es werden keine Navigationsfunktionen unterstützt.
Plugin.OnlineNavigationFeature	Die Online-Navigation wird unterstützt.
Plugin.OfflineNavigationFeature	Offline-Navigation wird unterstützt.
Plugin.AnyNavigationFeatures	Passt zu einem Geodienstanbieter, der beliebige Navigationsfunktionen anbietet.

bool supportsPlaces(PlacesFeatures features)

Der Parameter features kann eine beliebige Flaggenkombination sein aus:

Merkmal	Beschreibung
Plugin.NoPlacesFeatures	Es werden keine Ortsmerkmale unterstützt.
Plugin.OnlinePlacesFeature	Online Orte werden unterstützt.
Plugin.OfflinePlacesFeature	Offline-Orte werden unterstützt.
Plugin.SavePlacesFeature	Das Speichern von Kategorien wird unterstützt.
Plugin.RemovePlaceFeature	Das Entfernen oder Löschen von Orten wird unterstützt.
Plugin.PlaceRecommendationsFeature	Die Suche nach empfohlenen Orten, die einem anderen Ort ähnlich sind, wird unterstützt.
Plugin.SearchSuggestionsFeature	Die Suche nach Vorschlägen wird unterstützt.
Plugin.LocalizedPlacesFeature	Unterstützt die Rückgabe von lokalisierten Ortsdaten.
Plugin.NotificationsFeature	Benachrichtigungen über Orts- und Kategorieänderungen werden unterstützt.
Plugin.PlaceMatchingFeature	Unterstützt den Abgleich von Orten von zwei verschiedenen Geodienstanbietern.
Plugin.AnyPlacesFeatures	Passt zu einem Geodienstanbieter, der beliebige Ortsmerkmale anbietet.

bool supportsRouting(RoutingFeatures features)

Der Parameter features kann eine beliebige Flaggenkombination sein aus:

Merkmal	Beschreibung
Plugin.NoRoutingFeatures	Es werden keine Routing-Funktionen unterstützt.
Plugin.OnlineRoutingFeature	Online-Routing wird unterstützt.
Plugin.OfflineRoutingFeature	Offline-Routing wird unterstützt.
Plugin.LocalizedRoutingFeature	Unterstützt die Rückgabe von Routen mit lokalisierten Adressen und Anweisungen.
Plugin.RouteUpdatesFeature	Unterstützt das Aktualisieren einer bestehenden Route auf der Basis der aktuellen Position.
Plugin.AlternativeRoutesFeature	Unterstützt die Rückgabe alternativer Routen.
Plugin.ExcludeAreasRoutingFeature	Unterstützt die Angabe von Gebieten, die die zurückgegebene Route nicht durchqueren darf.
Plugin.AnyRoutingFeatures	Entspricht einem Geodienstanbieter, der beliebige Routing-Funktionen anbietet.

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