Auf dieser Seite

QGeoCodeReply Class

Die Klasse „QGeoCodeReply“ verwaltet einen Vorgang, der von einer Instanz von „ QGeoCodingManager “ gestartet wurde. Mehr...

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

Öffentliche Typen

enum Error { NoError, EngineNotSetError, CommunicationError, ParseError, UnsupportedOptionError, …, UnknownError }

Öffentliche Funktionen

QGeoCodeReply(QGeoCodeReply::Error error, const QString &errorString, QObject *parent = nullptr)
virtual ~QGeoCodeReply()
virtual void abort()
QGeoCodeReply::Error error() const
QString errorString() const
bool isFinished() const
qsizetype limit() const
QList<QGeoLocation> locations() const
qsizetype offset() const
QGeoShape viewport() const

Signale

void aborted()
void errorOccurred(QGeoCodeReply::Error error, const QString &errorString = QString())
void finished()

Geschützte Funktionen

QGeoCodeReply(QObject *parent = nullptr)
void addLocation(const QGeoLocation &location)
void setError(QGeoCodeReply::Error error, const QString &errorString)
void setFinished(bool finished)
void setLimit(qsizetype limit)
void setLocations(const QList<QGeoLocation> &locations)
void setOffset(qsizetype offset)
void setViewport(const QGeoShape &viewport)

Detaillierte Beschreibung

Instanzen von QGeoCodeReply verwalten den Status und die Ergebnisse dieser Operationen.

Die Methoden „ isFinished()“, „ error()“ und „ errorString()“ geben Auskunft darüber, ob die Operation abgeschlossen wurde und ob sie erfolgreich war.

Die Signale „ finished()“ und „ errorOccurred(QGeoCodeReply::Error,QString)“ können verwendet werden, um den Fortschritt der Operation zu überwachen.

Es ist möglich, dass sich ein neu erstelltes `QGeoCodeReply`-Objekt bereits im Status „finished“ befindet, was meist darauf zurückzuführen ist, dass ein Fehler aufgetreten ist. Da eine solche Instanz niemals die Signale ` finished()` oder ` errorOccurred` (`QGeoCodeReply::Error`, `QString`) aussendet, ist es wichtig, das Ergebnis von ` isFinished()` zu überprüfen, bevor Verbindungen zu den Signalen hergestellt werden. Die Dokumentation zu ` QGeoCodingManager ` veranschaulicht, wie dies durchgeführt werden kann.

Wenn der Vorgang erfolgreich abgeschlossen wurde, können die Ergebnisse mit ` locations()` abgerufen werden.

Dokumentation zu Mitgliedstypen

enum QGeoCodeReply::Error

Beschreibt einen Fehler, der den Abschluss des Vorgangs verhindert hat.

KonstanteWertBeschreibung
QGeoCodeReply::NoError0Es ist kein Fehler aufgetreten.
QGeoCodeReply::EngineNotSetError1Dem verwendeten Geokodierungsmanager war keine „ QGeoCodingManagerEngine “-Instanz zugeordnet.
QGeoCodeReply::CommunicationError2Bei der Kommunikation mit dem Dienstanbieter ist ein Fehler aufgetreten.
QGeoCodeReply::ParseError3Die Antwort des Dienstanbieters lag in einem nicht erkennbaren Format vor.
QGeoCodeReply::UnsupportedOptionError4Der angeforderte Vorgang oder eine der Optionen für den Vorgang wird vom Dienstanbieter nicht unterstützt.
QGeoCodeReply::CombinationError5Beim Zusammenführen der Ergebnisse aus mehreren Quellen ist ein Fehler aufgetreten.
QGeoCodeReply::UnknownError6Es ist ein Fehler aufgetreten, der keiner der anderen Kategorien zuzuordnen ist.

Dokumentation der Mitgliedsfunktionen

[explicit protected] QGeoCodeReply::QGeoCodeReply(QObject *parent = nullptr)

Erstellt eine Geokodierungsantwort mit dem angegebenen „ parent “.

[explicit] QGeoCodeReply::QGeoCodeReply(QGeoCodeReply::Error error, const QString &errorString, QObject *parent = nullptr)

Erstellt eine Geokodierungsantwort mit den angegebenen Werten für „ error “ und „ errorString “ sowie dem angegebenen „ parent “.

[virtual noexcept] QGeoCodeReply::~QGeoCodeReply()

Löscht dieses Antwortobjekt.

[virtual] void QGeoCodeReply::abort()

Bricht den Vorgang sofort ab.

Dies hat keine Auswirkungen, wenn die Antwort bereits abgeschlossen ist.

Siehe auch „ aborted()“.

[signal] void QGeoCodeReply::aborted()

Dieses Signal wird ausgegeben, wenn der Vorgang abgebrochen wurde.

Siehe auch „ abort“ ().

[protected] void QGeoCodeReply::addLocation(const QGeoLocation &location)

Fügt „ location “ zur Liste der Orte in dieser Antwort hinzu.

QGeoCodeReply::Error QGeoCodeReply::error() const

Gibt den Fehlerstatus dieser Antwort zurück.

Wenn das Ergebnis „ QGeoCodeReply::NoError “ lautet, ist kein Fehler aufgetreten.

Siehe auch „ setError()“.

