PlaceSearchModel QML Type

このプロパティは、検索時に使用されるカテゴリのリストを保持する。返される検索結果は、少なくとも1つのカテゴリーに一致する場所となります。

このプロパティは、モデルが持つ検索結果の数を保持します。

バックエンドで利用可能な検索結果の総数を指すものではないことに注意してください。検索結果の総数は現在APIではサポートされていません。

このプロパティは、検索結果の場所をfavoritesPlugin のお気に入りにマッチさせる方法を指定するために使用されるパラメータのセットを保持します。

デフォルトでは、パラメータマップは空であり、お気に入りプラグインが代替識別子でマッチングすることを意味する。通常、アプリケーション開発者はこのプロパティを設定する必要はありません。

お気に入りプラグインが代替識別子によるマッチングをサポートしていない場合、どのようなキー・バリュー・パラメータを設定すればよいかは、プラグインのドキュメントを参照する必要があります。

このプロパティは、お気に入りの検索に使用されるPlugin 。検索結果から、favoritesPluginで相互参照またはマッチングが可能な場所は、そのfavorite プロパティにfavoritesPluginの対応するPlace が設定されます。

favoritesPlugin が設定されていない場合、検索結果の場所のfavorite プロパティは常に null になります。

Favoritesも参照してください 。

このプロパティは、ページングがPlaceSearchModel にどのように影響するかを制御します。trueの場合、previousPage またはnextPage を呼び出してもモデルはリセットされず、代わりに新しい結果がモデルに追加されます。デフォルトはfalseです。

このプロパティはQtLocation 5.12で導入されました。

このプロパティは、返される項目の数の上限を保持します。

このプロパティは、検索結果の追加ページが 1 つ以上あるかどうかを保持します。

nextPage()も参照してください 。

このプロパティは、検索に使用されるPlugin を保持します。

このプロパティは、利用可能な検索結果の前のページが 1 つ以上あるかどうかを保持します。

previousPage() も参照して ください。

このプロパティは、類似の場所の推奨を検索するために使用される placeId を保持します。

このプロパティは、検索クエリで使用される関連性のヒントを保持します。このヒントは、結果のランキングを決定するのではなく、手助けするためにプロバイダに与えられます。例えば、距離のヒントはより近い場所に高いランキングを与えるかもしれないが、必ずしも結果が距離に従って厳密に並べられることを意味しない。プロバイダはヒントを完全に無視することもできます。

このプロパティは検索領域を保持します。モデルによって返される検索結果は、検索領域内になります。

このプロパティがgeocircle に設定されている場合、そのradius プロパティは未設定のままにしておくことができ、その場合、Plugin は検索のための適切な半径を選択します。

検索領域を指定するためのサポートは、plugin バックエンドの実装によって異なります。例えば、検索中心のみをサポートするものもあれば、ジオ・レクタングルのみをサポートするものもあります。

このプロパティは、クエリで使用される検索用語を保持する。検索語は自由形式のテキスト文字列です。

このプロパティはモデルの状態を保持する。以下のいずれかになります：

このプロパティは、検索する場所の可視範囲を保持します。指定された可視性を持つ場所のみが検索結果に返されます。

可視性スコープには以下のいずれかを指定します：

進行中の検索操作を直ちにキャンセルし、モデルのステータスをPlaceSearchModel.Readyに設定します。モデルは、操作が開始される前に持っていた検索結果を保持します。

操作が進行中でない場合、cancel() を呼び出しても何の効果もありません。

update() およびstatusも参照してください 。

指定されたrole のデータを、指定された行index で返します。

この読み取り専用プロパティは、最新の場所検索モデル・エラーのテキスト表示を保持します。エラーが発生していない場合、またはモデルがクリアされた場合は、空の文字列が返されます。

関連するテキスト表現がないエラーが発生した場合は、空文字列が返されることもある。

検索結果の次のページを表示するようにモデルを更新します。次のページがない場合、このメソッドは何もしません。

検索結果の前のページを表示するようにモデルを更新します。前のページがない場合、このメソッドは何もしません。

モデルをリセットします。すべての検索結果はクリアされ、未処理のリクエストはすべて中止され、考えられるエラーはクリアされます。モデルのステータスはPlaceSearchModel.Null に設定されます。

提供されたクエリパラメータに基づいてモデルを更新します。モデルには、型のプロパティによって指定された検索パラメータに一致する場所のリストが入力されます。検索基準は、searchTerm 、categories 、searchArea 、limit などのプロパティを設定することによって指定されます。これらのプロパティのサポートは、plugin によって異なる可能性があります。update() は、処理するために、plugin に基準のセットを提出します。

モデルが更新されている間、モデルのstatus はPlaceSearchModel.Loading にセットされる。モデルが正常に更新された場合、status はPlaceSearchModel.Ready にセットされ、更新が完了しなかった場合、status はPlaceSearchModel.Error にセットされ、モデルはクリアされる。

PlaceSearchModel {
    id: model
    plugin: backendPlugin
    searchArea: QtPositioning.circle(QtPositioning.coordinate(10, 10))
    ...
}

MouseArea {
    ...
    onClicked: {
        model.searchTerm = "pizza";
        model.categories = null;  //not searching by any category
        model.searchArea.center.latitude = -27.5;
        model.searchArea.center.longitude = 153;
        model.update();
    }
}

cancel() およびstatusも参照のこと 。

インデックスproposedSearchIndex の ProposedSearchResult に基づいてモデルを更新します。モデルには、提案された検索にマッチする場所のリストが入力されます。モデルのステータスはPlaceSearchModel.Loading に設定されます。モデルが正常に更新された場合、ステータスはPlaceSearchModel.Ready に設定されます。エラーが発生した場合、ステータスはPlaceSearchModel.Error に設定され、モデルはクリアされます。

proposedSearchIndex が ProposedSearchResult を参照していない場合、このメソッドは何もしません。