Place QML Type

장소 유형은 관심 위치인 위치를 나타냅니다. 더 보기...

• 상속된 구성원을 포함한 모든 구성원 목록

속성

• attribution : string
• categories : list<Category>
• contactDetails : ContactDetails
• detailsFetched : bool
• editorialModel : EditorialModel
• extendedAttributes : ExtendedAttributes
• favorite : Place
• icon : Icon
• imageModel : ImageModel
• location : QtPositioning::Location
• name : string
• placeId : string
• plugin : Plugin
• primaryEmail : string
• primaryFax : string
• primaryPhone : string
• primaryWebsite : string
• ratings : Ratings
• reviewModel : ReviewModel
• status : enumeration
• supplier : Supplier
• visibility : enumeration

방법

• void copyFrom(Place original)
• string errorString()
• void getDetails()
• void initializeFavorite(Plugin destinationPlugin)
• void remove()
• void save()

상세 설명

장소 유형은 해당 위치를 설명하는 추가 메타데이터와 함께 실제 위치를 나타냅니다. 위치의 위치를 설명하는 데 사용되는 Location, Address, coordinate 유형과 대조됩니다. 장소의 기본 속성은 name 및 location 입니다.

장소 개체는 일반적으로 검색 모델에서 가져오며 일반적으로 기본 속성만 설정됩니다. detailsFetched 속성은 Plugin 에서 추가 속성 값을 가져와야 하는지 테스트하는 데 사용할 수 있습니다. getDetails() 메서드를 호출하여 이 작업을 수행할 수 있습니다. 가져오기 작업의 진행 상황은 status 속성을 사용하여 모니터링할 수 있으며, 이 속성은 세부 정보를 가져오면 Place.Fetching으로 설정됩니다.

장소 유형에는 위치에 대한 정보를 담고 있는 많은 속성이 있습니다. 장소에 연락하는 방법에 대한 자세한 내용은 contactDetails 속성에서 확인할 수 있습니다. 기본 phone, fax, email 및 website 을 얻기 위한 편의 속성도 사용할 수 있습니다.

각 장소에는 0개 이상의 categories 이 할당됩니다. 카테고리는 일반적으로 레스토랑이나 호텔 등 특정 종류의 장소를 검색할 때 사용됩니다. 일부 장소에는 장소의 품질을 나타내는 ratings 개체가 있습니다.

장소 메타데이터는 장소 세부정보를 볼 때 사용자에게 attribution 메시지를 표시하도록 요구할 수 있는 supplier 에 의해 제공됩니다.

장소에는 맵에서 장소를 나타내거나 뷰에서 델리게이트를 장식하는 데 사용할 수 있는 관련 icon 이 있습니다.

장소에는 추가적인 리치 콘텐츠가 연결될 수 있습니다. 현재 지원되는 리치 콘텐츠에는 편집 설명, 리뷰 및 이미지가 포함됩니다. 이러한 콘텐츠는 콘텐츠 검색을 위한 모델 집합으로 노출됩니다. 장소에 대한 에디토리얼 설명은 editorialModel 속성에서 확인할 수 있습니다. 장소의 리뷰는 reviewModel 속성에서 확인할 수 있습니다. 장소 사진 갤러리는 imageModel 속성을 사용하여 액세스할 수 있습니다.

장소에는 공식 API에서 다루지 않는 추가 속성이 있을 수 있습니다. extendedAttributes 속성을 통해 이러한 속성에 액세스할 수 있습니다. 사용 가능한 확장 속성의 유형은 각 Plugin 에 따라 다릅니다.

장소는 거의 항상 plugin 에 연결됩니다. plugin 속성을 설정해야 save(), remove() 또는 getDetails()를 호출할 수 있습니다. reviewModel , imageModel 및 editorialModel 는 plugin 속성이 설정된 경우에만 유효합니다.

장소 저장하기

Plugin 에서 지원하는 경우 장소 유형을 사용하여 장소를 저장할 수 있습니다. 먼저 새 장소를 만들고 해당 속성을 설정합니다:

Place {
    id: myPlace
    plugin: myPlugin

    name: "Brisbane Technology Park"
    location: Location {
        address: Address {
            street: "53 Brandl Street"
            city: "Eight Mile Plains"
            postalCode: "4113"
            country: "Australia"
        }
        coordinate {
            latitude: -27.579646
            longitude: 153.100308
        }
    }

    visibility: Place.PrivateVisibility
}

그런 다음 save() 메서드를 호출합니다:

    myPlace.save();

status 속성은 저장에 성공하면 Place.Saving으로, 저장에 실패하면 Place.Ready로, 오류가 발생하면 Place.Error로 변경됩니다.

placeId 속성이 설정되어 있으면 백엔드에서 기존 장소를 업데이트하고 그렇지 않으면 새 장소를 만듭니다. 성공하면 placeId 속성이 새로 저장된 장소의 식별자로 업데이트됩니다.

주의

장소 API는 현재 core 세부 정보만 저장하도록 설계되었습니다. 이미지 및 리뷰와 같은 리치 콘텐츠나 공급업체 및 평점과 같은 세부 정보를 저장하는 것은 지원되지 않는 사용 사례입니다. 일반적으로 관리자는 저장 시 이러한 필드를 무시하고 해당 필드를 채우면 경고 메시지를 표시할 수 있습니다.

장소 API는 다음과 같은 핵심 세부 정보 저장만 지원합니다:

