QPlace Class

QPlace 클래스는 장소에 대한 데이터 집합을 나타냅니다. 더 보기...

Header: #include <QPlace>
qmake: QT += location

공용 함수

QPlace()
QPlace(const QPlace &other)
~QPlace()
void appendContactDetail(const QString &contactType, const QPlaceContactDetail &detail)
QString attribution() const
QList<QPlaceCategory> categories() const
QList<QPlaceContactDetail> contactDetails(const QString &contactType) const
QStringList contactTypes() const
QPlaceContent::Collection content(QPlaceContent::Type type) const
bool detailsFetched() const
QPlaceAttribute extendedAttribute(const QString &attributeType) const
QStringList extendedAttributeTypes() const
QPlaceIcon icon() const
void insertContent(QPlaceContent::Type type, const QPlaceContent::Collection &content)
bool isEmpty() const
QGeoLocation location() const
QString name() const
QString placeId() const
QString primaryEmail() const
QString primaryFax() const
QString primaryPhone() const
QUrl primaryWebsite() const
QPlaceRatings ratings() const
void removeContactDetails(const QString &contactType)
void removeExtendedAttribute(const QString &attributeType)
void setAttribution(const QString &attribution)
void setCategories(const QList<QPlaceCategory> &categories)
void setCategory(const QPlaceCategory &category)
void setContactDetails(const QString &contactType, QList<QPlaceContactDetail> details)
void setContent(QPlaceContent::Type type, const QPlaceContent::Collection &content)
void setDetailsFetched(bool fetched)
void setExtendedAttribute(const QString &attributeType, const QPlaceAttribute &attribute)
void setIcon(const QPlaceIcon &icon)
void setLocation(const QGeoLocation &location)
void setName(const QString &name)
void setPlaceId(const QString &identifier)
void setRatings(const QPlaceRatings &rating)
void setSupplier(const QPlaceSupplier &supplier)
void setTotalContentCount(QPlaceContent::Type type, int totalCount)
void setVisibility(QLocation::Visibility visibility)
QPlaceSupplier supplier() const
int totalContentCount(QPlaceContent::Type type) const
QLocation::Visibility visibility() const
QPlace &operator=(const QPlace &other)

보호된 함수

QPlace(const QSharedDataPointer<QPlacePrivate> &dd)
bool operator!=(const QPlace &lhs, const QPlace &rhs)
bool operator==(const QPlace &lhs, const QPlace &rhs)

상세 설명

장소는 즐겨 찾는 레스토랑, 공원 또는 누군가의 집 등 관심 지점이 될 수 있습니다. QPlace 개체는 해당 장소에 대한 다양한 정보를 담는 컨테이너 역할을 함으로써 장소를 나타냅니다.

이 정보는 크게 두 가지 분류로 나눌 수 있습니다.

  • 세부 정보
  • 풍부한 콘텐츠

장소 세부정보는 이름, 위치, 연락처 정보 등 장소의 속성으로 구성됩니다. 검색 중에 장소가 반환되면 이러한 세부 정보가 채워집니다. 대역폭을 절약하기 위해 사용자가 관심이 있는 경우 장소별로 장소에 대한 추가 세부 정보를 검색할 수 있는 경우도 있습니다. QPlace::detailsFetched () 함수를 쿼리하여 사용 가능한 모든 세부 정보를 가져왔는지 확인할 수 있으며, 그렇지 않은 경우 QPlaceManager::getPlaceDetails()을 사용하여 검색할 수 있습니다. 검색 중에 정확히 어떤 세부 정보가 채워지고 어떤 세부 정보를 개별적으로 가져와야 하는지는 제공업체마다 다를 수 있습니다. 자세한 내용은 플러그인 설명서를 참조하세요.

장소의 리치 콘텐츠는 이미지, 리뷰, 사설 등의 항목으로 구성됩니다. 리치 콘텐츠 항목이 많을 수 있으므로 장소 세부정보와는 별도로 취급됩니다. QPlaceManager::getPlaceContent ()를 통해 페이징 방식으로 검색할 수 있습니다. 필요한 경우 콘텐츠가 편리한 컨테이너 역할을 할 수 있도록 플레이스에 할당될 수 있습니다.

