Sur cette page

QGeoAddress Class

La classe QGeoAddress représente l'adresse d'un site QGeoLocation. Plus....

En-tête : #include <QGeoAddress>
CMake : find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake : QT += positioning

Fonctions publiques

QGeoAddress()
QGeoAddress(const QGeoAddress &other)
(since 6.2) QGeoAddress(QGeoAddress &&other)
~QGeoAddress()
QString city() const
void clear()
QString country() const
QString countryCode() const
QString county() const
QString district() const
bool isEmpty() const
bool isTextGenerated() const
QString postalCode() const
void setCity(const QString &city)
void setCountry(const QString &country)
void setCountryCode(const QString &countryCode)
void setCounty(const QString &county)
void setDistrict(const QString &district)
void setPostalCode(const QString &postalCode)
void setState(const QString &state)
void setStreet(const QString &street)
(since 6.2) void setStreetNumber(const QString &streetNumber)
void setText(const QString &text)
QString state() const
QString street() const
(since 6.2) QString streetNumber() const
(since 6.2) void swap(QGeoAddress &other)
QString text() const
(since 6.2) QGeoAddress &operator=(QGeoAddress &other)
QGeoAddress &operator=(const QGeoAddress &address)
size_t qHash(const QGeoAddress &address, size_t seed = 0)
bool operator!=(const QGeoAddress &lhs, const QGeoAddress &rhs)
bool operator==(const QGeoAddress &lhs, const QGeoAddress &rhs)

Description détaillée

Les attributs de l'adresse sont normalisés en noms d'entités américaines et peuvent être mis en correspondance avec les niveaux d'entités locales (par exemple, l'État correspond au "Bundesland" en Allemagne).

L'adresse contient un text() à des fins d'affichage et des propriétés supplémentaires permettant d'accéder aux composants d'une adresse :

Documentation des fonctions membres

QGeoAddress::QGeoAddress()

Constructeur par défaut.

QGeoAddress::QGeoAddress(const QGeoAddress &other)

Construit une copie de other.

[constexpr noexcept, since 6.2] QGeoAddress::QGeoAddress(QGeoAddress &&other)

Construit un objet adresse géographique en le déplaçant de other.

Note : L'objet QGeoAddress déplacé ne peut être que détruit ou assigné. L'effet de l'appel à d'autres fonctions que le destructeur ou l'un des opérateurs d'affectation n'est pas défini.

Cette fonction a été introduite dans Qt 6.2.

[noexcept] QGeoAddress::~QGeoAddress()

Détruit cette adresse.

QString QGeoAddress::city() const

Renvoie la ville.

Voir aussi setCity().

void QGeoAddress::clear()

Efface tous les champs de données de l'adresse.

QString QGeoAddress::country() const

Renvoie le nom du pays.

Voir aussi setCountry().

QString QGeoAddress::countryCode() const

Renvoie le code pays selon la norme ISO 3166-1 alpha-3

Voir aussi setCountryCode().

QString QGeoAddress::county() const

Renvoie le comté. Le comté est considéré comme la deuxième subdivision après le pays.

Voir également setCounty().

QString QGeoAddress::district() const

Renvoie le district. Le district est considéré comme la subdivision inférieure à la ville.

Voir aussi setDistrict().

bool QGeoAddress::isEmpty() const

Indique si l'adresse est vide. Une adresse est considérée comme vide si tous ses champs sont vides.

bool QGeoAddress::isTextGenerated() const

Retourne vrai si QGeoAddress::text() est généré automatiquement à partir d'éléments d'adresse, sinon retourne faux si text() a été explicitement assigné.

Voir aussi text() et setText().

QString QGeoAddress::postalCode() const

Renvoie le code postal.

Voir aussi setPostalCode().

void QGeoAddress::setCity(const QString &city)

Définit la valeur de city.

Voir aussi city().

void QGeoAddress::setCountry(const QString &country)

Définit le nom de country.

Voir aussi country().

void QGeoAddress::setCountryCode(const QString &countryCode)

Définit l'adresse countryCode selon la norme ISO 3166-1 alpha-3

Voir aussi countryCode().

void QGeoAddress::setCounty(const QString &county)

Définit la valeur de county.

Voir aussi county().

void QGeoAddress::setDistrict(const QString &district)

Définit la valeur de district.

Voir aussi district().

void QGeoAddress::setPostalCode(const QString &postalCode)

Définit la valeur de postalCode.

Voir aussi postalCode().

void QGeoAddress::setState(const QString &state)

Définit la valeur de state.

Voir aussi state().

void QGeoAddress::setStreet(const QString &street)