• 이름
• 장소 ID
• 위치
• 연락처 세부정보
• 아이콘
• 카테고리(장소를 설명하는 태그와 같은 이름)
• 공개 범위

제공업체가 이 중 일부만 지원할 수도 있습니다. 자세한 내용은 플러그인 설명서를 참조하세요.

평점, 확장 속성, 이미지, 리뷰, 사설 및 공급업체와 같은 속성의 저장은 장소 API에서 명시적으로 지원되지 않습니다.

플러그인 간 저장

플러그인 간에 장소를 저장할 때 몇 가지 주의해야 할 사항이 있습니다. 아이디, 카테고리, 아이콘과 같은 장소의 일부 필드는 플러그인별 엔티티입니다. 예를 들어 한 관리자의 카테고리가 다른 관리자에서는 인식되지 않을 수 있습니다. 따라서 한 플러그인에서 다른 플러그인으로 장소를 직접 저장하는 것은 불가능합니다.

일반적으로 플러그인 간 저장은 즐겨찾기 섹션에 설명된 대로 favorites 에 저장하는 것으로 처리하는 것이 좋습니다. 그러나 새 장소를 만들고 (대상) 플러그인을 설정한 다음 copyFrom() 방법을 사용하여 원래 장소의 세부 정보를 복사하는 다른 방법도 있습니다. copyFrom ()를 사용하면 대상 플러그인에서 지원하는 데이터만 복사되며, 장소 식별자와 같은 플러그인별 데이터는 복사되지 않습니다. 복사가 완료되면 장소는 저장하기에 적합한 상태가 됩니다.

다음 스니펫은 copyFrom 메서드를 사용하여 다른 플러그인에 장소를 저장하는 예제입니다:

var place = Qt.createQmlObject('import QtLocation; Place { }', parent);
place.plugin = destinationPlugin;
place.copyFrom(originalPlace);
place.save();

장소 제거하기

장소를 제거하려면 유효한 placeId 속성을 가진 장소 개체가 있는지 확인하고 해당 개체의 remove() 메서드를 호출합니다. status 속성은 저장에 성공하면 Place.Removing으로 변경되고, 저장에 실패하면 Place.Ready로, 오류가 발생하면 Place.Error로 변경됩니다.

즐겨찾기

장소 API는 즐겨찾기의 개념을 지원합니다. 즐겨찾기는 일반적으로 두 개의 플러그인을 사용하여 구현되며, 첫 번째 플러그인은 일반적으로 장소의 읽기 전용 소스(출처 플러그인)이고 두 번째 읽기/쓰기 플러그인(목적지 플러그인)은 출처의 장소를 즐겨찾기로 저장하는 데 사용됩니다.

각 장소에는 대상 플러그인의 해당 장소를 포함하기 위한 즐겨찾기 속성이 있습니다(장소 자체는 출처 플러그인에서 소싱됨). 원래 장소와 즐겨찾기의 인스턴스를 모두 사용할 수 있으므로 개발자는 사용자에게 표시할 속성을 선택할 수 있습니다. 예를 들어 즐겨찾기에 원래 이름 대신 수정된 이름이 표시될 수 있습니다.

Text { text: place.favorite ? place.favorite.name : place.name }

다음은 새로운 즐겨찾기 인스턴스를 저장하는 방법을 보여줍니다. 즐겨찾기 인스턴스를 생성/초기화하기 위해 호출한 다음 인스턴스가 저장됩니다.

place.initializeFavorite(destinationPlugin);
//if necessary customizations to the favorite can be made here.
//...
place.favorite.save();

다음은 즐겨찾기를 삭제하는 방법을 보여줍니다:

place.favorite.remove();
    ...
//check successful removal of the favorite by monitoring its status.
//once that is done we can assign null to the favorite
place.favorite = null;

PlaceSearchModel 에는 즐겨찾는 플러그인 속성이 있습니다. 이 속성이 설정되어 있으면 검색 중에 발견되는 모든 장소가 즐겨찾기에 해당하는 장소가 있는지 확인하기 위해 즐겨찾기에 대해 favoritesPlugin을 확인합니다. 그렇다면 해당 장소의 즐겨찾기 속성이 설정되고, 그렇지 않으면 즐겨찾기 속성이 null로 유지됩니다.

PlaceSearchModel 을참조하세요 .

속성 문서

    place.plugin = myPlugin;
    place.placeId = "known-place-id";
    place.getDetails();

    var primaryEmail;
    if (place.contactDetails["email"].length > 0)
        primaryEmail = place.contactDetails["email"][0].value;

    var primaryFax;
    if (place.contactDetails["fax"].length > 0)
        primaryFax = place.contactDetails["fax"][0].value;

    var primaryPhone;
    if (place.contactDetails["phone"].length > 0)
        primaryPhone = place.contactDetails["phone"][0].value;

    var primaryWebsite;
    if (place.contactDetails["website"].length > 0)
        primaryWebsite = place.contactDetails["website"][0].value;

place.statusChanged.connect(statusChangedHandler);
    ...
function statusChangedHandler() {
    if (statusChangedHandler.prevStatus === Place.Saving) {
        switch (place.status) {
        case Place.Ready:
            console.log('Save successful');
            break;
        case Place.Error:
            console.log('Save failed');
            break;
        default:
            break;
        }
    }
    statusChangedHandler.prevStatus = place.status;
}

메서드 문서