연락처 정보

장소의 연락처 정보는 contact types 의 공통 집합을 기반으로 합니다. 장소의 모든 전화번호를 검색하려면 이렇게 하면 됩니다:

if (place.contactTypes().contains(QPlaceContactDetail::Phone)) { for(const QPlaceContactDetail &number: place.contactDetails(QPlaceContactDetail::Phone))        qDebug() << number.label() << ":" << number.value();
}

연락처 유형은 제공업체가 새로운 연락처 유형을 도입할 수 있도록 문자열 값으로 설계되었습니다.

편의를 위해 각 유형의 첫 번째 연락처 세부 정보 값을 반환하는 함수 집합이 있습니다.

확장 속성

장소에는 공식 API에서 다루지 않는 추가 속성이 있을 수 있습니다. 연락처 속성과 유사하게 attribute types 의 공통 집합을 기반으로 합니다. 확장 속성을 검색하려면 다음과 같이 하세요:

if (place.extendedAttributeTypes().contains(QPlaceAttribute::영업시간))    qDebug() << place.extendedAttribute(QPlaceAttribute::OpeningHours).text();

속성 유형은 공급자가 새로운 속성 유형을 도입할 수 있도록 문자열 값으로 설계되었습니다.

콘텐츠

QPlace 개체는 이미지, 리뷰 등과 같은 풍부한 콘텐츠를 보관하기 위한 편리한 컨테이너일 뿐입니다. 콘텐츠 검색은 QPlaceManager::getPlaceContent()를 통해 이루어져야 합니다.

콘텐츠는 콘텐츠 자체뿐만 아니라 콘텐츠의 인덱스가 모두 포함된 QPlaceContent::Collection 로 저장됩니다. 이를 통해 개발자는 특정 항목이 이미 검색되었는지 확인하고 검색되지 않은 경우 해당 콘텐츠를 요청할 수 있습니다.

속성

장소에는 서식 있는 텍스트 어트리뷰션 문자열을 입력할 수 있는 필드가 있습니다. 일부 제공업체는 사용자에게 장소가 표시될 때 어트리뷰션을 표시하도록 요구할 수 있습니다.

카테고리

장소가 해당 카테고리와 연관되어 있음을 나타내기 위해 장소에 다양한 카테고리를 할당할 수 있습니다. 장소를 저장할 때 의미 있는 데이터는 카테고리 ID뿐이며, 나머지 카테고리 데이터는 사실상 무시됩니다. 카테고리는 장소를 저장하기 전에 이미 존재해야 합니다(새 카테고리를 만들어 장소에 할당하고 장소를 저장한 후 카테고리가 생성될 것으로 기대할 수 없습니다).

저장 시 주의 사항

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

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

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

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

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

멤버 기능 문서

QPlace::QPlace()

빈 장소 객체를 생성합니다.

[protected] QPlace::QPlace(const QSharedDataPointer<QPlacePrivate> &dd)

dd 를 비공개 구현으로 사용하여 장소 객체를 구축합니다.

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

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

[noexcept] QPlace::~QPlace()

이곳을 파괴합니다.

void QPlace::appendContactDetail(const QString &contactType, const QPlaceContactDetail &detail)

지정된 contactType 의 연락처 detail 를 추가합니다.

일반적인 contact types 목록은 QPlaceContactDetail 을 참조하세요.

QString QPlace::attribution() const

장소의 서식 있는 텍스트 어트리뷰션 문자열을 반환합니다. 일부 제공업체는 최종 사용자에게 장소가 표시될 때마다 어트리뷰션이 표시되어야 하는 요구 사항을 가지고 있을 수 있습니다.

setAttribution()도 참조하세요 .

QList<QPlaceCategory> QPlace::categories() const

이 장소가 속한 카테고리를 반환합니다.

setCategories()도 참조하세요 .

QList<QPlaceContactDetail> QPlace::contactDetails(const QString &contactType) const

지정된 contactType 의 연락처 세부 정보 목록을 반환합니다.

일반적인 contact types 목록은 QPlaceContactDetail 을 참조하세요.

