Sur cette page

QGeoCodeReply Class

La classe QGeoCodeReply gère une opération lancée par une instance de QGeoCodingManager. 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) peuvent être utilisés pour surveiller la progression de l'opération.

Il est possible qu'un QGeoCodeReply nouvellement créé soit dans un état terminé, le plus souvent parce qu'une erreur s'est produite. Comme 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 avec les signaux. La documentation relative à QGeoCodingManager montre comment procéder.

Si l'opération se termine avec succès, les résultats seront accessibles avec locations().

Documentation sur les types de membres

enum QGeoCodeReply::Error

Décrit une erreur qui a empêché l'achèvement de l'opération.

ConstanteValeurDescription de l'erreur
QGeoCodeReply::NoError0Aucune erreur n'est survenue.
QGeoCodeReply::EngineNotSetError1Le gestionnaire de géocodage utilisé n'était pas associé à une instance 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 l'opération n'est pas prise en charge par le fournisseur de services.
QGeoCodeReply::CombinationError5Une erreur s'est produite lors de la combinaison de 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)

Construit une réponse géocodée avec l'adresse parent spécifiée.

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

Construit une réponse géocodée avec un error et un errorString donnés et le parent spécifié.

[virtual noexcept] QGeoCodeReply::~QGeoCodeReply()

Détruit cet objet de réponse.

[virtual] void QGeoCodeReply::abort()

Annule l'opération immédiatement.

Cela ne fera rien si la réponse est terminée.

Voir aussi aborted().

[signal] void QGeoCodeReply::aborted()

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

Voir aussi abort().

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

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

QGeoCodeReply::Error QGeoCodeReply::error() const

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

Si le résultat est QGeoCodeReply::NoError, aucune erreur ne s'est produite.

Voir aussi setError().

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

Ce signal est émis lorsqu'une erreur a été détectée dans le 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 en même temps.

Remarque : ne supprimez pas cet objet de réponse dans le slot connecté à 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, le message renvoie une chaîne vide. Il est possible qu'une erreur se soit produite et qu'elle n'ait pas de représentation textuelle associée, auquel cas la réponse renverra également une chaîne vide.

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

[signal] void QGeoCodeReply::finished()

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

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

Ce signal et QGeoCodingManager::finished() seront émis en même temps.

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

Voir aussi setFinished().

bool QGeoCodeReply::isFinished() const

Retourne vrai si l'opération s'est terminée avec succès ou si elle a rencontré une erreur qui a entraîné l'arrêt de l'opération.

qsizetype QGeoCodeReply::limit() const

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

Si aucune limite n'a été fixée, cette fonction renvoie -1.

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

Voir également setLimit().

QList<QGeoLocation> QGeoCodeReply::locations() const

Renvoie une liste de lieux.

Les emplacements sont les résultats de l'opération correspondant à la fonction QGeoCodingManager qui a créé cette réponse.

Voir aussi setLocations().

qsizetype QGeoCodeReply::offset() const

Renvoie le décalage dans l'ensemble des résultats à partir duquel il faut commencer à récupérer les résultats.

Voir aussi setOffset().

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

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

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

Voir aussi error().

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

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

Si finished est vrai, le signal finished() sera émis.

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

Voir aussi finished().

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

Fixe la limite du nombre de réponses de chaque source de données à limit.

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

Voir aussi limit().

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

Définit la liste de locations dans la réponse.

Voir aussi locations().

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

Définit le décalage dans l'ensemble des résultats à partir duquel le résultat doit commencer à être récupéré sur offset.

Voir aussi offset().

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

Définit la fenêtre de visualisation qui contient les résultats à viewport.

Voir aussi viewport().

QGeoShape QGeoCodeReply::viewport() const

Renvoie la fenêtre qui contient les résultats.

Cette fonction renvoie nullptr si aucun biais de fenêtre n'a été spécifié dans la fonction QGeoCodingManager qui a créé cette réponse.

Voir aussi 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.