Auf dieser Seite

QPlaceManagerEngine Class

Die Klasse „QPlaceManagerEngine“ bietet eine Schnittstelle für Entwickler von „ QGeoServiceProvider “-Plugins, die Zugriff auf Platzierungsfunktionen bereitstellen möchten. Mehr...

Header: #include <QPlaceManagerEngine>
qmake: QT += location
Inherits: QObject

Öffentliche Funktionen

QPlaceManagerEngine(const QVariantMap &parameters, QObject *parent = nullptr)
virtual ~QPlaceManagerEngine()
virtual QPlaceCategory category(const QString &categoryId) const
virtual QList<QPlaceCategory> childCategories(const QString &parentId) const
virtual QStringList childCategoryIds(const QString &categoryId) const
virtual QPlace compatiblePlace(const QPlace &original) const
virtual QUrl constructIconUrl(const QPlaceIcon &icon, const QSize &size) const
virtual QPlaceContentReply *getPlaceContent(const QPlaceContentRequest &request)
virtual QPlaceDetailsReply *getPlaceDetails(const QString &placeId)
virtual QPlaceReply *initializeCategories()
virtual QList<QLocale> locales() const
QString managerName() const
int managerVersion() const
virtual QPlaceMatchReply *matchingPlaces(const QPlaceMatchRequest &request)
virtual QString parentCategoryId(const QString &categoryId) const
virtual QPlaceIdReply *removeCategory(const QString &categoryId)
virtual QPlaceIdReply *removePlace(const QString &placeId)
virtual QPlaceIdReply *saveCategory(const QPlaceCategory &category, const QString &parentId)
virtual QPlaceIdReply *savePlace(const QPlace &place)
virtual QPlaceSearchReply *search(const QPlaceSearchRequest &request)
virtual QPlaceSearchSuggestionReply *searchSuggestions(const QPlaceSearchRequest &request)
virtual void setLocales(const QList<QLocale> &locales)

Signale

void categoryAdded(const QPlaceCategory &category, const QString &parentId)
void categoryRemoved(const QString &categoryId, const QString &parentId)
void categoryUpdated(const QPlaceCategory &category, const QString &parentId)
void dataChanged()
void errorOccurred(QPlaceReply *reply, QPlaceReply::Error error, const QString &errorString = QString())
void finished(QPlaceReply *reply)
void placeAdded(const QString &placeId)
void placeRemoved(const QString &placeId)
void placeUpdated(const QString &placeId)

Geschützte Funktionen

QPlaceManager *manager() const

Ausführliche Beschreibung

Hinweis: Es gibt keine Garantien hinsichtlich der Quell- oder Binärkompatibilität für die Backend-Klassen. Die API funktioniert garantiert nur mit der Qt-Version, für die sie entwickelt wurde. API-Änderungen werden jedoch nur in Minor-Releases vorgenommen (6.6, 6.7 usw.).

Anwendungsentwickler müssen sich nicht mit der `QPlaceManagerEngine` befassen. Backend-Implementierer müssen jedoch von der `QPlaceManagerEngine` ableiten und Implementierungen für die abstrakten virtuellen Funktionen bereitstellen.

Weitere Informationen zum Erstellen eines Backends finden Sie in der Dokumentation zum Places-Backend.

Siehe auch QPlaceManager.

Dokumentation zu den Mitgliedsfunktionen

[explicit] QPlaceManagerEngine::QPlaceManagerEngine(const QVariantMap &parameters, QObject *parent = nullptr)

Erstellt eine neue Engine mit dem angegebenen ` parent` und verwendet ` parameters `, um implementierungsspezifische Daten an die Engine zu übergeben.

[virtual noexcept] QPlaceManagerEngine::~QPlaceManagerEngine()

Das zerstört diesen Motor.

[virtual] QPlaceCategory QPlaceManagerEngine::category(const QString &categoryId) const

Gibt die Kategorie zurück, die dem angegebenen „ categoryId “ entspricht.

[signal] void QPlaceManagerEngine::categoryAdded(const QPlaceCategory &category, const QString &parentId)

Dieses Signal wird ausgelöst, wenn ein „ category “ zum Datenspeicher der Manager-Engine hinzugefügt wurde. Das übergeordnete Element des „ category “ wird durch „ parentId “ angegeben.

Dieses Signal wird nur von Manager-Engines ausgegeben, die die Funktion `QPlaceManager::NotificationsFeature` unterstützen.

Siehe auch „ dataChanged()“.

[signal] void QPlaceManagerEngine::categoryRemoved(const QString &categoryId, const QString &parentId)

Dieses Signal wird ausgelöst, wenn die Kategorie, die „ categoryId “ entspricht, aus dem Datenspeicher der Manager-Engine entfernt wurde. Die übergeordnete Kategorie der entfernten Kategorie wird durch „ parentId “ angegeben.

