QPlace Class

Die Klasse QPlace repräsentiert einen Satz von Daten über einen Ort. Mehr...

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

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Öffentliche Funktionen

	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)

Geschützte Funktionen

QPlace(const QSharedDataPointer<QPlacePrivate> &dd)

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

Detaillierte Beschreibung

Ein Ort ist ein Punkt von Interesse, z.B. ein Lieblingsrestaurant, ein Park oder das Haus einer Person. Ein QPlace-Objekt repräsentiert einen Ort, indem es als Container für verschiedene Informationen über diesen Ort dient.

Diese Informationen können in 2 große Kategorien unterteilt werden

Einzelheiten
Reichhaltiger Inhalt

Die Ortsdetails bestehen aus den Eigenschaften des Ortes, wie Name, Standort, Kontaktinformationen usw. Wenn ein Ort bei einer Suche zurückgegeben wird, werden diese Details ausgefüllt. Um Bandbreite zu sparen, gibt es manchmal weitere Details über den Ort, die für jeden Ort einzeln abgerufen werden können, wenn der Nutzer daran interessiert ist. Die Funktion QPlace::detailsFetched() kann abgefragt werden, um zu sehen, ob alle verfügbaren Details abgerufen wurden, und wenn nicht, kann QPlaceManager::getPlaceDetails() verwendet werden, um sie abzurufen. Welche Details genau bei einer Suche ausgefüllt werden und welche einzeln abgerufen werden müssen, kann von Anbieter zu Anbieter variieren. Weitere Einzelheiten finden Sie in der Plugin-Dokumentation.

Der Rich Content eines Ortes besteht aus Elementen wie Bildern, Bewertungen und redaktionellen Beiträgen. Da es möglicherweise viele Rich-Content-Elemente geben kann, werden sie getrennt von den Ortsangaben behandelt. Sie können über QPlaceManager::getPlaceContent() seitenweise abgerufen werden. Falls erforderlich, kann der Inhalt einem Ort zugewiesen werden, damit er als praktischer Container fungieren kann.

Kontaktinformationen

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

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

Bei den Kontakttypen handelt es sich um String-Werte, damit die 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 haben, die nicht in der formalen API enthalten sind. Ähnlich wie bei Kontakten basieren die 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();

Bei den Attributstypen handelt es sich um String-Werte, damit die Anbieter neue Attributstypen einführen können.

Inhalt

Das QPlace-Objekt ist nur als bequemer Container gedacht, um reichhaltige Inhalte wie Bilder, Bewertungen und so weiter zu speichern. Der Abruf von Inhalten sollte über QPlaceManager::getPlaceContent() erfolgen.

Der Inhalt wird als QPlaceContent::Collection gespeichert, das sowohl den Index des Inhalts als auch den Inhalt selbst enthält. Auf diese Weise können Entwickler prüfen, ob ein bestimmtes Element bereits abgerufen wurde, und wenn nicht, diesen Inhalt anfordern.

Namensnennung

Orte verfügen über ein Feld für eine Rich-Text-Attributionszeichenfolge. Einige Anbieter können verlangen, dass die Zuschreibung angezeigt wird, wenn ein Ort einem Nutzer angezeigt wird.

Kategorien

Einem Ort können verschiedene Kategorien zugewiesen werden, um anzuzeigen, dass der Ort mit diesen Kategorien verbunden ist. Beim Speichern eines Ortes ist die einzige sinnvolle Angabe die Kategorie-ID, der Rest der Kategoriedaten wird praktisch ignoriert. Die Kategorie muss bereits existieren, bevor der Ort gespeichert wird (es ist nicht möglich, eine neue Kategorie zu erstellen, sie dem Ort zuzuweisen, den Ort zu speichern und zu erwarten, dass die Kategorie erstellt wird).

Vorbehalte beim Speichern

Die Places API ist derzeit nur für das Speichern von core Details ausgelegt. Das Speichern von umfangreichen Inhalten wie Bildern und Bewertungen oder Details wie Anbieter und Bewertung ist kein unterstützter Anwendungsfall. Normalerweise ignoriert ein Manager diese Felder beim Speichern und kann eine Warnmeldung ausgeben, wenn sie ausgefüllt sind.

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

Name
Ortskennung
Standort
Kontaktdetails
Symbol
Kategorien (tagähnliche Namen zur Beschreibung eines Ortes)
Sichtbarkeitsbereich

Es ist möglich, dass Anbieter nur eine Teilmenge davon unterstützen. Weitere Einzelheiten finden Sie in der Plugin-Dokumentation.

Das Speichern von Eigenschaften wie die Bewertung, erweiterte Attribute, Bilder, Bewertungen, Leitartikel und Anbieter wird von der Places API ausdrücklich nicht unterstützt.

Dokumentation der Mitgliedsfunktionen

QPlace::QPlace()

Konstruiert ein leeres Ortsobjekt.

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

Konstruiert ein Place-Objekt unter Verwendung von dd als private Implementierung.

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

Konstruiert eine Kopie von other.

`[noexcept]` QPlace::~QPlace()

Zerstört diesen Ort.

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

Hängt einen Kontakt detail eines bestimmten contactType an.

Siehe QPlaceContactDetail für eine Liste gängiger contact types.

QString QPlace::attribution() const

Gibt eine Rich-Text-Zeichenkette für den Ort zurück. Beachten Sie, dass bei einigen Anbietern die Attribution angezeigt werden muss, wenn ein Ort einem Endbenutzer angezeigt 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

Liefert eine Liste von Kontaktdetails des angegebenen contactType.

