Sur cette page

QGeoAddress Class

La classe QGeoAddress représente l'adresse d'un objet de type « QGeoLocation ». En savoir 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 selon la nomenclature américaine et peuvent être mis en correspondance avec les niveaux d'entités locaux (par exemple, « State » correspond à « Bundesland » en Allemagne).

L'adresse contient une méthode « text() » à des fins d'affichage, ainsi que des propriétés supplémentaires permettant d'accéder aux composants d'une adresse :

Documentation sur les fonctions membres

QGeoAddress::QGeoAddress()

Constructeur par défaut.

QGeoAddress::QGeoAddress(const QGeoAddress &other)

Crée une copie de other.

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

Crée un objet d'adresse géographique à partir de l'objet « other ».

Remarque : l'objet `QGeoAddress` d'où provient la valeur ne peut être que détruit ou affecté. L'effet de l'appel à des fonctions autres que le destructeur ou l'un des opérateurs d'affectation est indéfini.

Cette fonction a été introduite dans Qt 6.2.

[noexcept] QGeoAddress::~QGeoAddress()

Supprime cette adresse.

QString QGeoAddress::city() const

Renvoie le nom de 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 conforme à la norme ISO 3166-1 alpha-3

Voir aussi setCountryCode().

QString QGeoAddress::county() const

Renvoie le nom du comté. Le comté est considéré comme la deuxième subdivision hiérarchique en dessous du pays.

Voir également setCounty().

QString QGeoAddress::district() const

Renvoie le nom du district. Le district est considéré comme la subdivision située au niveau inférieur à celui de la ville.

Voir également setDistrict().

bool QGeoAddress::isEmpty() const

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

bool QGeoAddress::isTextGenerated() const

Renvoie « true » si QGeoAddress::text() est généré automatiquement à partir des éléments d'adresse ; sinon, renvoie « false » si text() a été explicitement attribué.

Voir également text() et setText().

QString QGeoAddress::postalCode() const

Renvoie le code postal.

Voir aussi setPostalCode().

void QGeoAddress::setCity(const QString &city)

Définit la propriété « city ».

Voir aussi city().

void QGeoAddress::setCountry(const QString &country)

Définit le nom de l'country.

Voir aussi country().

void QGeoAddress::setCountryCode(const QString &countryCode)

Définit le code « countryCode » conformément à la norme ISO 3166-1 alpha-3

Voir aussi countryCode().

void QGeoAddress::setCounty(const QString &county)

Définit la propriété « county ».

Voir aussi county().

void QGeoAddress::setDistrict(const QString &district)

Définit la propriété « district ».

Voir aussi district().

void QGeoAddress::setPostalCode(const QString &postalCode)

Définit la propriété « postalCode ».

Voir aussi postalCode().

void QGeoAddress::setState(const QString &state)

Définit la propriété state.

Voir aussi state().

void QGeoAddress::setStreet(const QString &street)

Définit le nom de la rue sur « street ».

Remarque : avant Qt6, cette valeur pouvait également contenir des éléments tels qu'un numéro d'appartement, le nom d'un immeuble ou tout autre élément permettant de distinguer une adresse d'une autre. Utilisez désormais la fonction setStreetNumber() pour définir ces données.

Voir également ` street()` et ` setStreetNumber()`.

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

Définit le numéro de rue sur « streetNumber ».

Ce paramètre peut également contenir des éléments tels qu’un numéro d’appartement, le nom d’un immeuble ou tout autre élément permettant de distinguer une adresse d’une autre.

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

Cette fonction a été introduite dans Qt 6.2.

Voir également ` streetNumber()` et ` setStreet()`.

void QGeoAddress::setText(const QString &text)

Si ` text ` n'est pas vide, attribue explicitement ` text ` comme chaîne à renvoyer par ` text()`. ` isTextGenerated()` renverra `false`.

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

Voir également text().

QString QGeoAddress::state() const

Renvoie l'État. L'État correspond au premier niveau de subdivision inférieur au pays.

Voir également setState().

QString QGeoAddress::street() const

Renvoie le nom de la rue.

Remarque : avant Qt6, cette fonction pouvait également contenir des informations telles qu'un numéro d'unité, le nom d'un immeuble ou tout autre élément permettant de distinguer une adresse d'une autre. Utilisez désormais streetNumber() pour obtenir ces données.

Voir également setStreet() et streetNumber().

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

Renvoie le numéro de rue.

Ce paramètre peut également contenir des informations telles que le numéro d'appartement, le nom du bâtiment ou tout autre élément permettant de distinguer une adresse d'une autre.

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

Cette fonction a été introduite dans Qt 6.2.

Voir également ` setStreetNumber()` et ` street()`.

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

Permute cette adresse avec celle de other. Cette opération est très rapide et ne rate jamais.

Cette fonction a été introduite dans Qt 6.2.

QString QGeoAddress::text() const

Renvoie l'adresse sous la forme d'une chaîne de caractères formatée unique. Il s'agit de la chaîne recommandée pour afficher l'adresse à l'utilisateur. Elle reprend généralement le format d'une adresse telle qu'elle figure 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. Pour le déterminer, il suffit de vérifier la valeur de ` isTextGenerated`.

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

Si une chaîne non vide est fournie à ` setText()`, alors ` isTextGenerated()` sera défini sur ` false ` et `text()` renverra 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 résultante de `text()`.

Voir également setText().

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

La fonction « move » attribue l’ other à cette adresse et renvoie une référence à cette adresse.

Remarque : l' QGeoAddress e d'origine ne peut être ni détruite ni affectée. L'effet de l'appel à des fonctions autres que le destructeur ou l'un des opérateurs d'affectation est indéfini.

Cette fonction a été introduite dans Qt 6.2.

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

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

Éléments non membres associés

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

Renvoie la valeur de hachage de l'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.