Dieses Signal wird nur von Manager-Engines ausgegeben, die die Funktion `QPlaceManager::NotificationsFeature` unterstützen.

Siehe auch dataChanged().

[signal] void QPlaceManagerEngine::categoryUpdated(const QPlaceCategory &category, const QString &parentId)

Dieses Signal wird ausgelöst, wenn eine „ category “ im Datenspeicher der Manager-Engine geändert wurde. Die übergeordnete Kategorie der geänderten Kategorie wird durch „ parentId “ angegeben.

Dieses Signal wird nur von Manager-Engines ausgegeben, die die Funktion `QPlaceManager::NotificationsFeature` unterstützen.

Siehe auch ` dataChanged()`.

[virtual] QList<QPlaceCategory> QPlaceManagerEngine::childCategories(const QString &parentId) const

Gibt eine Liste der Unterkategorien der Kategorie zurück, die unter parentId zu finden ist. Ist parentId leer, werden alle Kategorien der obersten Ebene zurückgegeben.

[virtual] QStringList QPlaceManagerEngine::childCategoryIds(const QString &categoryId) const

Gibt die Kennungen der Unterkategorien der Kategorie zurück, die categoryId entspricht. Ist categoryId leer, werden alle Kennungen der obersten Kategorieebene zurückgegeben.

[virtual] QPlace QPlaceManagerEngine::compatiblePlace(const QPlace &original) const

Gibt eine bereinigte oder modifizierte Version des Ortes „ original “ zurück, die für die Speicherung durch die Manager-Engine geeignet ist.

In der modifizierten Version sind nur die Ortsdetails enthalten, die von diesem Manager unterstützt werden. Managerspezifische Daten wie die Orts-ID werden nicht aus dem „ original “ übernommen.

[virtual] QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size) const

QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size)

Erstellt eine Icon-URL aus den angegebenen Werten für ` icon` und ` size`. Es wird die URL des Icon-Bildes zurückgegeben, die den angegebenen Parametern am ehesten entspricht.

[signal] void QPlaceManagerEngine::dataChanged()

*

Dieses Signal wird von der Engine ausgegeben, wenn umfangreiche Änderungen am zugrunde liegenden Datenspeicher vorgenommen werden und die Engine diese Änderungen als so gravierend erachtet, dass Clients alle Daten neu laden müssen.

Wird dieses Signal ausgesendet, werden für die damit verbundenen Änderungen keine weiteren Signale ausgesendet.

[signal] void QPlaceManagerEngine::errorOccurred(QPlaceReply *reply, QPlaceReply::Error error, const QString &errorString = QString())

Dieses Signal wird ausgegeben, wenn bei der Verarbeitung von reply ein Fehler festgestellt wurde. Das Signal QPlaceManager::finished() wird wahrscheinlich darauf folgen.

Der Fehler wird durch den Fehlercode ` error` beschrieben. Wenn ` errorString ` nicht leer ist, enthält es eine textuelle Beschreibung des Fehlers, die sich an Entwickler und nicht an Endbenutzer richtet.

Dieses Signal und QPlaceReply::errorOccurred() werden gleichzeitig ausgelöst.

Hinweis: LöschenSie das „ reply “-Objekt nicht im mit diesem Signal verbundenen Slot. Verwenden Sie stattdessen „ deleteLater()“.

[signal] void QPlaceManagerEngine::finished(QPlaceReply *reply)

Dieses Signal wird ausgelöst, wenn die Verarbeitung von „ reply “ abgeschlossen ist.

Wenn reply->error() gleich QPlaceReply::NoError ist, wurde die Verarbeitung erfolgreich abgeschlossen.

Dieses Signal und ` QPlaceReply::finished()` werden gleichzeitig ausgelöst.

Hinweis: LöschenSie das „ reply “-Objekt nicht in dem mit diesem Signal verbundenen Slot. Verwenden Sie stattdessen „ deleteLater()“.

[virtual] QPlaceContentReply *QPlaceManagerEngine::getPlaceContent(const QPlaceContentRequest &request)

Ruft Inhalte zu einem Ort gemäß den unter request angegebenen Parametern ab.

[virtual] QPlaceDetailsReply *QPlaceManagerEngine::getPlaceDetails(const QString &placeId)

Ruft Details zu dem Ort ab, der der angegebenen URL placeId entspricht.

[virtual] QPlaceReply *QPlaceManagerEngine::initializeCategories()

Initialisiert die Kategorien der Manager-Engine.

[virtual] QList<QLocale> QPlaceManagerEngine::locales() const

