QPlaceManager Class

//1) Stellen Sie eine entsprechende AnfrageQPlaceSearchRequest searchRequest; searchRequest.setSearchTerm("Eiscreme"); searchRequest.setSearchArea(QGeoCircle(QGeoCoordinate(12.34, 56.78)));//2) Verwenden Sie den Manager, um eine Anfrage zu initiieren und ein Antwortobjekt abzurufenQPlaceSearchReply * searchReply =  manager->search(searchRequest);//3) Das Antwortobjekt mit einem Slot verbinden, der bei Abschluss der Operation aufgerufen wirdconnect(searchReply, &QPlaceSearchReply::finished, this, &RequestHandler::processSearchReply); ... ...//4) Der Slot soll die Ergebnisse der Operation angemessen verarbeitenvoid processSearchReply() { if (searchReply->error() == QPlaceReply::NoError) { for(const QPlaceSearchResult &result:  searchReply->results()) { if (result.type() == QPlaceSearchResult::PlaceResult)                qDebug() << "Title:" << result.title();
        } }//5) Verwerfen Sie das verlassene Objekt, wenn Sie fertig sind. searchReply->deleteLater(); searchReply = nullptr; }

Dokumentation der Mitgliedsfunktionen

[virtual noexcept] QPlaceManager::~QPlaceManager()

Zerstört den Manager. Dieser Destruktor wird intern von QGeoServiceProvider verwendet und sollte nie im Anwendungscode aufgerufen werden müssen.

QPlaceCategory QPlaceManager::category(const QString &categoryId) const

Gibt die Kategorie zurück, die der angegebenen categoryId entspricht.

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

Dieses Signal wird ausgegeben, wenn ein category zum Datenspeicher des Managers hinzugefügt wurde. Das Elternteil des category wird durch parentId angegeben.

Dieses Signal wird nur von Managern ausgegeben, die das QPlaceManager::NotificationsFeature unterstützen.

Siehe auch dataChanged().

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

Dieses Signal wird ausgegeben, wenn die Kategorie, die categoryId entspricht, aus dem Datenspeicher des Managers entfernt worden ist. Das Elternteil der entfernten Kategorie wird durch parentId angegeben.

Dieses Signal wird nur von Managern ausgegeben, die das QPlaceManager::NotificationsFeature unterstützen.

Siehe auch dataChanged().

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

Dieses Signal wird ausgegeben, wenn eine category im Datenspeicher des Managers geändert wurde. Das Elternteil der geänderten Kategorie wird durch parentId angegeben.

Dieses Signal wird nur von Managern ausgegeben, die das QPlaceManager::NotificationsFeature unterstützen.

Siehe auch dataChanged().

QList<QPlaceCategory> QPlaceManager::childCategories(const QString &parentId = QString()) const

Gibt eine Liste der Kategorien zurück, die Kinder der Kategorie sind, die parentId entspricht. Ist parentId leer, werden alle Kategorien der obersten Ebene zurückgegeben.

QStringList QPlaceManager::childCategoryIds(const QString &parentId = QString()) const

Gibt die Bezeichner der untergeordneten Kategorien der Kategorie zurück, die parentId entspricht. Wenn parentId leer ist, werden alle Bezeichner der übergeordneten Kategorien zurückgegeben.

QPlace QPlaceManager::compatiblePlace(const QPlace &original) const

Gibt eine gekürzte oder geänderte Version des Ortes original zurück, die sich für die Speicherung in diesem Manager eignet.

In der geänderten Version sind nur Ortsangaben enthalten, die von diesem Manager unterstützt werden. Managerspezifische Daten, wie z. B. die Ortskennung, werden nicht von original übernommen.

[signal] void QPlaceManager::dataChanged()

Dieses Signal wird vom Manager ausgesendet, wenn es umfangreiche Änderungen an seinem zugrunde liegenden Datenspeicher gibt und der Manager diese Änderungen als so radikal ansieht, dass die Clients alle Daten neu laden müssen.

Wenn das Signal ausgesendet wird, werden keine anderen Signale für die damit verbundenen Änderungen ausgesendet.

Dieses Signal wird nur von Managern ausgegeben, die das QPlaceManager::NotificationsFeature unterstützen.

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

Dieses Signal wird ausgegeben, wenn bei der Verarbeitung von reply ein Fehler aufgetreten ist. Wahrscheinlich wird das Signal QPlaceManager::finished() folgen.

Der Fehler wird durch den Fehlercode error beschrieben. Wenn errorString nicht leer ist, enthält es eine textuelle Beschreibung des Fehlers, die für Entwickler und nicht für Endbenutzer bestimmt ist.

Dieses Signal und QPlaceReply::errorOccurred() werden zur gleichen Zeit ausgegeben.

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

Dieses Signal wird ausgegeben, wenn reply die Verarbeitung abgeschlossen hat.

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

Dieses Signal und QPlaceReply::finished() werden zur gleichen Zeit ausgegeben.

QPlaceContentReply *QPlaceManager::getPlaceContent(const QPlaceContentRequest &request) const

Ruft Inhalte für einen Ort entsprechend den in request angegebenen Parametern ab.

Ein Beispiel für die Verwendung finden Sie unter Abrufen von Rich Content.

QPlaceDetailsReply *QPlaceManager::getPlaceDetails(const QString &placeId) const

Ruft die Details eines Ortes ab, der dem angegebenen placeId entspricht.

