QPlace Class

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

 if (place.extendedAttributeTypes().contains(QPlaceAttribute::OpeningHours))
     qDebug() << place.extendedAttribute(QPlaceAttribute::OpeningHours).text();

Member Function Documentation

QPlace::QPlace()

Constructs an empty place object.

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

Constructs an place object using dd as private implementation.

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

Constructs a copy of other.

[noexcept] QPlace::~QPlace()

Destroys this place.

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

Appends a contact detail of a specified contactType.

See QPlaceContactDetail for a list of common contact types.

QString QPlace::attribution() const

Returns a rich text attribution string of the place. Note, some providers may have a requirement where the attribution must be shown whenever a place is displayed to an end user.

See also setAttribution().

QList<QPlaceCategory> QPlace::categories() const

Returns categories that this place belongs to.

See also setCategories().

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

Returns a list of contact details of the specified contactType.

See QPlaceContactDetail for a list of common contact types.

See also setContactDetails().

QStringList QPlace::contactTypes() const

Returns the type of contact details this place has.

See QPlaceContactDetail for a list of common contact types.

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

Returns a collection of content associated with a place. This collection is a map with the key being the index of the content object and value being the content object itself.

The type specifies which kind of content is to be retrieved.

See also setContent().

bool QPlace::detailsFetched() const

Returns true if the details of this place have been fetched, otherwise returns false.

See also setDetailsFetched().

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

Returns the exteded attribute corresponding to the specified attributeType. If the place does not have that particular attribute type, a default constructed QPlaceExtendedAttribute is returned.

See also setExtendedAttribute().

QStringList QPlace::extendedAttributeTypes() const

Returns the types of extended attributes that this place has.

QPlaceIcon QPlace::icon() const

Returns the icon of the place.

See also setIcon().

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

Adds a collection of content of the given type to the place. Any index in content that already exists is overwritten.

bool QPlace::isEmpty() const

Returns a boolean indicating whether the all the fields of the place are empty or not.

QGeoLocation QPlace::location() const

Returns the location of the place.

See also setLocation().

QString QPlace::name() const

Returns the name of the place.

See also setName().

QString QPlace::placeId() const

Returns the identifier of the place. The place identifier is only meaningful to the QPlaceManager that generated it and is not transferable between managers. The place identifier is not guaranteed to be universally unique, but unique for the manager that generated it.

See also setPlaceId().

QString QPlace::primaryEmail() const

Returns the primary email address for this place. This convenience function accesses the first contact detail of the email type. If no email addresses exist, then an empty string is returned.

QString QPlace::primaryFax() const

Returns the primary fax number for this place. This convenience function accesses the first contact detail of the fax type. If no fax details exist, then an empty string is returned.

QString QPlace::primaryPhone() const

Returns the primary phone number for this place. This accesses the first contact detail of the phone number type. If no phone details exist, then an empty string is returned.

QUrl QPlace::primaryWebsite() const

Returns the primary website of the place. This convenience function accesses the first contact detail of the website type. If no websites exist, then an empty string is returned.

QPlaceRatings QPlace::ratings() const

Returns an aggregated rating of the place.

See also setRatings().

void QPlace::removeContactDetails(const QString &contactType)

Removes all the contact details of a given contactType.

The contactType is no longer returned when QPlace::contactTypes() is called.

void QPlace::removeExtendedAttribute(const QString &attributeType)

Remove the attribute of attributeType from the place.

The attribute will no longer be listed by QPlace::extendedAttributeTypes()

void QPlace::setAttribution(const QString &attribution)

Sets the attribution string of the place.

See also attribution().

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

Sets the categories that this place belongs to.

See also categories().

void QPlace::setCategory(const QPlaceCategory &category)

Sets a single category that this place belongs to.

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

Sets the contact details of a specified contactType.

If details is empty, then the contactType is removed from the place such that it is no longer returned by QPlace::contactTypes().

See QPlaceContactDetail for a list of common contact types.

See also contactDetails().

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

Sets a collection of content for the given type.

See also content().

void QPlace::setDetailsFetched(bool fetched)

Sets whether the details of this place have been fetched or not.

See also detailsFetched().

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

Assigns an attribute of the given attributeType to a place. If the given attributeType already exists in the place, then it is overwritten.

If attribute is a default constructed QPlaceAttribute, then the attributeType is removed from the place which means it will not be listed by QPlace::extendedAttributeTypes().

See also extendedAttribute().

void QPlace::setIcon(const QPlaceIcon &icon)

Sets the icon of the place.

See also icon().

void QPlace::setLocation(const QGeoLocation &location)

Sets the location of the place.

See also location().

void QPlace::setName(const QString &name)

Sets the name of the place.

See also name().

void QPlace::setPlaceId(const QString &identifier)

Sets the identifier of the place.

See also placeId().

void QPlace::setRatings(const QPlaceRatings &rating)

Sets the aggregated rating of the place.

See also ratings().

void QPlace::setSupplier(const QPlaceSupplier &supplier)

Sets the supplier of this place to supplier.

See also supplier().

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

Sets the totalCount of content objects of the given type.

See also totalContentCount().

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

Sets the visibility of the place to visibility.

See also visibility().

QPlaceSupplier QPlace::supplier() const

Returns the supplier of this place.

See also setSupplier().

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

Returns the total count of content objects of the given type. This total count indicates how many the manager/provider should have available. (As opposed to how many objects this place instance is currently assigned).

A negative count indicates that the total number of items is unknown. By default the total content count is set to 0.

See also setTotalContentCount().

QLocation::Visibility QPlace::visibility() const

Returns the visibility of the place.

The default visibility of a new place is set to QtLocatin::Unspecified visibility. If a place is saved with unspecified visibility the backend chooses an appropriate default visibility to use when saving.

See also setVisibility().

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

Assigns other to this place and returns a reference to this place.