Siehe QPlaceContactDetail für eine Liste allgemeiner contact types.

Siehe auch setContactDetails().

QStringList QPlace::contactTypes() const

Gibt die Art der Kontaktinformationen zurück, die dieser Ort hat.

Siehe QPlaceContactDetail für eine Liste der üblichen contact types.

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

Gibt eine Sammlung von Inhalten zurück, die mit einem Ort verbunden sind. Diese Sammlung ist eine Karte, wobei der Schlüssel der Index des Inhaltsobjekts und der Wert das Inhaltsobjekt selbst ist.

Die type gibt an, welche Art von Inhalt abgerufen werden soll.

Siehe auch setContent().

bool QPlace::detailsFetched() const

Gibt true zurück, wenn die Details dieses Ortes 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. Wenn der Ort nicht über diesen bestimmten Attributtyp verfügt, wird ein standardmäßig konstruiertes QPlaceExtendedAttribute zurückgegeben.

Siehe auch setExtendedAttribute().

QStringList QPlace::extendedAttributeTypes() const

Gibt die Typen der erweiterten Attribute zurück, die dieser Ort hat.

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 eine Sammlung von content mit dem angegebenen type zum Ort hinzu. Ein bereits vorhandener 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 den Bezeichner des Ortes zurück. Der Ortsbezeichner ist nur für den QPlaceManager aussagekräftig, der ihn erzeugt hat, und kann nicht zwischen Managern übertragen werden. Es ist nicht garantiert, dass der Ortsbezeichner universell eindeutig ist, aber eindeutig für den Manager, der ihn erzeugt hat.

Siehe auch setPlaceId().

QString QPlace::primaryEmail() const

Gibt die primäre E-Mail-Adresse für diesen Ort zurück. Diese Komfortfunktion greift auf das erste Kontaktdetail von email type zu. Wenn keine E-Mail-Adressen vorhanden sind, wird eine leere Zeichenfolge zurückgegeben.

QString QPlace::primaryFax() const

Gibt die primäre Faxnummer für diesen Ort zurück. Diese Komfortfunktion greift auf das erste Kontaktdetail von fax type zu. Wenn keine Faxdetails vorhanden sind, wird ein leerer String zurückgegeben.

QString QPlace::primaryPhone() const

Gibt die Haupttelefonnummer für diesen Ort zurück. Damit wird auf das erste Kontaktdetail von phone number type zugegriffen. Wenn keine Telefondetails vorhanden sind, wird ein leerer String zurückgegeben.

QUrl QPlace::primaryWebsite() const

Gibt die primäre Website des Ortes zurück. Diese Komfortfunktion greift auf das erste Kontaktdetail von website type zu. Wenn keine Websites vorhanden sind, wird ein leerer String zurückgegeben.

QPlaceRatings QPlace::ratings() const

Gibt eine aggregierte Bewertung des Ortes zurück.

Siehe auch setRatings().

void QPlace::removeContactDetails(const QString &contactType)

Entfernt alle Kontaktinformationen eines bestimmten contactType.

Der contactType wird nicht mehr zurückgegeben, wenn QPlace::contactTypes() aufgerufen wird.

void QPlace::removeExtendedAttribute(const QString &attributeType)

Entfernt das Attribut von attributeType aus dem Ort.

Das Attribut wird nicht mehr von QPlace::extendedAttributeTypes aufgeführt ()

void QPlace::setAttribution(const QString &attribution)

Setzt die attribution Zeichenfolge des Ortes.

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 eine einzelne category fest, zu der dieser Ort gehört.

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

Setzt den Kontakt details eines angegebenen contactType.

Wenn details leer ist, wird contactType aus dem Ort entfernt, so dass er nicht mehr von QPlace::contactTypes() zurückgegeben wird.

Siehe QPlaceContactDetail für eine Liste der üblichen contact types.

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 Angaben zu diesem Ort fetched sind oder nicht.

Siehe auch detailsFetched().

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

Weist eine attribute der angegebenen attributeType einem Ort zu. Wenn die angegebene attributeType bereits an der Stelle existiert, wird sie überschrieben.

Wenn attribute ein standardmäßig konstruiertes QPlaceAttribute ist, dann wird attributeType aus dem Ort entfernt, was bedeutet, dass es nicht von QPlace::extendedAttributeTypes() 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)

Setzt den Anbieter dieses Ortes auf supplier.

Siehe auch supplier().

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

Setzt die totalCount der Inhaltsobjekte der angegebenen type.

Siehe auch totalContentCount().

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

Setzt die Sichtbarkeit des Ortes auf visibility.

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 Gesamtzahl der Inhaltsobjekte des angegebenen type zurück. Diese Gesamtzahl gibt an, wie viele der Manager/Provider zur Verfügung haben sollte. (Im Gegensatz dazu, wie viele Objekte dieser Ortsinstanz derzeit zugewiesen sind).

Eine negative Anzahl zeigt an, dass die Gesamtzahl der Objekte unbekannt ist. Standardmäßig ist die Gesamtzahl der Inhalte auf 0 gesetzt.

Siehe auch setTotalContentCount().

QLocation::Visibility QPlace::visibility() const

Gibt die Sichtbarkeit des Ortes zurück.

Die Standardsichtbarkeit eines neuen Ortes wird auf QtLocatin::Unspecified visibility gesetzt. Wenn ein Ort mit unspezifizierter Sichtbarkeit gespeichert wird, wählt das Backend eine geeignete Standardsichtbarkeit aus, die beim Speichern verwendet wird.

Siehe auch setVisibility().

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

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