Auf dieser Seite

QPlace Class

Die Klasse „QPlace“ repräsentiert einen Datensatz zu einem Ort. Mehr...

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

Öffentliche Funktionen

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)

Geschützte Funktionen

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

Ausführliche Beschreibung

Ein Ort ist ein interessanter Punkt, beispielsweise ein Lieblingsrestaurant, ein Park oder das Zuhause einer Person. Ein QPlace-Objekt repräsentiert einen Ort, indem es als Container für verschiedene Informationen zu diesem Ort dient.

Diese Informationen lassen sich in zwei große Kategorien unterteilen

  • Details
  • Umfangreiche Inhalte

Die Ortsdetails umfassen Eigenschaften des Ortes, wie beispielsweise den Namen, den Standort, Kontaktinformationen und so weiter. Wenn ein Ort bei einer Suche zurückgegeben wird, werden diese Details ausgefüllt. Manchmal werden zur Einsparung von Bandbreite weitere Details zum Ort bereitgestellt, die bei Interesse des Nutzers für jeden Ort einzeln abgerufen werden können. Mit der Funktion „ QPlace::detailsFetched()“ lässt sich abfragen, ob alle verfügbaren Details bereits abgerufen wurden; ist dies nicht der Fall, können diese mit „ QPlaceManager::getPlaceDetails()“ nachgeladen werden. Welche Details bei einer Suche automatisch ausgefüllt werden und welche individuell abgerufen werden müssen, kann je nach Anbieter variieren. Weitere Informationen finden Sie in der Plugin-Dokumentation.

Die Rich-Content-Elemente eines Ortes umfassen beispielsweise Bilder, Bewertungen und redaktionelle Beiträge. Da es potenziell viele Rich-Content-Elemente geben kann, werden diese getrennt von den Ortsdetails behandelt. Sie können paginiert über ` QPlaceManager::getPlaceContent()` abgerufen werden. Bei Bedarf können die Inhalte einem Ort zugewiesen werden, der dann als praktischer Container dient.

Kontaktinformationen

Die Kontaktinformationen eines Ortes basieren auf einem gemeinsamen Satz von contact types. Um alle Telefonnummern eines Ortes abzurufen, würde man Folgendes tun:

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

Die Kontakttypen sind bewusst als Zeichenfolgenwerte definiert, damit Anbieter neue Kontakttypen einführen können.

Der Einfachheit halber gibt es eine Reihe von Funktionen, die den Wert des ersten Kontaktdetails jedes Typs zurückgeben.

Erweiterte Attribute

Orte können zusätzliche Attribute aufweisen, die nicht in der offiziellen API behandelt werden. Ähnlich wie bei Kontakten basieren diese Attribute auf einem gemeinsamen Satz von attribute types. Um ein erweitertes Attribut abzurufen, würde man Folgendes tun:

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

Die Attributtypen sind grundsätzlich Zeichenfolgenwerte, damit Anbieter neue Attributtypen einführen können.

Inhalt

Das QPlace-Objekt ist lediglich als praktischer Container gedacht, um umfangreiche Inhalte wie Bilder, Bewertungen und Ähnliches zu speichern. Das Abrufen von Inhalten sollte über die Funktion ` QPlaceManager::getPlaceContent()` erfolgen.

Der Inhalt wird als ` QPlaceContent::Collection ` gespeichert, das sowohl den Index des Inhalts als auch den Inhalt selbst enthält. Dies ermöglicht es Entwicklern, zu prüfen, ob ein bestimmtes Element bereits abgerufen wurde, und falls nicht, diesen Inhalt anzufordern.

Quellenangabe

Orte verfügen über ein Feld für eine Rich-Text-Angabe zur Urheberschaft. Einige Anbieter verlangen möglicherweise, dass die Urheberschaft angezeigt wird, wenn ein Ort einem Nutzer präsentiert wird.

Kategorien

