Plugin QML Type

PluginタイプはLocation based servicesプラグインを記述する。詳細...

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

継承されたメンバーを含む全メンバーのリスト

プロパティ

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

方法

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

詳細説明

Plugin 型は、Location API のさまざまなタスクに使用する GeoServices プラグインを宣言的に指定するために使用される。プラグインは、Map 、RouteModel 、GeocodeModel の各タイプのほか、さまざまなタイプで使用される。

システムによって認識されるプラグインには、name プロパティがあり、これは通常、プラグインがデータを取得するサービス名を示す単純な文字列である。また、supportsRouting （）、supportsGeocoding （）、supportsMapping （）、supportsPlaces （）、supportsNavigation （）メソッドを使用してテストすることができます。

Pluginオブジェクトが生成されると、それは「切り離された」状態になり、実際のサービス・プラグインとは関連付けられません。name 、preferred 、required プロパティを設定して情報を受け取ると、適切なサービスプラグインを選択してアタッチします。複数のプラグインを使用するには、複数のPluginオブジェクトを作成してください。

使用例

次のスニペットは、required とpreferred プロパティが設定されたPluginオブジェクトが作成されていることを示しています。このPluginは、マッピングとジオコーディングの両方をサポートする最初に見つかったプラグインにアタッチし、他のプラグインよりも "here "または "osm "という名前のプラグインを優先します。

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

プロパティの説明

allowExperimental : bool

このプロパティは、実験的なプラグインを使用できるかどうかを示します。

availableServiceProviders : stringlist

このプロパティは、利用可能なすべてのサービスプラグイン名のリストを保持します。name とrequired によって提供される制御が必要性に十分でない場合、これは利用可能なプラグインを手動で列挙するために使用することができます。

isAttached : bool

このプロパティは、プラグイン項目がジオサービスプロバイダプラグインに接続されているかどうかを示します。

locales : stringlist

このプロパティには、優先されるプラグインのロケールの順序付きリストが含まれます。最初のロケールに対応できない場合は、バックエンドは 2 番目のロケールを使用するようになります。デフォルトでは、locale プロパティはシステムロケールを含みます。

ロケールは "language[_script][_country]"または "C "という書式の文字列で指定します：

languageは小文字の2文字のISO 639言語コードです、
scriptは、タイトルケース、4文字、ISO 15924スクリプトコードです、
countryは大文字の2文字または3文字のISO 3166国コード（国連が定義する「419」でもある）、
C" ロケールは English/UnitedStates と動作が同じです。QLocale

最初に指定されたロケールに対応できない場合、Plugin 。Plugin バックエンドの中には、厳密に定義されたロケールのセットをサポートしていないものもある。任意の例として、フランスのPlace の中にはフランス語と英語のローカライズがあるものもあれば、アメリカのある地域では英語のローカライズしかないものもあります。上記のシナリオでは、サポートされるロケールのセットは検索場所に依存します。

もしPlugin が希望するロケールに対応できない場合、マネージャはバックエンド固有のサポート言語を使用することになります。

ロケールをサポートしていないPlugin では、ロケール一覧は常に空になります。

次のコードは、単一ロケールと複数ロケールを設定する方法を示しています：

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

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

name : string

このプロパティはプラグインの名前を保持します。このプロパティを設定すると、Pluginはこの名前のプラグインにのみアタッチするようになります。required の値は無視されます。

parameters : list<PluginParameter> `[default]`

このプロパティは、プラグインパラメータのリストを保持する。

preferred : stringlist

このプロパティには、優先プラグイン名の順序付きリストが含まれており、他の利用可能なプラグインがチェックされる前に、required で設定された必須機能がチェックされます。

required : enumeration

このプロパティには、どのサービスプラグインにアタッチするかを選択する際に、Plugin オブジェクトが必要とする機能のセットが含まれます。name プロパティが設定されている場合、これは影響しません。

以下の値のいずれか、または複数の値のビット単位の組み合わせを設定することができます：

Plugin.NoFeatures
Plugin.GeocodingFeature（ジオコーディング機能
プラグイン.ReverseGeocodingFeature
プラグイン.RoutingFeature
プラグイン.MappingFeature
Plugin.AnyPlacesFeature

メソッド・ドキュメント

bool supportsGeocoding(GeocodingFeatures features)

このメソッドは、指定されたfeatures のセットがジオサービスプロバイダプラグインでサポートされているかどうかを示すブール値を返します。指定されたfeatures がすべてサポートされている場合はTrue が返され、そうでない場合はfalse が返されます。