Plugin QML Type

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

Import Statement: import QtLocation 6.8
Since: QtLocation 5.5

プロパティ

方法

詳細説明

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

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

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

使用例

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

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

プロパティ Documentation

allowExperimental : bool

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


availableServiceProviders : stringlist

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


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

最初に指定されたロケールに対応できない場合、PluginPlugin バックエンドの中には、厳密に定義されたロケールのセットをサポートしていないものもある。任意の例として、フランスの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 が返されます。

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.