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

Dokumentation der Mitgliederfunktionen

QPlaceSearchRequest::QPlaceSearchRequest()

Standard-Konstruktor. Konstruiert ein neues Anfrageobjekt.

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

Konstruiert eine Kopie von other.

[noexcept] QPlaceSearchRequest::~QPlaceSearchRequest()

Zerstört das Anfrageobjekt.

QList<QPlaceCategory> QPlaceSearchRequest::categories() const

Gibt die Kategorien zurück, die in der Suchanfrage verwendet werden sollen. Die Orte müssen nur zu einer der Kategorien gehören, damit die Anfrage als übereinstimmend betrachtet wird.

Siehe auch setCategories().

void QPlaceSearchRequest::clear()

Löscht die Suchanfrage.

int QPlaceSearchRequest::limit() const

Gibt die maximale Anzahl der abzurufenden Suchergebnisse zurück.

Ein negativer Wert für limit bedeutet, dass er nicht definiert ist. Es bleibt dem Backend-Anbieter überlassen, eine angemessene Anzahl von Ergebnissen auszuwählen, die zurückgegeben werden sollen. Der Standardwert für limit ist -1.

Siehe auch setLimit().

QString QPlaceSearchRequest::recommendationId() const

Gibt die Ortskennung zurück, die für die Suche nach Empfehlungen für ähnliche Orte verwendet wird.

Siehe auch setRecommendationId().

QPlaceSearchRequest::RelevanceHint QPlaceSearchRequest::relevanceHint() const

Gibt den Relevanz-Hinweis der Anfrage zurück. Der Hinweis wird dem Anbieter gegeben, um die Rangfolge der Ergebnisse zu unterstützen, aber nicht zu diktieren. Ein Hinweis auf die Entfernung kann beispielsweise dazu führen, dass näher gelegene Orte eine höhere Rangfolge erhalten, bedeutet aber nicht unbedingt, dass die Ergebnisse streng nach der Entfernung geordnet werden.

Siehe auch setRelevanceHint().

QGeoShape QPlaceSearchRequest::searchArea() const

Gibt den Suchbereich zurück, der zur Einschränkung der Suchergebnisse verwendet wird. Der Standardsuchbereich ist ein ungültiger QGeoShape, der anzeigt, dass kein bestimmter Suchbereich definiert ist.

Siehe auch setSearchArea().

QVariant QPlaceSearchRequest::searchContext() const

Gibt den Backend-spezifischen zusätzlichen Suchkontext zurück, der mit dieser Ortssuchanfrage verbunden ist. Der Suchkontext wird normalerweise als Teil einer proposed search results gesetzt.

Siehe auch setSearchContext().

QString QPlaceSearchRequest::searchTerm() const

Gibt den Suchbegriff zurück.

Siehe auch setSearchTerm().

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

Legt fest, dass die Suchanfrage in der Liste der angegebenen categories gesucht wird. Alle Orte, die bei der Suche zurückgegeben werden, müssen mit mindestens einem der categories übereinstimmen.

Siehe auch categories() und setCategory().

void QPlaceSearchRequest::setCategory(const QPlaceCategory &category)

Setzt die Suchanfrage auf die Suche nach einem einzelnen category

Siehe auch setCategories().

void QPlaceSearchRequest::setLimit(int limit)

Setzen Sie die maximale Anzahl der abzurufenden Suchergebnisse auf limit.

Siehe auch limit().

void QPlaceSearchRequest::setRecommendationId(const QString &placeId)

Legt die placeId fest, die für die Suche nach Empfehlungen verwendet wird.

Siehe auch recommendationId().

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

Legt die Relevanz hint fest, die bei der Suche nach einem Ort verwendet werden soll.

Siehe auch relevanceHint().

void QPlaceSearchRequest::setSearchArea(const QGeoShape &area)

Stellt die Suchanfrage so ein, dass innerhalb der angegebenen area gesucht wird.

Siehe auch searchArea().

void QPlaceSearchRequest::setSearchContext(const QVariant &context)

Setzt den Suchkontext auf context.

Der Suchkontext wird von Backends verwendet, um zusätzlichen Suchkontext im Zusammenhang mit der Suchanfrage zu speichern. Andere relevante Felder sollten ebenfalls ausgefüllt werden. Wenn der Suchkontext zum Beispiel eine Textsuche kodiert, sollte der Suchbegriff auch mit setSearchTerm() angegeben werden. Der Suchkontext ermöglicht die Speicherung von zusätzlichem Suchkontext, der nicht direkt über die Qt Location API zugänglich ist.

Der Suchkontext kann von jedem Typ sein, der in einer QVariant gespeichert werden kann. Der Wert des Suchkontextes ist nicht zur direkten Verwendung durch Anwendungen gedacht.

Siehe auch searchContext().

void QPlaceSearchRequest::setSearchTerm(const QString &term)

Legt die Suche term fest.

Siehe auch searchTerm().

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

Legt die Sichtbarkeit scope fest, die bei der Suche nach Orten verwendet wird.

Siehe auch visibilityScope().

QLocation::VisibilityScope QPlaceSearchRequest::visibilityScope() const

Gibt den Sichtbarkeitsbereich zurück, der bei der Suche nach Orten verwendet wird. Der Standardwert ist QLocation::UnspecifiedVisibility, was bedeutet, dass kein expliziter Bereich zugewiesen wurde. Bei der Suche können Orte mit beliebigem Geltungsbereich zurückgegeben werden.

Siehe auch setVisibilityScope().

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

Weist other dieser Suchanfrage zu und gibt einen Verweis auf diese Suchanfrage zurück.