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

Documentation des fonctions membres

QPlaceSearchRequest::QPlaceSearchRequest()

Constructeur par défaut. Construit un nouvel objet de requête.

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

Construit une copie de other.

[noexcept] QPlaceSearchRequest::~QPlaceSearchRequest()

Détruit l'objet de la demande.

QList<QPlaceCategory> QPlaceSearchRequest::categories() const

Renvoie les catégories à utiliser dans la demande de recherche. Il suffit que les lieux appartiennent à l'une des catégories pour que la requête soit considérée comme correspondante.

Voir aussi setCategories().

void QPlaceSearchRequest::clear()

Efface la demande de recherche.

int QPlaceSearchRequest::limit() const

Renvoie le nombre maximum de résultats de recherche à extraire.

Une valeur négative pour limite signifie qu'elle n'est pas définie. C'est au fournisseur du backend de choisir le nombre approprié de résultats à renvoyer. La limite par défaut est -1.

Voir aussi setLimit().

QString QPlaceSearchRequest::recommendationId() const

Renvoie l'identifiant du lieu qui sera utilisé pour rechercher des recommandations pour des lieux similaires.

Voir aussi setRecommendationId().

QPlaceSearchRequest::RelevanceHint QPlaceSearchRequest::relevanceHint() const

Renvoie l'indice de pertinence de la demande. L'indice est donné au fournisseur pour l'aider à classer les résultats, mais il ne lui est pas imposé. Par exemple, l'indication de la distance peut permettre de mieux classer les lieux les plus proches, mais cela ne signifie pas nécessairement que les résultats seront classés strictement en fonction de la distance.

Voir également setRelevanceHint().

QGeoShape QPlaceSearchRequest::searchArea() const

Renvoie la zone de recherche qui sera utilisée pour limiter les résultats de la recherche. La zone de recherche par défaut est un QGeoShape invalide, indiquant qu'aucune zone de recherche spécifique n'est définie.

Voir également setSearchArea().

QVariant QPlaceSearchRequest::searchContext() const

Renvoie le contexte de recherche supplémentaire spécifique au backend associé à cette demande de recherche de lieu. Le contexte de recherche est généralement défini dans le cadre d'une proposed search results.

Voir aussi setSearchContext().

QString QPlaceSearchRequest::searchTerm() const

Renvoie le terme de recherche.

Voir aussi setSearchTerm().

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

Définit la requête de recherche à partir de la liste de categories. Tous les lieux renvoyés au cours de la recherche doivent correspondre à au moins un des categories.

Voir aussi categories() et setCategory().

void QPlaceSearchRequest::setCategory(const QPlaceCategory &category)

Définit la demande de recherche en fonction d'un seul critère. category

Voir aussi setCategories().

void QPlaceSearchRequest::setLimit(int limit)

Définissez le nombre maximum de résultats de recherche à extraire sur limit.

Voir aussi limit().

void QPlaceSearchRequest::setRecommendationId(const QString &placeId)

Définit le site placeId qui sera utilisé pour rechercher des recommandations.

Voir également recommendationId().

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

Définit la pertinence hint à utiliser lors de la recherche d'un lieu.

Voir également relevanceHint().

void QPlaceSearchRequest::setSearchArea(const QGeoShape &area)

Définit la demande de recherche à l'intérieur de l'adresse area.

Voir aussi searchArea().

void QPlaceSearchRequest::setSearchContext(const QVariant &context)

Définit le contexte de recherche à context.

Le contexte de recherche est utilisé par les backends pour stocker un contexte de recherche supplémentaire lié à la demande de recherche. D'autres champs pertinents doivent également être remplis. Par exemple, si le contexte de recherche encode une recherche textuelle, le terme de recherche doit également être défini à l'aide de setSearchTerm(). Le contexte de recherche permet de conserver un contexte de recherche supplémentaire qui n'est pas directement accessible via l'API Qt Location.

Le contexte de recherche peut être de n'importe quel type stocké dans un fichier QVariant. La valeur du contexte de recherche n'est pas destinée à être utilisée directement par les applications.

Voir également searchContext().

void QPlaceSearchRequest::setSearchTerm(const QString &term)

Définit la recherche term.

Voir aussi searchTerm().

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

Définit la visibilité scope utilisée lors de la recherche de lieux.

Voir aussi visibilityScope().

QLocation::VisibilityScope QPlaceSearchRequest::visibilityScope() const

Renvoie l'étendue de la visibilité utilisée lors de la recherche de lieux. La valeur par défaut est QLocation::UnspecifiedVisibility, ce qui signifie qu'aucune portée explicite n'a été attribuée. Des lieux de n'importe quelle portée peuvent être renvoyés lors de la recherche.

Voir aussi setVisibilityScope().

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

Attribue other à cette demande de recherche et renvoie une référence à cette demande de recherche.