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

Documentación de las funciones

QPlaceSearchRequest::QPlaceSearchRequest()

Constructor por defecto. Construye un nuevo objeto de petición.

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

Construye una copia de other.

[noexcept] QPlaceSearchRequest::~QPlaceSearchRequest()

Destruye el objeto de solicitud.

QList<QPlaceCategory> QPlaceSearchRequest::categories() const

Devuelve las categorías que se utilizarán en la petición de búsqueda. Los lugares sólo tienen que pertenecer a una de las categorías para que la petición los considere coincidentes.

Véase también setCategories().

void QPlaceSearchRequest::clear()

Borra la petición de búsqueda.

int QPlaceSearchRequest::limit() const

Devuelve el número máximo de resultados de búsqueda a recuperar.

Un valor negativo para limit significa que no está definido. Se deja al proveedor de backend elegir un número apropiado de resultados a devolver. El límite por defecto es -1.

Véase también setLimit().

QString QPlaceSearchRequest::recommendationId() const

Devuelve el id del lugar que se utilizará para buscar recomendaciones de lugares similares.

Véase también setRecommendationId().

QPlaceSearchRequest::RelevanceHint QPlaceSearchRequest::relevanceHint() const

Devuelve la pista de relevancia de la solicitud. La sugerencia se da al proveedor para ayudar, pero no para dictar la clasificación de los resultados. Por ejemplo, si se indica la distancia, es posible que los lugares más cercanos tengan una clasificación más alta, pero esto no significa necesariamente que los resultados se ordenen estrictamente en función de la distancia.

Véase también setRelevanceHint().

QGeoShape QPlaceSearchRequest::searchArea() const

Devuelve el área de búsqueda que se utilizará para limitar los resultados de la búsqueda. El área de búsqueda por defecto es un QGeoShape no válido, lo que indica que no se ha definido un área de búsqueda específica.

Véase también setSearchArea().

QVariant QPlaceSearchRequest::searchContext() const

Devuelve el contexto de búsqueda adicional específico del backend asociado a esta solicitud de búsqueda de lugar. El contexto de búsqueda suele establecerse como parte de proposed search results.

Véase también setSearchContext().

QString QPlaceSearchRequest::searchTerm() const

Devuelve el término buscado.

Véase también setSearchTerm().

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

Establece la petición de búsqueda a partir de la lista de categories. Cualquier lugar devuelto durante la búsqueda coincidirá al menos con uno de los categories.

Véase también categories() y setCategory().

void QPlaceSearchRequest::setCategory(const QPlaceCategory &category)

Establece la petición de búsqueda para buscar por una sola category

Véase también setCategories().

void QPlaceSearchRequest::setLimit(int limit)

Establezca el número máximo de resultados de búsqueda a recuperar en limit.

Véase también limit().

void QPlaceSearchRequest::setRecommendationId(const QString &placeId)

Establece la dirección placeId que se utilizará para buscar recomendaciones.

Véase también recommendationId().

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

Establece la relevancia hint que se utilizará al buscar un lugar.

Véase también relevanceHint().

void QPlaceSearchRequest::setSearchArea(const QGeoShape &area)

Establece que la petición de búsqueda se realice en la dirección area.

Véase también searchArea().

void QPlaceSearchRequest::setSearchContext(const QVariant &context)

Establece el contexto de búsqueda en context.

El contexto de búsqueda es utilizado por los backends para almacenar contexto de búsqueda adicional relacionado con la solicitud de búsqueda. También deben rellenarse otros campos relevantes. Por ejemplo, si el contexto de búsqueda codifica una búsqueda de texto, el término de búsqueda también debe establecerse con setSearchTerm(). El contexto de búsqueda permite mantener un contexto de búsqueda adicional al que no se puede acceder directamente a través de la API Qt Location.

El contexto de búsqueda puede ser de cualquier tipo almacenable en QVariant. El valor del contexto de búsqueda no está pensado para ser utilizado directamente por las aplicaciones.

Véase también searchContext().

void QPlaceSearchRequest::setSearchTerm(const QString &term)

Establece la búsqueda term.

Véase también searchTerm().

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

Establece la visibilidad scope utilizada al buscar lugares.

Véase también visibilityScope().

QLocation::VisibilityScope QPlaceSearchRequest::visibilityScope() const

Devuelve el ámbito de visibilidad utilizado al buscar lugares. El valor predeterminado es QLocation::UnspecifiedVisibility, lo que significa que no se ha asignado ningún ámbito explícito. Se pueden devolver lugares de cualquier ámbito durante la búsqueda.

Véase también setVisibilityScope().

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

Asigna other a esta petición de búsqueda y devuelve una referencia a esta petición de búsqueda.