QPlaceSearchRequest Class

QPlaceSearchRequest searchRequest;
searchRequest.setSearchTerm("Fast food"); //search term for what we are interested in

//set a search center
searchRequest.setSearchArea(QGeoCircle(QGeoCoordinate(2.3, 48.87)));

//set a distance hint as a relevancy hint.
//closer places have greater weighting in the ranking of results.
searchRequest.setRelevanceHint(QPlaceSearchRequest::DistanceHint);

//use limit to adjust pagination.
//this limits the number of place results to 5 per page.
searchRequest.setLimit(5);

//provide some categories to narrow down search
QList<QPlaceCategory> categories;
categories << diner << restaurant;
searchRequest.setCategories(categories);

メンバ関数ドキュメント

QPlaceSearchRequest::QPlaceSearchRequest()

デフォルトコンストラクタ。新しいリクエストオブジェクトを構築する。

[noexcept] QPlaceSearchRequest::QPlaceSearchRequest(const QPlaceSearchRequest &other)

other のコピーを構築します。

[noexcept] QPlaceSearchRequest::~QPlaceSearchRequest()

リクエストオブジェクトを破棄します。

QList<QPlaceCategory> QPlaceSearchRequest::categories() const

検索リクエストで使われるカテゴリーを返します。場所がリクエストによってマッチするとみなされるためには、カテゴリの1つに属していればよい。

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

void QPlaceSearchRequest::clear()

検索リクエストをクリアします。

int QPlaceSearchRequest::limit() const

検索結果の最大数を返します。

limit に負の値を指定すると、未定義であることを意味します。適切な数の結果を返すかどうかはバックエンドプロバイダに任されています。デフォルトの limit は -1 です。

setLimit()も参照 ください。

QString QPlaceSearchRequest::recommendationId() const

場所 ID を返します。この ID を使用して、似た場所のおすすめを検索します。

setRecommendationId()も参照 ください。

QPlaceSearchRequest::RelevanceHint QPlaceSearchRequest::relevanceHint() const

リクエストの関連性のヒントを返します。このヒントは、検索結果のランキングを決定するのではなく、 検索を支援するために提供者に渡されます。例えば、距離のヒントを与えることで、より近い場所をより上位に表示することができますが、必ずしも結果が距離に従って厳密に並べられることを意味するわけではありません。

setRelevanceHint()も参照 。

QGeoShape QPlaceSearchRequest::searchArea() const

検索結果を制限するために使用する検索エリアを返します。デフォルトの検索領域は無効なQGeoShape で、特定の検索領域が定義されていないことを示します。

setSearchArea() も参照 。

QVariant QPlaceSearchRequest::searchContext() const

このプレイス検索リクエストに関連付けられた、バックエンド固有の追加検索コンテキストを返す。検索コンテキストは通常、proposed search results の一部として設定される。

setSearchContext() も参照 。

QString QPlaceSearchRequest::searchTerm() const

検索語を返します。

setSearchTerm() も参照 。

void QPlaceSearchRequest::setCategories(const QList<QPlaceCategory> &categories)

指定されたcategories のリストから検索するように、検索要求を設定します。検索中に返される場所はすべて、categories の少なくとも 1 つにマッチします。

categories() およびsetCategory() も参照 。

void QPlaceSearchRequest::setCategory(const QPlaceCategory &category)

検索要求を、単一の検索文字列で検索するように設定します。category

setCategories() も参照 。

void QPlaceSearchRequest::setLimit(int limit)

検索結果の最大取得数をlimit に設定します。

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

void QPlaceSearchRequest::setRecommendationId(const QString &placeId)

推奨検索に使用するplaceId を設定します。

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

void QPlaceSearchRequest::setRelevanceHint(QPlaceSearchRequest::RelevanceHint hint)

場所を検索する際に使用する関連性hint を設定します。

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

void QPlaceSearchRequest::setSearchArea(const QGeoShape &area)

指定されたarea 内を検索するように検索要求を設定します。

searchArea() も参照 。

void QPlaceSearchRequest::setSearchContext(const QVariant &context)

検索コンテキストをcontext に設定する。

検索コンテキストは、検索リクエストに関連する追加の検索コンテキストを格納するためにバックエンドによって使用される。他の関連するフィールドも埋められるべきである。例えば、検索コンテキストがテキスト検索をエンコードする場合、検索用語もsetSearchTerm() で設定されるべきである。検索コンテキストは、Qt Location API から直接アクセスできない追加の検索コンテキストを保持することができます。

検索コンテキストは、QVariant に格納可能な任意の型にすることができます。 検索コンテキストの値は、アプリケーションによって直接使用されることを意図していません。

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

void QPlaceSearchRequest::setSearchTerm(const QString &term)

検索term を設定します。

searchTerm() も参照 。

void QPlaceSearchRequest::setVisibilityScope(QLocation::VisibilityScope scope)

場所を検索するときに使用する可視性scope を設定します。

visibilityScope() も参照 。

QLocation::VisibilityScope QPlaceSearchRequest::visibilityScope() const

場所を検索する際に使用する可視性の範囲を返します。デフ ォル ト 値はQLocation::UnspecifiedVisibility で、 明示的な ス コ ープが割 り 当て ら れていない こ と を意味 し ます。検索時には、任意のスコープの場所を返すことができます。

setVisibilityScope()も参照 。

[noexcept] QPlaceSearchRequest &QPlaceSearchRequest::operator=(const QPlaceSearchRequest &other)

この検索要求にother を割り当て、この検索要求への参照を返します。