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) |
Verwandte Nichtmitglieder
| 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.