[signal] void QGeoCodeReply::errorOccurred(QGeoCodeReply::Error error, const QString &errorString = QString())

Dieses Signal wird ausgegeben, wenn bei der Verarbeitung dieser Antwort ein Fehler festgestellt wurde. Das Signal „ finished()“ wird voraussichtlich folgen.

Der Fehler wird durch den Fehlercode ` error` beschrieben. Ist ` errorString ` nicht leer, enthält es eine textuelle Beschreibung des Fehlers.

Dieses Signal und „ QGeoCodingManager::errorOccurred()“ werden gleichzeitig ausgelöst.

Hinweis: LöschenSie dieses Antwortobjekt nicht in dem mit diesem Signal verbundenen Slot. Verwenden Sie stattdessen deleteLater().

QString QGeoCodeReply::errorString() const

Gibt die textuelle Darstellung des Fehlerzustands dieser Antwort zurück.

Wenn kein Fehler aufgetreten ist, wird eine leere Zeichenkette zurückgegeben. Es ist möglich, dass ein Fehler aufgetreten ist, für den keine textuelle Darstellung vorhanden ist; in diesem Fall wird ebenfalls eine leere Zeichenkette zurückgegeben.

Um festzustellen, ob ein Fehler aufgetreten ist, prüfen Sie, ob ` QGeoCodeReply::error()` gleich ` QGeoCodeReply::NoError` ist.

[signal] void QGeoCodeReply::finished()

Dieses Signal wird ausgegeben, sobald die Verarbeitung dieser Antwort abgeschlossen ist.

Wenn ` error()` gleich ` QGeoCodeReply::NoError ` ist, wurde die Verarbeitung erfolgreich abgeschlossen.

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

Hinweis: LöschenSie dieses Antwortobjekt nicht in dem mit diesem Signal verbundenen Slot. Verwenden Sie stattdessen deleteLater().

Siehe auch „ setFinished()“.

bool QGeoCodeReply::isFinished() const

Gibt „true“ zurück, wenn der Vorgang erfolgreich abgeschlossen wurde oder ein Fehler aufgetreten ist, der den Vorgang unterbrochen hat.

qsizetype QGeoCodeReply::limit() const

Gibt die Obergrenze für die Anzahl der Antworten aus jeder Datenquelle zurück.

Wenn keine Begrenzung festgelegt wurde, gibt diese Funktion -1 zurück.

Dieser Wert kann größer sein als ` locations()`.`length()`, wenn die Anzahl der Antworten geringer war als die angeforderte Anzahl.

Siehe auch ` setLimit()`.

QList<QGeoLocation> QGeoCodeReply::locations() const

Gibt eine Liste von Standorten zurück.

Die Standorte sind die Ergebnisse der Operation, die der Funktion ` QGeoCodingManager ` entspricht, durch die diese Antwort erstellt wurde.

Siehe auch „ setLocations()“.

qsizetype QGeoCodeReply::offset() const

Gibt den Offset innerhalb der gesamten Ergebnismenge zurück, an dem mit dem Abrufen der Ergebnisse begonnen werden soll.

Siehe auch ` setOffset()`.

[protected] void QGeoCodeReply::setError(QGeoCodeReply::Error error, const QString &errorString)

Setzt den Fehlerstatus dieser Antwort auf „ error “ und die textuelle Darstellung des Fehlers auf „ errorString “.

Dadurch werden außerdem die Signale „ errorOccurred()“ und „ finished()“ in dieser Reihenfolge ausgelöst.

Siehe auch error().

[protected] void QGeoCodeReply::setFinished(bool finished)

Legt fest, ob diese Antwort an finished abgeschlossen ist oder nicht.

Ist ` finished ` wahr, wird das Signal ` finished()` ausgelöst.

Wenn der Vorgang erfolgreich abgeschlossen wurde, sollte vor dieser Funktion „ QGeoCodeReply::setLocations()“ aufgerufen werden. Ist ein Fehler aufgetreten, sollte stattdessen „ QGeoCodeReply::setError()“ verwendet werden.

Siehe auch ` finished()`.

[protected] void QGeoCodeReply::setLimit(qsizetype limit)

Legt die Obergrenze für die Anzahl der Antworten aus jeder Datenquelle auf „ limit “ fest.

Ist limit gleich -1, werden alle verfügbaren Antworten zurückgegeben.

Siehe auch limit().

[protected] void QGeoCodeReply::setLocations(const QList<QGeoLocation> &locations)

Legt die Liste der „ locations “ in der Antwort fest.

Siehe auch „ locations()“.

[protected] void QGeoCodeReply::setOffset(qsizetype offset)

Legt den Offset in der gesamten Ergebnismenge fest, ab dem das Abrufen der Ergebnisse von offset beginnen soll.

Siehe auch offset().

[protected] void QGeoCodeReply::setViewport(const QGeoShape &viewport)

Legt den Ansichtsbereich, der die Ergebnisse enthält, auf „ viewport “ fest.

Siehe auch viewport().

QGeoShape QGeoCodeReply::viewport() const

Gibt den Viewport zurück, der die Ergebnisse enthält.

Diese Funktion gibt „ nullptr “ zurück, wenn in der Funktion „ QGeoCodingManager “, die diese Antwort erzeugt hat, kein Viewport-Bias angegeben wurde.

Siehe auch ` setViewport()`.

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