Plugin QML Type
PluginタイプはLocation based servicesプラグインを記述する。詳細...
Import Statement: | import QtLocation 6.8 |
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 }
プロパティ Documentation
allowExperimental : bool |
このプロパティは、実験的プラグインが使用できるかどうかを示す。
availableServiceProviders : stringlist |
isAttached : bool |
このプロパティは、Plugin アイテムがジオサービス・プロバイダ・プラグインにアタッチされているかどうかを示します。
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 では、ロケール一覧は常に空になります。
次のコードは、単一ロケールと複数ロケールを設定する方法を示しています:
name : string |
このプロパティは、プラグインの名前を保持します。このプロパティを設定すると、Pluginはこの名前のプラグインにのみアタッチされます。required の値は無視されます。
parameters : list<PluginParameter> |
このプロパティは、プラグインパラメータのリストを保持します。
preferred : stringlist |
このプロパティには、優先プラグイン名の順序付きリストが含まれ、他の利用可能なプラグインがチェックされる前に、required で設定された必須機能がチェックされます。
required : enumeration |
このプロパティには、どのサービスプラグインにアタッチするかを選択する際に、Plugin オブジェクトが必要とする機能のセットが含まれます。name プロパティが設定されている場合、これは影響しません。
以下の値のいずれか、または複数の値のビット単位の組み合わせを設定することができます:
- Plugin.NoFeatures
- Plugin.GeocodingFeature(ジオコーディング機能
- プラグイン.ReverseGeocodingFeature
- プラグイン.RoutingFeature
- プラグイン.MappingFeature
- Plugin.AnyPlacesFeature
メソッドのドキュメント
bool supportsGeocoding(GeocodingFeatures features) |
このメソッドは、指定されたfeatures のセットがジオ・サービス・プロバイダ・プラグインでサポートされているかどうかを示すブール値を返します。指定されたfeatures がすべてサポートされている場合はTrue
が返され、そうでない場合はfalse
が返されます。
features パラメータには、以下のフラグの組み合わせを指定できます:
機能 | 説明 |
---|---|
プラグイン.NoGeocodingFeatures | ジオコーディング機能はサポートされていません。 |
プラグイン.OnlineGeocodingFeature | オンライン・ジオコーディングはサポートされています。 |
プラグイン.OfflineGeocodingFeature | オフラインジオコーディングに対応しています。 |
プラグイン.ReverseGeocodingFeature | リバース・ジオコーディングに対応しています。 |
プラグイン.LocalizedGeocodingFeature | ローカライズされた住所でジオコーディング結果を返すことができます。 |
プラグイン.AnyGeocodingFeatures | 任意のジオコーディング機能を提供するジオサービスプロバイダにマッチします。 |
bool supportsMapping(MappingFeatures features) |
このメソッドは、指定されたfeatures のセットがジオサービスプロバイダプラグインでサポートされているかどうかを示すブール値を返します。指定されたfeatures がすべてサポートされている場合は True が返され、そうでない場合は False が返されます。
features パラメータには、以下のフラグの組み合わせを指定できます:
機能 | 説明 |
---|---|
プラグイン.NoMappingFeatures | マッピング機能はサポートされていません。 |
プラグイン.OnlineMappingFeature | オンライン・マッピングがサポートされています。 |
プラグイン.OfflineMappingFeature | オフラインマッピングがサポートされています。 |
プラグイン.LocalizedMappingFeature | ローカライズされた地図データを返すことができます。 |
プラグイン.AnyMappingFeatures | 任意のマッピング機能を提供するジオ・サービス・プロバイダに対応します。 |
bool supportsNavigation(NavigationFeatures features) |
このメソッドは、指定されたfeatures のセットがジオ・サービス・プロバイダのプラグインによってサポートされているかどうかを示すブール値を返します。指定されたfeatures がすべてサポートされている場合は True が返され、そうでない場合は False が返されます。
features パラメータには、以下のフラグの組み合わせを指定できます:
機能 | 説明 |
---|---|
プラグイン.NoNavigationFeatures | ナビゲーション機能はサポートされていません。 |
プラグイン.OnlineNavigationFeature | オンラインナビゲーションがサポートされています。 |
プラグイン.OfflineNavigationFeature | オフライン・ナビゲーションがサポートされています。 |
プラグイン.AnyNavigationFeatures | 任意のナビゲーション機能を提供するジオ・サービス・プロバイダにマッチします。 |
bool supportsPlaces(PlacesFeatures features) |
このメソッドは、指定されたfeatures のセットがジオ・サービス・プロバイダのプラグインでサポートされているかどうかを示すブール値を返します。指定されたfeatures がすべてサポートされている場合は True が返され、そうでない場合は False が返されます。
features パラメータには、以下のフラグの組み合わせを指定できます:
機能 | 説明 |
---|---|
プラグイン.NoPlacesFeatures | 場所機能はサポートされていません。 |
プラグイン.OnlinePlacesFeature | オンラインプレイスがサポートされています。 |
プラグイン.OfflinePlacesFeature | オフラインのプレイスがサポートされています。 |
プラグイン.SavePlaceFeature | カテゴリの保存がサポートされます。 |
プラグイン.RemovePlaceFeature | 場所の削除に対応しています。 |
Plugin.PlaceRecommendations機能 | 他の場所に似ているおすすめの場所を検索することができます。 |
プラグイン.SearchSuggestionsFeature | 検索候補をサポートします。 |
プラグイン.LocalizedPlacesFeature | 地域化された場所データを返すことに対応しました。 |
プラグイン.NotificationsFeature | 場所やカテゴリの変更を通知する機能に対応しました。 |
Plugin.PlaceMatching機能 | 2つの異なるジオサービスプロバイダからの場所のマッチングをサポートします。 |
プラグイン.AnyPlacesFeatures | 任意の場所の特徴を提供するジオサービスプロバイダとマッチします。 |
bool supportsRouting(RoutingFeatures features) |
このメソッドは、指定されたfeatures のセットがジオサービスプロバイダプラグインでサポートされているかどうかを示すブール値を返します。指定されたfeatures がすべてサポートされている場合は true が返され、そうでない場合は false が返されます。
features パラメータには、以下のフラグの組み合わせを指定できます:
機能 | 説明 |
---|---|
プラグイン.NoRoutingFeatures | ルーティング機能はサポートされていません。 |
プラグイン.OnlineRoutingFeature | オンライン・ルーティングがサポートされています。 |
プラグイン.OfflineRoutingFeature | オフラインルーティングがサポートされています。 |
プラグイン.LocalizedRoutingFeature | ローカライズされた住所と指示でルートを返すことができます。 |
プラグイン.RouteUpdatesFeature | 現在位置に基づいて既存のルートを更新することができます。 |
プラグイン.AlternativeRoutesFeature | 代替ルートを返すことに対応しています。 |
プラグイン.ExcludeAreasRoutingFeature | 返されるルートが通過してはならない地域を指定することに対応しています。 |
プラグイン.AnyRoutingFeatures | 任意のルーティング機能を提供するジオサービスプロバイダにマッチします。 |
© 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.