setContactDetails()도 참조하세요 .

QStringList QPlace::contactTypes() const

이 장소의 연락처 정보 유형을 반환합니다.

일반적인 contact types 목록은 QPlaceContactDetail 을 참조하세요.

QPlaceContent::Collection QPlace::content(QPlaceContent::Type type) const

장소와 연관된 콘텐츠 컬렉션을 반환합니다. 이 컬렉션은 키가 콘텐츠 객체의 인덱스이고 값이 콘텐츠 객체 자체인 맵입니다.

type 은 검색할 콘텐츠의 종류를 지정합니다.

setContent()도 참조하세요 .

bool QPlace::detailsFetched() const

이 장소의 세부 정보를 가져온 경우 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

setDetailsFetched()도 참조하세요 .

QPlaceAttribute QPlace::extendedAttribute(const QString &attributeType) const

지정된 attributeType 에 해당하는 확장된 속성을 반환합니다. 장소에 특정 속성 유형이 없는 경우, 기본적으로 구성된 QPlaceExtendedAttribute가 반환됩니다.

setExtendedAttribute()도 참조하세요 .

QStringList QPlace::extendedAttributeTypes() const

이 장소가 가지고 있는 확장 속성의 유형을 반환합니다.

QPlaceIcon QPlace::icon() const

장소의 아이콘을 반환합니다.

setIcon()도 참조하세요 .

void QPlace::insertContent(QPlaceContent::Type type, const QPlaceContent::Collection &content)

주어진 typecontent 컬렉션을 해당 장소에 추가합니다. content 에 이미 존재하는 인덱스는 모두 덮어씁니다.

bool QPlace::isEmpty() const

장소의 모든 필드가 비어 있는지 여부를 나타내는 부울을 반환합니다.

QGeoLocation QPlace::location() const

장소의 위치를 반환합니다.

setLocation()도 참조하세요 .

QString QPlace::name() const

장소의 이름을 반환합니다.

setName()도 참조하세요 .

QString QPlace::placeId() const

장소의 식별자를 반환합니다. 장소 식별자는 이를 생성한 QPlaceManager 에게만 의미가 있으며 관리자 간에 전송할 수 없습니다. 장소 식별자는 보편적으로 고유하다는 보장은 없지만 이를 생성한 관리자에게만 고유합니다.

setPlaceId()도 참조하세요 .

QString QPlace::primaryEmail() const

이 장소의 기본 이메일 주소를 반환합니다. 이 편의 함수는 email type 의 첫 번째 연락처 세부 정보에 액세스합니다. 이메일 주소가 존재하지 않으면 빈 문자열이 반환됩니다.

QString QPlace::primaryFax() const

이 장소의 기본 팩스 번호를 반환합니다. 이 편의 함수는 fax type 의 첫 번째 연락처 세부 정보에 액세스합니다. 팩스 세부 정보가 없으면 빈 문자열이 반환됩니다.

QString QPlace::primaryPhone() const

이 장소의 기본 전화번호를 반환합니다. phone number type 의 첫 번째 연락처 세부 정보에 액세스합니다. 전화 세부 정보가 없으면 빈 문자열이 반환됩니다.

QUrl QPlace::primaryWebsite() const

장소의 기본 웹사이트를 반환합니다. 이 편의 함수는 website type 의 첫 번째 연락처 세부 정보에 액세스합니다. 웹사이트가 존재하지 않으면 빈 문자열이 반환됩니다.

QPlaceRatings QPlace::ratings() const

장소의 집계된 등급을 반환합니다.

setRatings()도 참조하세요 .

void QPlace::removeContactDetails(const QString &contactType)

주어진 contactType 의 모든 연락처 정보를 제거합니다.

QPlace::contactTypes()을 호출하면 contactType 이 더 이상 반환되지 않습니다.

void QPlace::removeExtendedAttribute(const QString &attributeType)

attributeType 속성을 해당 위치에서 제거합니다.

속성은 더 이상 QPlace::extendedAttributeTypes()에 의해 나열되지 않습니다.

void QPlace::setAttribution(const QString &attribution)

장소의 attribution 문자열을 설정합니다.

attribution()도 참조하세요 .

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

