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

멤버 기능 문서

QPlaceSearchRequest::QPlaceSearchRequest()

기본 생성자. 새 요청 객체를 생성합니다.

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

other 의 복사본을 생성합니다.

[noexcept] QPlaceSearchRequest::~QPlaceSearchRequest()

요청 객체를 삭제합니다.

QList<QPlaceCategory> QPlaceSearchRequest::categories() const

검색 요청에 사용할 카테고리를 반환합니다. 장소가 카테고리 중 하나에 속해야만 요청에서 일치하는 것으로 간주됩니다.

setCategories()도 참조하세요 .

void QPlaceSearchRequest::clear()

검색 요청을 지웁니다.

int QPlaceSearchRequest::limit() const

검색할 수 있는 최대 검색 결과 수를 반환합니다.

제한 값이 음수이면 정의되지 않았음을 의미합니다. 반환할 적절한 결과 수를 선택하는 것은 백엔드 제공업체의 몫입니다. 기본 제한은 -1입니다.

setLimit()도 참조하세요 .

QString QPlaceSearchRequest::recommendationId() const

비슷한 장소의 추천을 검색하는 데 사용할 장소 ID를 반환합니다.

setRecommendationId()도 참조하세요 .

QPlaceSearchRequest::RelevanceHint QPlaceSearchRequest::relevanceHint() const

요청의 관련성 힌트를 반환합니다. 힌트는 제공자에게 도움을 주기 위해 제공되지만 결과 순위를 결정하지는 않습니다. 예를 들어 거리 힌트를 제공하면 가까운 곳에 더 높은 순위가 부여될 수 있지만 반드시 거리에 따라 결과가 엄격하게 정렬되는 것은 아닙니다.

setRelevanceHint()도 참조하세요 .

QGeoShape QPlaceSearchRequest::searchArea() const

검색 결과를 제한하는 데 사용할 검색 영역을 반환합니다. 기본 검색 영역은 특정 검색 영역이 정의되어 있지 않음을 나타내는 잘못된 QGeoShape 입니다.

setSearchArea()도 참조하세요 .

QVariant QPlaceSearchRequest::searchContext() const

이 장소 검색 요청과 관련된 백엔드 특정 추가 검색 컨텍스트를 반환합니다. 검색 컨텍스트는 일반적으로 proposed search results 의 일부로 설정됩니다.

setSearchContext()도 참조하세요 .

QString QPlaceSearchRequest::searchTerm() const

검색어를 반환합니다.

setSearchTerm()도 참조하세요 .

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

주어진 categories 목록에서 검색하도록 검색 요청을 설정합니다. 검색 중에 반환되는 모든 장소는 categories 중 하나 이상과 일치합니다.

categories() 및 setCategory()도 참조하세요 .

void QPlaceSearchRequest::setCategory(const QPlaceCategory &category)

검색 요청을 단일 검색어로 검색하도록 설정합니다. category

setCategories()도 참조하세요 .

void QPlaceSearchRequest::setLimit(int limit)

검색할 최대 검색 결과 수를 limit 으로 설정합니다.

limit()도 참조하세요 .

void QPlaceSearchRequest::setRecommendationId(const QString &placeId)

권장 사항을 검색하는 데 사용할 placeId 을 설정합니다.

recommendationId()도 참조하세요 .

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

장소를 검색할 때 사용할 관련성 hint 을 설정합니다.

relevanceHint()도 참조하세요 .

void QPlaceSearchRequest::setSearchArea(const QGeoShape &area)

지정된 area 내에서 검색하도록 검색 요청을 설정합니다.

searchArea()도 참조하세요 .

void QPlaceSearchRequest::setSearchContext(const QVariant &context)

검색 컨텍스트를 context 로 설정합니다.

검색 컨텍스트는 백엔드에서 검색 요청과 관련된 추가 검색 컨텍스트를 저장하는 데 사용됩니다. 다른 관련 필드도 입력해야 합니다. 예를 들어 검색 컨텍스트가 텍스트 검색을 인코딩하는 경우 검색어 역시 setSearchTerm()로 설정해야 합니다. 검색 컨텍스트를 사용하면 Qt Location API를 통해 직접 액세스할 수 없는 추가 검색 컨텍스트를 유지할 수 있습니다.

검색 컨텍스트는 QVariant 에 저장할 수 있는 모든 유형이 될 수 있습니다. 검색 컨텍스트의 값은 애플리케이션에서 직접 사용하기 위한 것이 아닙니다.

searchContext()도 참조하세요 .

void QPlaceSearchRequest::setSearchTerm(const QString &term)

검색을 설정합니다 term.

searchTerm()도 참조하세요 .

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

장소를 검색할 때 사용되는 scope 가시성을 설정합니다.

visibilityScope()도 참조하세요 .

QLocation::VisibilityScope QPlaceSearchRequest::visibilityScope() const

장소를 검색할 때 사용되는 공개 범위를 반환합니다. 기본값은 명시적 범위가 지정되지 않았음을 의미하는 QLocation::UnspecifiedVisibility 입니다. 검색 중에 모든 범위의 장소가 반환될 수 있습니다.

setVisibilityScope()도 참조하세요 .

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

이 검색 요청에 other 을 할당하고 이 검색 요청에 대한 참조를 반환합니다.