Gibt eine Liste der bevorzugten Locales zurück. Die Locales dienen der Manager-Engine als Hinweis darauf, in welcher Sprache und für welche Kategorie Details zurückgegeben werden sollen.

Kann die erste angegebene Locale nicht berücksichtigt werden, greift die Manager-Engine auf die nächste zurück und so weiter.

Die Unterstützung für Locales kann je nach Anbieter variieren. Bei Anbietern, die dies unterstützen, wird standardmäßig die „ global default locale “ verwendet. Wenn der Manager-Engine keine Locales zugewiesen sind, verwendet sie implizit die globale Standard-Locale. Bei Engines, die keine Locales unterstützen, ist die Locale-Liste immer leer.

Siehe auch setLocales().

[protected] QPlaceManager *QPlaceManagerEngine::manager() const

Gibt die Manager-Instanz zurück, die zum Erstellen dieser Engine verwendet wurde.

QString QPlaceManagerEngine::managerName() const

Gibt den Namen zurück, den diese Engine-Implementierung verwendet, um sich von den Implementierungen anderer Plugins zu unterscheiden.

Der Manager-Name wird automatisch so gesetzt, dass er mit dem Wert von `QGeoServiceProviderFactory::providerName()` übereinstimmt.

int QPlaceManagerEngine::managerVersion() const

Gibt die Version dieser Engine-Implementierung zurück.

Die Manager-Version wird automatisch so eingestellt, dass sie mit der `QGeoServiceProviderFactory::providerVersion()` übereinstimmt.

[virtual] QPlaceMatchReply *QPlaceManagerEngine::matchingPlaces(const QPlaceMatchRequest &request)

Gibt eine Antwort zurück, die eine Liste von Orten enthält, die den unter request angegebenen entsprechen.

[virtual] QString QPlaceManagerEngine::parentCategoryId(const QString &categoryId) const

Gibt die Kennung der übergeordneten Kategorie der Kategorie zurück, die „ categoryId “ entspricht.

[signal] void QPlaceManagerEngine::placeAdded(const QString &placeId)

Dieses Signal wird ausgelöst, wenn ein Ort zum Datenspeicher der Manager-Engine hinzugefügt wurde. Der konkret hinzugefügte Ort wird durch ` placeId` angegeben.

Dieses Signal wird nur von Manager-Engines ausgegeben, die die Funktion `QPlaceManager::NotificationsFeature` unterstützen.

Siehe auch dataChanged().

[signal] void QPlaceManagerEngine::placeRemoved(const QString &placeId)

Dieses Signal wird ausgelöst, wenn ein Ort aus dem Datenspeicher der Manager-Engine entfernt wurde. Der konkrete Ort, der entfernt wurde, wird durch „ placeId “ angegeben.

Dieses Signal wird nur von Manager-Engines ausgegeben, die die Funktion `QPlaceManager::NotificationsFeature` unterstützen.

Siehe auch ` dataChanged()`.

[signal] void QPlaceManagerEngine::placeUpdated(const QString &placeId)

Dieses Signal wird ausgelöst, wenn ein Ort im Datenspeicher der Manager-Engine geändert wurde. Der konkret geänderte Ort wird durch ` placeId` angegeben.

Dieses Signal wird nur von Manager-Engines ausgegeben, die die Funktion `QPlaceManager::NotificationsFeature` unterstützen.

Siehe auch ` dataChanged()`.

[virtual] QPlaceIdReply *QPlaceManagerEngine::removeCategory(const QString &categoryId)

Entfernt die Kategorie, die „ categoryId “ entspricht, aus dem Datenspeicher der Manager-Engine.

[virtual] QPlaceIdReply *QPlaceManagerEngine::removePlace(const QString &placeId)

Entfernt den Eintrag „ placeId “ aus dem Datenspeicher der Manager-Engine.

[virtual] QPlaceIdReply *QPlaceManagerEngine::saveCategory(const QPlaceCategory &category, const QString &parentId)

Speichert eine „ category “, die eine Unterkategorie der unter parentId angegebenen Kategorie ist. Eine leere parentId bedeutet, dass „ category “ als oberste Kategorie gespeichert wird.

[virtual] QPlaceIdReply *QPlaceManagerEngine::savePlace(const QPlace &place)

Speichert ein angegebenes „ place “ im Datenspeicher der Manager-Engine.

Sucht nach Orten anhand der unter request angegebenen Parameter.

[virtual] QPlaceSearchSuggestionReply *QPlaceManagerEngine::searchSuggestions(const QPlaceSearchRequest &request)

Fordert eine Reihe von Suchbegriffsvorschlägen entsprechend den unter request angegebenen Parametern an.

[virtual] void QPlaceManagerEngine::setLocales(const QList<QLocale> &locales)

Legen Sie die Liste der bevorzugten locales fest.

Siehe auch locales().

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