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. Crée un nouvel objet « request ».

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

Crée une copie de other.

[constexpr noexcept default] QPlaceSearchRequest::QPlaceSearchRequest(QPlaceSearchRequest &&other)

Crée par « move » une instance de ` QPlaceSearchRequest`.

[noexcept] QPlaceSearchRequest::~QPlaceSearchRequest()

Supprime l'objet de requête.

QList<QPlaceCategory> QPlaceSearchRequest::categories() const

Renvoie les catégories à utiliser dans la requête de recherche. Il suffit qu'un lieu appartienne à l'une de ces catégories pour être considéré comme correspondant à la requête.

Voir également setCategories().

void QPlaceSearchRequest::clear()

Efface la requête de recherche.

int QPlaceSearchRequest::limit() const

Renvoie le nombre maximal de résultats de recherche à récupérer.

Une valeur négative pour « limit » signifie que ce paramètre n'est pas défini. Il appartient au fournisseur du backend de choisir un nombre approprié de résultats à renvoyer. La limite par défaut est -1.

Voir également setLimit().

QString QPlaceSearchRequest::recommendationId() const

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

Voir également setRecommendationId().

QPlaceSearchRequest::RelevanceHint QPlaceSearchRequest::relevanceHint() const

Renvoie l'indicateur de pertinence de la requête. Cet indicateur est fourni au fournisseur afin de l'aider à établir le classement des résultats, sans toutefois l'imposer. Par exemple, fournir un indicateur de distance peut attribuer un meilleur classement aux 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 recherche. La zone de recherche par défaut est une valeur non valide de type QGeoShape, ce qui indique 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 requête de recherche de lieu. Le contexte de recherche est généralement défini dans le cadre d'une requête de recherche de lieu ( proposed search results).

Voir également setSearchContext().

QString QPlaceSearchRequest::searchTerm() const

Renvoie le terme recherché.

Voir aussi setSearchTerm().

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

Configure la requête de recherche pour effectuer une recherche dans la liste des categories fournie. Tous les lieux renvoyés lors de la recherche correspondront à au moins l'un des categories.

Voir également categories() et setCategory().

void QPlaceSearchRequest::setCategory(const QPlaceCategory &category)

Définit la requête de recherche pour effectuer une recherche à partir d’un seul category

Voir aussi setCategories().

void QPlaceSearchRequest::setLimit(int limit)

Définissez le nombre maximal de résultats de recherche à afficher sur limit.

Voir également limit().

void QPlaceSearchRequest::setRecommendationId(const QString &placeId)

Définit l'placeId qui sera utilisé pour rechercher des recommandations.

Voir aussi recommendationId().

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

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

Voir aussi relevanceHint().

void QPlaceSearchRequest::setSearchArea(const QGeoShape &area)

Configure la requête de recherche pour qu'elle porte sur le site area.

Voir également searchArea().

void QPlaceSearchRequest::setSearchContext(const QVariant &context)

Définit le contexte de recherche sur context.

Le contexte de recherche est utilisé par les backends pour stocker des informations supplémentaires liées à la requête de recherche. D’autres champs pertinents doivent également être renseignés. 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 des informations supplémentaires qui ne sont pas directement accessibles via l’API Qt Location.

Le contexte de recherche peut être de n’importe quel type pouvant être stocké dans un 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 l'term s de recherche.

Voir également searchTerm().

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

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

Voir aussi visibilityScope().

QLocation::VisibilityScope QPlaceSearchRequest::visibilityScope() const

Renvoie la portée de visibilité utilisée lors de la recherche de lieux. La valeur par défaut est « QLocation::UnspecifiedVisibility », ce qui signifie qu'aucune portée n'a été explicitement attribuée. La recherche peut renvoyer des lieux de n'importe quelle portée.

Voir également setVisibilityScope().

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

Attribue la variable ` other ` à cette requête de recherche et renvoie une référence à celle-ci.