Einem Ort können verschiedene Kategorien zugewiesen werden, um anzuzeigen, dass der Ort mit diesen Kategorien in Verbindung steht. Beim Speichern eines Ortes ist nur die Kategorie-ID von Bedeutung; die übrigen Kategoriedaten werden praktisch ignoriert. Die Kategorie muss bereits vor dem Speichern des Ortes existieren (es ist nicht möglich, eine neue Kategorie zu erstellen, sie dem Ort zuzuweisen, den Ort zu speichern und zu erwarten, dass die Kategorie dadurch erstellt wird).

Hinweise zum Speichern

Die Places-API ist derzeit ausschließlich für das Speichern von „ core “-Details ausgelegt. Das Speichern von Rich-Content wie Bildern und Bewertungen oder Details wie Anbieter und Bewertung wird nicht unterstützt. In der Regel ignoriert ein Administrator diese Felder beim Speichern und es wird möglicherweise eine Warnmeldung ausgegeben, wenn sie ausgefüllt sind.

Die Places-API unterstützt nur das Speichern der folgenden Kernangaben:

  • Name
  • Orts-ID
  • Standort
  • Kontaktdaten
  • Symbol
  • Kategorien (tagähnliche Bezeichnungen zur Beschreibung eines Ortes)
  • Sichtbarkeitsbereich

Es ist möglich, dass Anbieter nur einen Teil davon unterstützen. Weitere Details finden Sie in der Plugin-Dokumentation.

Das Speichern von Eigenschaften wie Bewertung, erweiterte Attribute, Bilder, Bewertungen, redaktionelle Beiträge und Anbieter wird von der Places-API ausdrücklich nicht unterstützt.

Dokumentation der Member-Funktionen

QPlace::QPlace()

Erstellt ein leeres Ortsobjekt.

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

Erstellt ein `place`-Objekt unter Verwendung von ` dd ` als private Implementierung.

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

Erstellt eine Kopie von „ other “.

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

Erzeugt eine Instanz von „ QPlace “ mittels „Move-Konstruktion“.

[noexcept] QPlace::~QPlace()

Das ruiniert diesen Ort.

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

Fügt einen Kontakt detail zu einem angegebenen contactType hinzu.

Eine Liste gängiger contact types finden Sie unter QPlaceContactDetail.

QString QPlace::attribution() const

Gibt eine Rich-Text-Zeichenkette mit der Quellenangabe für den Ort zurück. Beachten Sie, dass einige Anbieter möglicherweise vorschreiben, dass die Quellenangabe immer dann angezeigt werden muss, wenn ein Ort einem Endnutzer präsentiert wird.

Siehe auch setAttribution().

QList<QPlaceCategory> QPlace::categories() const

Gibt die Kategorien zurück, zu denen dieser Ort gehört.

Siehe auch ` setCategories()`.

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

Gibt eine Liste mit den Kontaktdaten der angegebenen contactType zurück.

Eine Liste gängiger „ contact types “ finden Sie unter „ QPlaceContactDetail “.

Siehe auch setContactDetails().

QStringList QPlace::contactTypes() const

Gibt den Typ der Kontaktdaten zurück, über die dieser Ort verfügt.

Eine Liste gängiger „ contact types “ finden Sie unter QPlaceContactDetail.

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

Gibt eine Sammlung von Inhalten zurück, die einem Ort zugeordnet sind. Diese Sammlung ist ein Schlüssel-Wert-Paar-Array, bei dem der Schlüssel der Index des Inhaltsobjekts und der Wert das Inhaltsobjekt selbst ist.

Die Methode „ type “ legt fest, welche Art von Inhalt abgerufen werden soll.

Siehe auch ` setContent()`.

bool QPlace::detailsFetched() const

Gibt „true“ zurück, wenn die Details zu diesem Ort abgerufen wurden, andernfalls „false“.

Siehe auch ` setDetailsFetched()`.

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

