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 Mitgliedsfunktionen

QPlaceSearchRequest::QPlaceSearchRequest()

Standardkonstruktor. Erstellt ein neues Request-Objekt.

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

Erstellt eine Kopie von „ other “.

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

Erstellt eine Instanz von „ QPlaceSearchRequest “ mithilfe von „move“.

[noexcept] QPlaceSearchRequest::~QPlaceSearchRequest()

Löscht das Anfrageobjekt.

QList<QPlaceCategory> QPlaceSearchRequest::categories() const

Gibt die Kategorien zurück, die in der Suchanfrage verwendet werden sollen. Orte müssen nur einer der Kategorien angehören, um von der Anfrage als Treffer gewertet zu werden.

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 dieser nicht definiert ist. Es bleibt dem Backend-Anbieter überlassen, eine geeignete Anzahl von Ergebnissen zur Rückgabe auszuwählen. Der Standardwert für „limit“ ist -1.

Siehe auch „ setLimit()“.

QString QPlaceSearchRequest::recommendationId() const

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

Siehe auch „ setRecommendationId()“.

QPlaceSearchRequest::RelevanceHint QPlaceSearchRequest::relevanceHint() const

Gibt den Relevanzhinweis der Anfrage zurück. Der Hinweis wird dem Anbieter zur Unterstützung bereitgestellt, dient jedoch nicht dazu, die Rangfolge der Ergebnisse vorzuschreiben. Wenn beispielsweise ein Entfernungshinweis angegeben wird, erhalten Orte in näherer Entfernung möglicherweise eine höhere Rangfolge, was jedoch nicht zwangsläufig bedeutet, dass die Ergebnisse streng nach der Entfernung sortiert werden.

Siehe auch setRelevanceHint().

QGeoShape QPlaceSearchRequest::searchArea() const

Gibt den Suchbereich zurück, der zur Eingrenzung der Suchergebnisse verwendet wird. Der Standard-Suchbereich ist ein ungültiges QGeoShape, was darauf hinweist, dass kein spezifischer Suchbereich definiert ist.

Siehe auch setSearchArea().

QVariant QPlaceSearchRequest::searchContext() const

Gibt einen backend-spezifischen zusätzlichen Suchkontext zurück, der mit dieser Ortssuchanfrage verknüpft ist. Der Suchkontext wird in der Regel im Rahmen eines „ proposed search results “ festgelegt.

Siehe auch setSearchContext().

QString QPlaceSearchRequest::searchTerm() const

Gibt den Suchbegriff zurück.

Siehe auch „ setSearchTerm()“.

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

Legt die Suchanfrage so fest, dass in der Liste der angegebenen categories gesucht wird. Alle bei der Suche zurückgegebenen Orte entsprechen mindestens einem der categories.

Siehe auch categories() und setCategory().

void QPlaceSearchRequest::setCategory(const QPlaceCategory &category)

Legt die Suchanfrage so fest, dass nach einem einzelnen category

Siehe auch setCategories().

void QPlaceSearchRequest::setLimit(int limit)

Legen Sie die maximale Anzahl der anzuzeigenden Suchergebnisse unter limit fest.

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)

Legt die Suchanfrage so fest, 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ätzliche Informationen zum Suchkontext im Zusammenhang mit der Suchanfrage zu speichern. Andere relevante Felder sollten ebenfalls ausgefüllt werden. Wenn der Suchkontext beispielsweise eine Textsuche kodiert, sollte der Suchbegriff ebenfalls mit ` setSearchTerm()` festgelegt werden. Der Suchkontext ermöglicht es, zusätzliche Informationen zum Suchkontext zu speichern, auf die über die ` Qt Location `-API nicht direkt zugegriffen werden kann.

Der Suchkontext kann einen beliebigen Typ haben, der in einem ` QVariant` gespeichert werden kann. Der Wert des Suchkontexts ist nicht für die direkte Verwendung durch Anwendungen vorgesehen.

Siehe auch ` searchContext()`.

void QPlaceSearchRequest::setSearchTerm(const QString &term)

Legt den Such term fest.

Siehe auch searchTerm().

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

Legt die Sichtbarkeit v 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 aus beliebigen Bereichen zurückgegeben werden.

Siehe auch setVisibilityScope().

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

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