PlaceSearchModel QML Type

이 속성에는 검색할 때 사용할 카테고리 목록이 저장됩니다. 반환되는 검색 결과는 카테고리 중 하나 이상과 일치하는 장소에 대한 것입니다.

이 속성은 모델에 포함된 결과의 수를 보유합니다.

백엔드에서 사용할 수 있는 총 검색 결과 수는 참조하지 않습니다. 총 검색 결과 수는 현재 API에서 지원되지 않습니다.

이 속성에는 검색 결과 장소가 favoritesPlugin 에서 즐겨찾기와 일치하는 방법을 지정하는 데 사용되는 매개변수 세트가 있습니다.

기본적으로 매개변수 맵은 비어 있으며 즐겨찾기 플러그인이 대체 식별자를 통해 일치한다는 것을 의미합니다. 일반적으로 애플리케이션 개발자는 이 속성을 설정할 필요가 없습니다.

즐겨찾기 플러그인이 대체 식별자를 통한 매칭을 지원하지 않는 경우에는 플러그인 설명서를 참조하여 설정할 키-값 매개변수를 정확히 확인해야 합니다.

이 속성은 즐겨찾기를 검색하는 데 사용되는 Plugin 을 보유합니다. 검색에서 즐겨찾기를 상호 참조하거나 즐겨찾기 플러그인에서 일치시킬 수 있는 모든 장소는 즐겨찾기 플러그인에서 favorite 속성이 해당 Place 으로 설정됩니다.

즐겨찾기가 설정되지 않은 경우 결과에서 장소의 favorite 속성은 항상 null이 됩니다.

Favorites도 참조하세요 .

이 속성은 페이징이 PlaceSearchModel 에 영향을 미치는 방식을 제어합니다. 참이면 previousPage 또는 nextPage 을 호출해도 모델이 재설정되지 않고 대신 새 결과가 모델에 추가됩니다. 기본값은 false입니다.

이 속성은 QtLocation 5.12에 도입되었습니다.

이 속성은 반환될 항목 수의 제한을 보유합니다.

이 속성은 사용 가능한 검색 결과의 추가 페이지가 하나 이상 있는지 여부를 보유합니다.

nextPage()도 참조하세요 .

이 속성은 검색을 수행하는 데 사용되는 Plugin 을 보유합니다.

이 속성은 사용 가능한 검색 결과의 이전 페이지가 하나 이상 있는지 여부를 보유합니다.

previousPage()도 참조하세요 .

이 속성은 유사한 장소에 대한 추천을 찾는 데 사용할 placeId를 보유합니다.

이 속성은 검색 쿼리에 사용된 관련성 힌트를 보유합니다. 힌트는 제공자에게 제공되지만 결과 순위를 결정하지는 않습니다. 예를 들어 거리 힌트는 가까운 곳에 더 높은 순위를 부여할 수 있지만 반드시 거리에 따라 결과가 엄격하게 정렬되는 것을 의미하지는 않습니다. 공급자는 힌트를 완전히 무시할 수도 있습니다.

이 속성은 검색 영역을 보유합니다. 모델에서 반환되는 검색 결과는 검색 영역 내에 있습니다.

이 속성이 geocircle 로 설정된 경우 radius 속성을 설정하지 않을 수 있으며, 이 경우 Plugin 에서 검색에 적합한 반경을 선택합니다.

검색 영역 지정에 대한 지원은 plugin 백엔드 구현에 따라 다를 수 있습니다. 예를 들어 일부는 검색 센터만 지원하는 반면 다른 일부는 지리적 사각형만 지원할 수 있습니다.

이 속성은 쿼리에 사용되는 검색어를 보유합니다. 검색어는 자유 형식의 텍스트 문자열입니다.

이 속성은 모델의 상태를 보유합니다. 다음 중 하나 일 수 있습니다:

이 속성은 검색할 장소의 공개 범위를 보유합니다. 지정된 공개 범위를 가진 장소만 검색 결과에 반환됩니다.

공개 범위는 다음 중 하나일 수 있습니다:

진행 중인 검색 작업을 즉시 취소하고 모델 상태를 PlaceSearchModel.Ready로 설정합니다. 모델은 작업을 시작하기 전의 모든 검색 결과를 유지합니다.

작업이 진행 중이 아닌 경우 취소()를 호출해도 아무런 효과가 없습니다.

update() 및 status 을참조하세요 .

지정된 행 index 에서 주어진 role 에 대한 데이터를 반환합니다.

이 읽기 전용 속성은 최신 장소 검색 모델 오류의 텍스트 표시를 보유합니다. 오류가 발생하지 않았거나 모델이 지워진 경우 빈 문자열이 반환됩니다.

연관된 텍스트 표현이 없는 오류가 발생한 경우에도 빈 문자열이 반환될 수 있습니다.

검색 결과의 다음 페이지를 표시하도록 모델을 업데이트합니다. 다음 페이지가 없는 경우 이 메서드는 아무 작업도 수행하지 않습니다.

검색 결과의 이전 페이지를 표시하도록 모델을 업데이트합니다. 이전 페이지가 없는 경우 이 메서드는 아무 작업도 수행하지 않습니다.

모델을 초기화합니다. 모든 검색 결과가 지워지고 미결 요청이 중단되며 가능한 오류가 지워집니다. 모델 상태는 PlaceSearchModel.Null로 설정됩니다.

제공된 쿼리 매개변수를 기반으로 모델을 업데이트합니다. 유형 속성에 지정된 검색 매개변수와 일치하는 장소 목록으로 모델이 채워집니다. 검색 기준은 searchTerm, categories, searchArea, limit 과 같은 속성을 설정하여 지정합니다. 이러한 속성에 대한 지원은 plugin 에 따라 달라질 수 있습니다. update() 그런 다음 기준 집합을 plugin 에 제출하여 처리합니다.

모델이 업데이트되는 동안 모델의 status 은 PlaceSearchModel.Loading 으로 설정됩니다. 모델이 성공적으로 업데이트되면 status 은 PlaceSearchModel.Ready 으로 설정되며, 성공적으로 완료되지 않으면 status 은 PlaceSearchModel.Error 으로 설정되고 모델이 지워집니다.

PlaceSearchModel {
    id: model
    plugin: backendPlugin
    searchArea: QtPositioning.circle(QtPositioning.coordinate(10, 10))
    ...
}

MouseArea {
    ...
    onClicked: {
        model.searchTerm = "pizza";
        model.categories = null;  //not searching by any category
        model.searchArea.center.latitude = -27.5;
        model.searchArea.center.longitude = 153;
        model.update();
    }
}

cancel() 및 status 을참조하세요 .

인덱스 proposedSearchIndex 에서 ProposedSearchResult를 기반으로 모델을 업데이트합니다. 모델은 제안된 검색과 일치하는 장소 목록으로 채워집니다. 모델 상태가 PlaceSearchModel.로드 중으로 설정됩니다. 모델이 성공적으로 업데이트되면 상태는 PlaceSearchModel.준비됨으로 설정됩니다. 오류가 발생하면 상태는 PlaceSearchModel.Error로 설정되고 모델이 지워집니다.

proposedSearchIndex 이 ProposedSearchResult를 참조하지 않는 경우 이 메서드는 아무 작업도 수행하지 않습니다.