Gibt das erweiterte Attribut zurück, das dem angegebenen „ attributeType “ entspricht. Verfügt der Ort nicht über diesen bestimmten Attributtyp, wird ein standardmäßig erstelltes „QPlaceExtendedAttribute“ zurückgegeben.

Siehe auch ` setExtendedAttribute()`.

QStringList QPlace::extendedAttributeTypes() const

Gibt die Typen der erweiterten Attribute zurück, über die dieser Ort verfügt.

QPlaceIcon QPlace::icon() const

Gibt das Symbol des Ortes zurück.

Siehe auch setIcon().

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

Fügt dem Speicherort eine Sammlung von „ content “ des angegebenen „ type “ hinzu. Jeder bereits vorhandene Index in „ content “ wird überschrieben.

bool QPlace::isEmpty() const

Gibt einen booleschen Wert zurück, der angibt, ob alle Felder des Ortes leer sind oder nicht.

QGeoLocation QPlace::location() const

Gibt den Standort des Ortes zurück.

Siehe auch „ setLocation()“.

QString QPlace::name() const

Gibt den Namen des Ortes zurück.

Siehe auch „ setName()“.

QString QPlace::placeId() const

Gibt die Kennung des Ortes zurück. Die Ortskennung ist nur für den „ QPlaceManager “ von Bedeutung, der sie generiert hat, und ist nicht zwischen Managern übertragbar. Es wird nicht garantiert, dass die Ortskennung universell eindeutig ist, sie ist jedoch für den Manager, der sie generiert hat, eindeutig.

Siehe auch ` setPlaceId()`.

QString QPlace::primaryEmail() const

Gibt die primäre E-Mail-Adresse für diesen Ort zurück. Diese Hilfsfunktion greift auf die erste Kontaktangabe des Objekts „ email type “ zu. Sind keine E-Mail-Adressen vorhanden, wird eine leere Zeichenkette zurückgegeben.

QString QPlace::primaryFax() const

Gibt die primäre Faxnummer für diesen Standort zurück. Diese Hilfsfunktion greift auf die erste Kontaktangabe des Objekts „ fax type “ zu. Sind keine Faxangaben vorhanden, wird eine leere Zeichenkette zurückgegeben.

QString QPlace::primaryPhone() const

Gibt die primäre Telefonnummer für diesen Ort zurück. Dabei wird auf die erste Kontaktangabe des Objekts „ phone number type “ zugegriffen. Sind keine Telefonangaben vorhanden, wird eine leere Zeichenfolge zurückgegeben.

QUrl QPlace::primaryWebsite() const

Gibt die Hauptwebsite des Ortes zurück. Diese Hilfsfunktion greift auf die ersten Kontaktdaten von website type zu. Falls keine Websites vorhanden sind, wird eine leere Zeichenkette zurückgegeben.

QPlaceRatings QPlace::ratings() const

Gibt eine aggregierte Bewertung des Ortes zurück.

Siehe auch „ setRatings()“.

void QPlace::removeContactDetails(const QString &contactType)

Löscht alle Kontaktdaten eines bestimmten contactType.

Die contactType wird beim Aufruf von QPlace::contactTypes() nicht mehr zurückgegeben.

void QPlace::removeExtendedAttribute(const QString &attributeType)

Entfernen Sie das Attribut „ attributeType “ von dieser Stelle.

Das Attribut wird von QPlace::extendedAttributeTypes() nicht mehr aufgelistet.

void QPlace::setAttribution(const QString &attribution)

Legt die Zeichenfolge „ attribution “ für den Ort fest.

Siehe auch ` attribution()`.

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

Legt die „ categories “ fest, zu der dieser Ort gehört.

Siehe auch categories().

void QPlace::setCategory(const QPlaceCategory &category)

Legt ein einzelnes „ category “ fest, zu dem dieser Ort gehört.

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