Siehe Abrufen von Ortsdetails für ein Anwendungsbeispiel.

QPlaceReply *QPlaceManager::initializeCategories()

Initialisiert die Kategorien des Managers.

Siehe Verwendung von Kategorien für ein Anwendungsbeispiel.

QList<QLocale> QPlaceManager::locales() const

Gibt eine Liste der bevorzugten Gebietsschemata zurück. Die Gebietsschemata dienen dem Manager als Hinweis darauf, in welcher Sprache Orts- und Kategoriedetails zurückgegeben werden sollen.

Kann das erste angegebene Gebietsschema nicht berücksichtigt werden, greift der Manager auf das nächste zurück und so weiter. Einige Manager-Backends unterstützen möglicherweise keine fest definierten Gebietsschemata. Ein willkürliches Beispiel ist, dass einige Orte in Frankreich französische und englische Lokalisierungen haben könnten, während in bestimmten Gebieten in Amerika nur die englische Lokalisierung verfügbar ist. In diesem Beispiel ist die Menge der unterstützten Gebietsschemata kontextabhängig vom Suchort.

Wenn der Manager keine der bevorzugten Gebietsschemata unterstützen kann, greift er auf eine unterstützte Sprache zurück, die Backend-spezifisch ist.

Die Unterstützung für Gebietsschemata kann von Anbieter zu Anbieter variieren. Bei Anbietern, die sie unterstützen, wird standardmäßig das globale Standardgebietsschema als einziges Gebietsschema des Managers festgelegt.

Bei Managern, die keine Gebietsschemata unterstützen, ist die Gebietsschema-Liste immer leer.

Siehe auch setLocales().

QString QPlaceManager::managerName() const

Gibt den Namen des Managers zurück

int QPlaceManager::managerVersion() const

Gibt die Version des Managers zurück.

QPlaceMatchReply *QPlaceManager::matchingPlaces(const QPlaceMatchRequest &request) const

Gibt eine Antwort zurück, die eine Liste von Orten enthält, die den in request angegebenen Orten entsprechen/übereinstimmen. Die in der Anfrage angegebenen Orte stammen von einem anderen Verwalter.

QString QPlaceManager::parentCategoryId(const QString &categoryId) const

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

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

Dieses Signal wird ausgegeben, wenn dem Datenspeicher der Manager-Engine ein Ort hinzugefügt wurde. Der bestimmte hinzugefügte Ort wird durch placeId angegeben.

Dieses Signal wird nur von Managern ausgegeben, die das QPlaceManager::NotificationsFeature unterstützen.

Siehe auch dataChanged().

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

Dieses Signal wird ausgegeben, wenn ein Ort aus dem Datenspeicher des Managers entfernt wurde. Der bestimmte Ort, der entfernt wurde, wird durch placeId angegeben.

Dieses Signal wird nur von Managern ausgegeben, die das QPlaceManager::NotificationsFeature unterstützen.

Siehe auch dataChanged().

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

Dieses Signal wird ausgegeben, wenn eine Stelle im Datenspeicher des Managers geändert wurde. Der bestimmte geänderte Ort wird durch placeId angegeben.

Dieses Signal wird nur von Managern ausgegeben, die das QPlaceManager::NotificationsFeature unterstützen.

Siehe auch dataChanged().

QPlaceIdReply *QPlaceManager::removeCategory(const QString &categoryId)

Entfernt die Kategorie, die categoryId entspricht, aus dem Manager.

Siehe Entfernen einer Kategorie für ein Anwendungsbeispiel.

QPlaceIdReply *QPlaceManager::removePlace(const QString &placeId)

Entfernt den Ort, der placeId entspricht, aus dem Manager.

Siehe Entfernen eines Ortes cpp für ein Beispiel zur Verwendung.

QPlaceIdReply *QPlaceManager::saveCategory(const QPlaceCategory &category, const QString &parentId = QString())

Speichert eine category, die eine Unterkategorie der durch parentId angegebenen Kategorie ist. Ein leeres parentId bedeutet, dass category als übergeordnete Kategorie gespeichert wird.

Siehe Speichern einer Kategorie für ein Anwendungsbeispiel.

QPlaceIdReply *QPlaceManager::savePlace(const QPlace &place)

Speichert eine angegebene place.

Siehe Speichern eines Ortes cpp für ein Beispiel zur Verwendung.

QPlaceSearchReply *QPlaceManager::search(const QPlaceSearchRequest &request) const

Sucht nach Orten entsprechend den in request angegebenen Parametern.

Siehe Discovery/Search für ein Beispiel zur Verwendung.

QPlaceSearchSuggestionReply *QPlaceManager::searchSuggestions(const QPlaceSearchRequest &request) const

Fordert eine Reihe von Vorschlägen für Suchbegriffe entsprechend den in request angegebenen Parametern an. Die request kann den unvollständigen Suchbegriff zusammen mit anderen Daten wie einem Suchbereich enthalten, um die relevanten Ergebnisse einzugrenzen.

Siehe Suchvorschläge für ein Beispiel zur Verwendung.

void QPlaceManager::setLocale(const QLocale &locale)

Convenience-Funktion, die die Liste der bevorzugten Gebietsschemata des Managers auf eine einzige locale setzt.

void QPlaceManager::setLocales(const QList<QLocale> &locales)

Legen Sie die Liste der bevorzugten locales fest.

Siehe auch locales().