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.
| Constante | Valeur | Description de l'erreur |
|---|---|---|
QGeoCodeReply::NoError | 0 | Aucune erreur n'est survenue. |
QGeoCodeReply::EngineNotSetError | 1 | Le gestionnaire de géocodage utilisé n'était pas associé à une instance QGeoCodingManagerEngine. |
QGeoCodeReply::CommunicationError | 2 | Une erreur s'est produite lors de la communication avec le fournisseur de services. |
QGeoCodeReply::ParseError | 3 | La réponse du fournisseur de services était dans un format non reconnaissable. |
QGeoCodeReply::UnsupportedOptionError | 4 | L'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::CombinationError | 5 | Une erreur s'est produite lors de la combinaison de résultats provenant de plusieurs sources. |
QGeoCodeReply::UnknownError | 6 | Une 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.