Legt den Kontakt details einer angegebenen contactType fest.

Ist ` details ` leer, wird das ` contactType ` an dieser Stelle entfernt, sodass es von ` QPlace::contactTypes()` nicht mehr zurückgegeben wird.

Eine Liste gängiger „ contact types “ finden Sie unter „ QPlaceContactDetail “.

Siehe auch contactDetails().

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

Legt eine Sammlung von „ content “ für die angegebene „ type “ fest.

Siehe auch content().

void QPlace::setDetailsFetched(bool fetched)

Legt fest, ob die Details zu diesem Ort unter fetched veröffentlicht wurden oder nicht.

Siehe auch detailsFetched().

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

Weist einem Ort ein „ attribute “ mit der angegebenen „ attributeType “ zu. Wenn die angegebene „ attributeType “ bereits an diesem Ort vorhanden ist, wird sie überschrieben.

Ist ` attribute ` ein standardmäßig konstruiertes ` QPlaceAttribute`, wird das ` attributeType ` aus dem Speicherort entfernt, was bedeutet, dass es von ` QPlace::extendedAttributeTypes()` nicht mehr aufgelistet wird.

Siehe auch ` extendedAttribute()`.

void QPlace::setIcon(const QPlaceIcon &icon)

Legt die „ icon “ des Ortes fest.

Siehe auch „ icon()“.

void QPlace::setLocation(const QGeoLocation &location)

Legt die „ location “ des Ortes fest.

Siehe auch ` location()`.

void QPlace::setName(const QString &name)

Legt die „ name “ des Ortes fest.

Siehe auch ` name()`.

void QPlace::setPlaceId(const QString &identifier)

Legt die „ identifier “ des Ortes fest.

Siehe auch ` placeId()`.

void QPlace::setRatings(const QPlaceRatings &rating)

Legt die aggregierte rating des Ortes fest.

Siehe auch „ ratings()“.

void QPlace::setSupplier(const QPlaceSupplier &supplier)

Legt den Anbieter dieses Ortes auf „ supplier “ fest.

Siehe auch supplier().

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

Legt die „ totalCount “ der Inhaltsobjekte des angegebenen „ type “ fest.

Siehe auch ` totalContentCount()`.

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

Stellt die Sichtbarkeit des Ortes auf „ visibility “ ein.

Siehe auch visibility().

QPlaceSupplier QPlace::supplier() const

Gibt den Anbieter dieses Ortes zurück.

Siehe auch setSupplier().

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

Gibt die Gesamtanzahl der Inhaltsobjekte des angegebenen „ type “ zurück. Diese Gesamtanzahl gibt an, wie viele Objekte dem Manager/Anbieter zur Verfügung stehen sollten. (Im Gegensatz dazu, wie viele Objekte dieser Standortinstanz derzeit zugewiesen sind).

Eine negative Anzahl bedeutet, dass die Gesamtzahl der Elemente unbekannt ist. Standardmäßig ist die Gesamtanzahl der Inhalte auf 0 gesetzt.

Siehe auch ` setTotalContentCount()`.

QLocation::Visibility QPlace::visibility() const

Gibt die Sichtbarkeit des Ortes zurück.

Die Standard-Sichtbarkeit eines neuen Ortes ist auf QtLocatin::Unspecified setz. Wird ein Ort mit der Sichtbarkeit „Unspecified“ gespeichert, wählt das Backend beim Speichern eine geeignete Standard-Sichtbarkeit aus.

Siehe auch „ setVisibility()“.

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

Weist diesem Ort „ other “ zu und gibt einen Verweis auf diesen Ort zurück.

Verwandte Nicht-Mitglieder

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

Gibt „true“ zurück, wenn „ lhs “ nicht gleich „ rhs “ ist; andernfalls wird „false“ zurückgegeben.

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

Gibt „true“ zurück, wenn „ lhs “ gleich „ rhs “ ist, andernfalls „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.