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 의 복사본을 생성합니다.

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

QPlaceSearchRequest 의 인스턴스를 move-construct로 생성합니다.

[noexcept] QPlaceSearchRequest::~QPlaceSearchRequest()

요청 객체를 삭제합니다.

QList<QPlaceCategory> QPlaceSearchRequest::categories() const

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

setCategories()도 참조하십시오 .

void QPlaceSearchRequest::clear()

검색 요청을 지웁니다.

int QPlaceSearchRequest::limit() const

검색 결과에서 가져올 최대 개수를 반환합니다.

limit에 음수 값을 지정하면 이 매개변수는 정의되지 않은 것으로 간주됩니다. 반환할 적절한 결과 개수는 백엔드 제공자가 결정합니다. 기본 limit 값은 -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 를 할당하고, 이 검색 요청에 대한 참조를 반환합니다.