이 장소가 속한 categories 을 설정합니다.

categories()도 참조하세요 .

void QPlace::setCategory(const QPlaceCategory &category)

이 장소가 속한 단일 category 을 설정합니다.

void QPlace::setContactDetails(const QString &contactType, QList<QPlaceContactDetail> details)

지정된 contactType 의 연락처 details 를 설정합니다.

details 이 비어 있으면 contactType 이 더 이상 QPlace::contactTypes()에 의해 반환되지 않도록 해당 위치에서 제거됩니다.

일반적인 contact types 목록은 QPlaceContactDetail 을 참조하세요.

contactDetails()도 참조하세요 .

void QPlace::setContent(QPlaceContent::Type type, const QPlaceContent::Collection &content)

주어진 type 에 대해 content 의 컬렉션을 설정합니다.

content()도 참조하세요 .

void QPlace::setDetailsFetched(bool fetched)

이 장소의 세부 정보가 fetched 인지 여부를 설정합니다.

detailsFetched()도 참조하세요 .

void QPlace::setExtendedAttribute(const QString &attributeType, const QPlaceAttribute &attribute)

주어진 attributeTypeattribute 를 장소에 할당합니다. 주어진 attributeType 이 이미 장소에 존재하면 덮어씁니다.

attribute 가 기본으로 구성된 QPlaceAttribute 인 경우 attributeType 는 장소에서 제거되므로 QPlace::extendedAttributeTypes()에 의해 나열되지 않습니다.

extendedAttribute()도 참조하세요 .

void QPlace::setIcon(const QPlaceIcon &icon)

장소의 icon 을 설정합니다.

icon()도 참조하세요 .

void QPlace::setLocation(const QGeoLocation &location)

장소의 location 을 설정합니다.

location()도 참조하세요 .

void QPlace::setName(const QString &name)

장소의 name 을 설정합니다.

name()도 참조하세요 .

void QPlace::setPlaceId(const QString &identifier)

장소의 identifier 을 설정합니다.

placeId()도 참조하세요 .

void QPlace::setRatings(const QPlaceRatings &rating)

장소의 집계된 rating 을 설정합니다.

ratings()도 참조하세요 .

void QPlace::setSupplier(const QPlaceSupplier &supplier)

이 장소의 공급업체를 supplier 로 설정합니다.

supplier()도 참조하세요 .

void QPlace::setTotalContentCount(QPlaceContent::Type type, int totalCount)

주어진 type 의 콘텐츠 객체의 totalCount 를 설정합니다.

totalContentCount()도 참조하세요 .

void QPlace::setVisibility(QLocation::Visibility visibility)

장소의 공개 범위를 visibility 로 설정합니다.

visibility()도 참조하세요 .

QPlaceSupplier QPlace::supplier() const

이 장소의 공급자를 반환합니다.

setSupplier()도 참조하세요 .

int QPlace::totalContentCount(QPlaceContent::Type type) const

주어진 type 의 콘텐츠 객체의 총 개수를 반환합니다. 이 총 개수는 관리자/제공자가 사용할 수 있어야 하는 개수를 나타냅니다. (이 장소 인스턴스에 현재 할당된 개체 수와는 반대).

음수 카운트는 총 항목 수를 알 수 없음을 나타냅니다. 기본적으로 총 콘텐츠 수는 0으로 설정되어 있습니다.

setTotalContentCount()도 참조하세요 .

QLocation::Visibility QPlace::visibility() const

장소의 가시성을 반환합니다.

새 장소의 기본 가시성은 QtLocatin::지정되지 않은 가시성으로 설정됩니다. 장소가 지정되지 않은 가시성으로 저장되면 백엔드에서 저장할 때 사용할 적절한 기본 가시성을 선택합니다.

setVisibility()도 참조하세요 .

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

이 장소에 other 을 할당하고 이 장소에 대한 참조를 반환합니다.

관련 비회원

[noexcept] bool operator!=(const QPlace &lhs, const QPlace &rhs)

lhsrhs 과 같지 않으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

[noexcept] bool operator==(const QPlace &lhs, const QPlace &rhs)

lhsrhs 과 같으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.