이 페이지에서

QPlace Class

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

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

공개 함수

QPlace()
QPlace(const QPlace &other)
QPlace(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::OpeningHours))
    qDebug() << place.extendedAttribute(QPlaceAttribute::OpeningHours).text();

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

콘텐츠

QPlace 객체는 이미지, 리뷰 등과 같은 풍부한 콘텐츠를 담기 위한 편리한 컨테이너로만 사용되어야 합니다. 콘텐츠의 검색은 ` QPlaceManager::getPlaceContent()`를 통해 이루어져야 합니다.

콘텐츠는 콘텐츠의 인덱스와 콘텐츠 자체를 모두 포함하는 ` QPlaceContent::Collection `로 저장됩니다. 이를 통해 개발자는 특정 항목이 이미 가져온 것인지 확인할 수 있으며, 아직 가져오지 않은 경우 해당 콘텐츠를 요청할 수 있습니다.

출처 표기

장소에는 서식 있는 텍스트 형식의 출처 정보 문자열을 입력할 수 있는 필드가 있습니다. 일부 제공업체는 사용자에게 장소가 표시될 때 출처 정보가 표시되도록 요구할 수 있습니다.

카테고리

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

저장 시 유의사항

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

Places API는 다음 핵심 정보의 저장만 지원합니다:

  • 이름
  • 장소 ID
  • 위치
  • 연락처 정보
  • 아이콘
  • 카테고리 (장소를 설명하는 태그와 유사한 이름)
  • 표시 범위

제공업체에 따라 이 중 일부만 지원될 수 있습니다. 자세한 내용은 플러그인 설명서를 참조하십시오.

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

멤버 함수 문서

QPlace::QPlace()

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

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

dd 를 비공개 구현으로 사용하여 위치 객체를 생성합니다.

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

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

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

QPlace 의 인스턴스를 Move 생성합니다.

[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

이 장소의 세부 정보가 가져온 경우 true를 반환하고, 그렇지 않은 경우 false를 반환합니다.

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)

지정된 ` type `에 대한 ` content ` 컬렉션을 해당 위치에 추가합니다. ` 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)

지정된 attributeType 의 attribute 를 특정 위치에 할당합니다. 지정된 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

해당 장소의 공개 범위를 반환합니다.

새 장소의 기본 가시성은 QtLocation::Unspecified로 설정됩니다. 장소가 '미지정' 가시성으로 저장될 경우, 백엔드는 저장 시 사용할 적절한 기본 가시성을 선택합니다.

setVisibility()도 참조하십시오 .

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

이 위치에 ` other `를 할당하고, 이 위치에 대한 참조를 반환합니다.

관련 비회원

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

lhs 이 rhs 과 같지 않으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

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

lhs 가 rhs 와 같으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

© 2026 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.