Définit le nom de la rue à street.

Remarque : avant Qt6, ce nom pouvait également contenir des éléments tels qu'un numéro d'unité, un nom de bâtiment ou tout autre élément permettant de distinguer une adresse d'une autre. Utilisez setStreetNumber() pour définir ces données maintenant.

Voir aussi street() et setStreetNumber().

[since 6.2] void QGeoAddress::setStreetNumber(const QString &streetNumber)

Définit le numéro de rue à streetNumber.

Ce numéro peut également contenir des éléments tels qu'un numéro d'unité, un nom de bâtiment ou tout autre élément permettant de distinguer une adresse d'une autre.

Remarque : avant Qt6, cette information était définie par la méthode setStreet().

Cette fonction a été introduite dans Qt 6.2.

Voir aussi streetNumber() et setStreet().

void QGeoAddress::setText(const QString &text)

Si text n'est pas vide, attribue explicitement à text la chaîne à renvoyer par text(). isTextGenerated() renvoie un message faux.

Si text est vide, indique que text() doit être généré automatiquement à partir des éléments d'adresse. isTextGenerated() renverra true.

Voir également text().

QString QGeoAddress::state() const

Renvoie l'état. L'état est considéré comme la première subdivision en dessous du pays.

Voir aussi setState().

QString QGeoAddress::street() const

Renvoie le nom de la rue.

Remarque : avant Qt6, ce nom pouvait également contenir des éléments tels qu'un numéro d'unité, un nom de bâtiment ou tout autre élément permettant de distinguer une adresse d'une autre. Utilisez streetNumber() pour obtenir ces données maintenant.

Voir aussi setStreet() et streetNumber().

[since 6.2] QString QGeoAddress::streetNumber() const

Renvoie le numéro de rue.

Ce numéro peut également contenir des éléments tels qu'un numéro d'unité, un nom de bâtiment ou tout autre élément permettant de distinguer une adresse d'une autre.

Remarque : avant Qt6, cette information était renvoyée par la méthode street().

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setStreetNumber() et street().

[noexcept, since 6.2] void QGeoAddress::swap(QGeoAddress &other)

Remplace cette adresse par other. Cette opération est très rapide et n'échoue jamais.

Cette fonction a été introduite dans Qt 6.2.

QString QGeoAddress::text() const

Renvoie l'adresse sous la forme d'une seule chaîne formatée. Il s'agit de la chaîne qu'il est recommandé d'utiliser pour afficher l'adresse à l'utilisateur. Elle prend généralement le format d'une adresse telle qu'on la trouve sur une enveloppe, mais ce n'est pas toujours le cas.

Le texte de l'adresse est soit généré automatiquement, soit attribué explicitement. Ceci peut être déterminé en vérifiant isTextGenerated.

Si une chaîne vide est fournie à setText(), alors isTextGenerated() sera mis à true et text() renverra une chaîne formatée localement conformément à countryCode() et basée sur les éléments de l'adresse tels que la rue, la ville, etc. La chaîne de texte étant générée à partir des éléments de l'adresse, une séquence d'appels tels que text(), setStreet(), text() peut renvoyer des chaînes différentes à chaque invocation de text().

Si une chaîne non vide est fournie à setText(), isTextGenerated() devient false et text() renvoie toujours la chaîne explicitement attribuée. Les appels visant à modifier d'autres éléments tels que setStreet(), setCity(), etc. n'affecteront pas la chaîne de caractères résultant de text().

Voir aussi setText().

[default, since 6.2] QGeoAddress &QGeoAddress::operator=(QGeoAddress &other)

Move - assigne l'objet other à cette adresse et renvoie une référence à cette adresse.

Remarque : l'objet QGeoAddress déplacé ne peut être que détruit ou assigné. L'effet de l'appel à d'autres fonctions que le destructeur ou l'un des opérateurs d'affectation n'est pas défini.

Cette fonction a été introduite dans Qt 6.2.

QGeoAddress &QGeoAddress::operator=(const QGeoAddress &address)

Attribue l'adresse address à cette adresse et renvoie une référence à cette adresse.

Non-membres apparentés

[noexcept] size_t qHash(const QGeoAddress &address, size_t seed = 0)

Renvoie la valeur de hachage pour address, en utilisant seed pour le calcul.

bool operator!=(const QGeoAddress &lhs, const QGeoAddress &rhs)

Renvoie true si l'adresse lhs n'est pas égale à rhs, sinon renvoie false.

bool operator==(const QGeoAddress &lhs, const QGeoAddress &rhs)

Renvoie true si l'adresse lhs est égale à rhs, sinon renvoie false.

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