Sur cette page

QGeoCodeReply Class

La classe `QGeoCodeReply` gère une opération lancée par une instance de ` QGeoCodingManager`. En savoir plus…

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

Types publics

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

Fonctions publiques

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

Signaux

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

Fonctions protégées

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)

Description détaillée

Les instances de QGeoCodeReply gèrent l'état et les résultats de ces opérations.

Les méthodes isFinished(), error() et errorString() indiquent si l'opération est terminée et si elle s'est déroulée avec succès.

Les signaux finished() et errorOccurred(QGeoCodeReply::Error,QString) permettent de suivre la progression de l’opération.

Il est possible qu’un objet `QGeoCodeReply` nouvellement créé soit déjà dans un état « terminé », le plus souvent en raison d’une erreur. Étant donné qu’une telle instance n’émettra jamais les signaux ` finished()` ou ` errorOccurred` (QGeoCodeReply::Error,QString), il est important de vérifier le résultat de ` isFinished()` avant d’établir les connexions aux signaux. La documentation relative à ` QGeoCodingManager ` montre comment procéder.

Si l'opération aboutit, les résultats seront accessibles via la fonction ` locations()`.

Documentation sur les types de membres

enum QGeoCodeReply::Error

Décrit une erreur qui a empêché la réalisation de l'opération.

ConstanteValeurDescription
QGeoCodeReply::NoError0Aucune erreur ne s'est produite.
QGeoCodeReply::EngineNotSetError1Le gestionnaire de géocodage utilisé n'était pas associé à une instance d'QGeoCodingManagerEngine.
QGeoCodeReply::CommunicationError2Une erreur s'est produite lors de la communication avec le fournisseur de services.
QGeoCodeReply::ParseError3La réponse du fournisseur de services était dans un format non reconnaissable.
QGeoCodeReply::UnsupportedOptionError4L'opération demandée ou l'une des options de cette opération n'est pas prise en charge par le fournisseur de services.
QGeoCodeReply::CombinationError5Une erreur s'est produite lors de la fusion des résultats provenant de plusieurs sources.
QGeoCodeReply::UnknownError6Une erreur s'est produite qui n'entre dans aucune des autres catégories.

Documentation des fonctions membres

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

Génère une réponse de géocodage à partir de l'parent. spécifiée.

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

Génère une réponse de géocodage à partir d'une adresse error et d'un code postal errorString, ainsi que de l'adresse parent spécifiée.

[virtual noexcept] QGeoCodeReply::~QGeoCodeReply()

Supprime cet objet de réponse.

[virtual] void QGeoCodeReply::abort()

Annule immédiatement l'opération.

Cela n'aura aucun effet si la réponse est déjà terminée.

Voir également aborted().

[signal] void QGeoCodeReply::aborted()

Ce signal est émis lorsque l'opération a été annulée.

Voir également abort().

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

Ajoute location à la liste des lieux figurant dans cette réponse.

QGeoCodeReply::Error QGeoCodeReply::error() const

Renvoie l'état d'erreur de cette réponse.

Si le résultat est « QGeoCodeReply::NoError », cela signifie qu'aucune erreur ne s'est produite.

Voir également setError().

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

Ce signal est émis lorsqu'une erreur a été détectée lors du traitement de cette réponse. Le signal ` finished()` suivra probablement.

L'erreur sera décrite par le code d'erreur error. Si errorString n'est pas vide, il contiendra une description textuelle de l'erreur.

Ce signal et QGeoCodingManager::errorOccurred() seront émis simultanément.

Remarque : ne supprimez pas cet objet de réponse dans le slot associé à ce signal. Utilisez plutôt deleteLater().

QString QGeoCodeReply::errorString() const

Renvoie la représentation textuelle de l'état d'erreur de cette réponse.

Si aucune erreur ne s'est produite, cette fonction renvoie une chaîne vide. Il est possible qu'une erreur se soit produite sans qu'il y ait de représentation textuelle associée ; dans ce cas, la fonction renvoie également une chaîne vide.

Pour déterminer si une erreur s'est produite, vérifiez si ` QGeoCodeReply::error()` est égal à ` QGeoCodeReply::NoError`.

[signal] void QGeoCodeReply::finished()

Ce signal est émis lorsque le traitement de cette réponse est terminé.

Si error() est égal à QGeoCodeReply::NoError, cela signifie que le traitement s'est terminé avec succès.

Ce signal et la fonction QGeoCodingManager::finished() seront émis simultanément.

Remarque : ne supprimezpas cet objet « reply » dans le slot connecté à ce signal. Utilisez plutôt la fonction deleteLater().

Voir également setFinished().

bool QGeoCodeReply::isFinished() const

Renvoie « true » si l'opération s'est déroulée avec succès ou si une erreur est survenue, entraînant l'interruption de l'opération.

qsizetype QGeoCodeReply::limit() const

Renvoie la limite du nombre de réponses provenant de chaque source de données.

Si aucune limite n'a été définie, cette fonction renvoie -1.

Ce nombre peut être supérieur à ` locations()`.`length()` si le nombre de réponses était inférieur au nombre demandé.

Voir également setLimit().

QList<QGeoLocation> QGeoCodeReply::locations() const

Renvoie une liste d'emplacements.

Ces emplacements correspondent aux résultats de l'opération associée à la fonction QGeoCodingManager qui a généré cette réponse.

Voir également setLocations().

qsizetype QGeoCodeReply::offset() const

Renvoie l'offset dans l'ensemble de résultats complet à partir duquel commencer à extraire les résultats.

Voir également la fonction setOffset().

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

Définit l'état d'erreur de cette réponse sur « error » et la représentation textuelle de l'erreur sur « errorString ».

Cela provoquera également l'émission des signaux errorOccurred() et finished(), dans cet ordre.

Voir également error().

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

Détermine si cette réponse à finished est terminée ou non.

Si finished est vrai, cela provoquera l'émission du signal finished().

Si l’opération s’est terminée avec succès, la fonction QGeoCodeReply::setLocations() doit être appelée avant cette fonction. Si une erreur s’est produite, il convient d’utiliser QGeoCodeReply::setError() à la place.

Voir également finished().

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

Définit la limite du nombre de réponses provenant de chaque source de données à limit.

Si limit vaut -1, toutes les réponses disponibles seront renvoyées.

Voir également limit().

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

Définit la liste des « locations » dans la réponse.

Voir aussi locations().

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

Définit l'offset dans l'ensemble des résultats à partir duquel commencer à récupérer les résultats à l'adresse offset.

Voir également offset().

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

Définit la fenêtre d'affichage contenant les résultats sur viewport.

Voir aussi viewport().

QGeoShape QGeoCodeReply::viewport() const

Renvoie la fenêtre d'affichage contenant les résultats.

Cette fonction renvoie « nullptr » si aucun décalage de fenêtre d'affichage n'a été spécifié dans la fonction « QGeoCodingManager » qui a généré cette réponse.

Voir également 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.