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);

Member Function Documentation

QPlaceSearchRequest::QPlaceSearchRequest()

Default constructor. Constructs an new request object.

QPlaceSearchRequest::QPlaceSearchRequest(const QPlaceSearchRequest &other)

Constructs a copy of other.

QPlaceSearchRequest::~QPlaceSearchRequest()

Destroys the request object.

QList<QPlaceCategory> QPlaceSearchRequest::categories() const

Return the categories to be used in the search request. Places need only to belong to one of the categories to be considered a match by the request.

See also setCategories().

void QPlaceSearchRequest::clear()

Clears the search request.

int QPlaceSearchRequest::limit() const

Returns the maximum number of search results to retrieve.

A negative value for limit means that it is undefined. It is left up to the backend provider to choose an appropriate number of results to return. The default limit is -1.

See also setLimit().

QString QPlaceSearchRequest::recommendationId() const

Returns the place id which will be used to search for recommendations for similar places.

See also setRecommendationId().

RelevanceHint QPlaceSearchRequest::relevanceHint() const

Returns the relevance hint of the request. The hint is given to the provider to help but not dictate the ranking of results. For example providing a distance hint may give closer places a higher ranking but it doesn't necessarily mean that he results will be ordered strictly according to distance.

See also setRelevanceHint().

QGeoShape QPlaceSearchRequest::searchArea() const

Returns the search area which will be used to limit search results. The default search area is an invalid QGeoShape, indicating that no specific search area is defined.

See also setSearchArea().

QVariant QPlaceSearchRequest::searchContext() const

Returns backend specific additional search context associated with this place search request. The search context is typically set as part of a proposed search results.

See also setSearchContext().

QString QPlaceSearchRequest::searchTerm() const

Returns the search term.

See also setSearchTerm().

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

Sets the search request to search from the list of given categories. Any places returned during the search will match at least one of the categories.

See also categories() and setCategory().

void QPlaceSearchRequest::setCategory(const QPlaceCategory &category)

Sets the search request to search by a single category

See also setCategories().

void QPlaceSearchRequest::setLimit(int limit)

Set the maximum number of search results to retrieve to limit.

See also limit().

void QPlaceSearchRequest::setRecommendationId(const QString &placeId)

Sets the placeId which will be used to search for recommendations.

See also recommendationId().

void QPlaceSearchRequest::setRelevanceHint(RelevanceHint hint)

Sets the relevance hint to be used when searching for a place.

See also relevanceHint().

void QPlaceSearchRequest::setSearchArea(const QGeoShape &area)

Sets the search request to search within the given area.

See also searchArea().

void QPlaceSearchRequest::setSearchContext(const QVariant &context)

Sets the search context to context.

Note: This method is intended to be used by geo service plugins when returning search results of type QPlaceSearchResult::ProposedSearchResult.

The search context is used by backends to store additional search context related to the search request. Other relevant fields should also be filled in. For example, if the search context encodes a text search the search term should also be set with setSearchTerm(). The search context allows additional search context to be kept which is not directly accessible via the Qt Location API.

The search context can be of any type storable in a QVariant. The value of the search context is not intended to be use directly by applications.

See also searchContext().

void QPlaceSearchRequest::setSearchTerm(const QString &term)

Sets the search term.

See also searchTerm().

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

Sets the visibility scope used when searching for places.

See also visibilityScope().

QLocation::VisibilityScope QPlaceSearchRequest::visibilityScope() const

Returns the visibility scope used when searching for places. The default value is QLocation::UnspecifiedVisibility meaning that no explicit scope has been assigned. Places of any scope may be returned during the search.

See also setVisibilityScope().

bool QPlaceSearchRequest::operator!=(const QPlaceSearchRequest &other) const

Returns true if other is not equal to this search request, otherwise returns false.

QPlaceSearchRequest &QPlaceSearchRequest::operator=(const QPlaceSearchRequest &other)

Assigns other to this search request and returns a reference to this search request.

bool QPlaceSearchRequest::operator==(const QPlaceSearchRequest &other) const

Returns true if other is equal to this search request, otherwise returns false.