Sur cette page

QGeoLocation Class

La classe QGeoLocation contient des informations de base sur un lieu. En savoir plus...

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

Fonctions publiques

QGeoLocation()
QGeoLocation(const QGeoLocation &other)
(since 6.2) QGeoLocation(QGeoLocation &&other)
~QGeoLocation()
QGeoAddress address() const
(since 6.2) QGeoShape boundingShape() const
QGeoCoordinate coordinate() const
QVariantMap extendedAttributes() const
bool isEmpty() const
void setAddress(const QGeoAddress &address)
(since 6.2) void setBoundingShape(const QGeoShape &boundingShape)
void setCoordinate(const QGeoCoordinate &coordinate)
void setExtendedAttributes(const QVariantMap &data)
(since 6.2) void swap(QGeoLocation &other)
(since 6.2) QGeoLocation &operator=(QGeoLocation &&other)
QGeoLocation &operator=(const QGeoLocation &other)
size_t qHash(const QGeoLocation &location, size_t seed = 0)
bool operator!=(const QGeoLocation &lhs, const QGeoLocation &rhs)
bool operator==(const QGeoLocation &lhs, const QGeoLocation &rhs)

Description détaillée

Un objet QGeoLocation se compose d’une coordonnée et de l’adresse correspondante, ainsi que d’une forme de délimitation facultative, qui correspond à la zone recommandée à afficher lors de la visualisation de l’emplacement.

Documentation des fonctions membres

QGeoLocation::QGeoLocation()

Crée un nouvel objet de localisation.

QGeoLocation::QGeoLocation(const QGeoLocation &other)

Crée une copie de other

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

Crée un objet de géolocalisation à partir de l'objet « other ».

Remarque : l'objet `QGeoLocation` à partir duquel la création a été effectuée ne peut être que détruit ou affecté. L'effet de l'appel à d'autres fonctions que le destructeur ou l'un des opérateurs d'affectation est indéfini.

Cette fonction a été introduite dans Qt 6.2.

[noexcept] QGeoLocation::~QGeoLocation()

Supprime l'objet « emplacement ».

QGeoAddress QGeoLocation::address() const

Renvoie l'adresse de l'emplacement.

Voir aussi setAddress().

[since 6.2] QGeoShape QGeoLocation::boundingShape() const

Renvoie une forme englobante qui représente la zone recommandée à afficher lors de la visualisation de cet emplacement.

Par exemple, l'emplacement d'un bâtiment peut correspondre à une zone centrée sur celui-ci, mais suffisamment étendue pour montrer son contexte géographique immédiat.

Remarque : cette méthode a été introduite dans Qt6 en remplacement de la méthode `boundingBox()`. Elle renvoie un objet ` QGeoShape ` au lieu d'un objet ` QGeoRectangle`. Utilisez la méthode ` QGeoShape::boundingGeoRectangle()` pour obtenir une ` QGeoRectangle ` englobante pour la forme.

Cette fonction a été introduite dans Qt 6.2.

Voir également setBoundingShape().

QGeoCoordinate QGeoLocation::coordinate() const

Renvoie les coordonnées de l'emplacement.

Voir aussi setCoordinate().

QVariantMap QGeoLocation::extendedAttributes() const

Renvoie les attributs étendus associés à cet emplacement. Les attributs étendus dépendent du backend et peuvent dépendre de l'emplacement.

Voir également setExtendedAttributes().

bool QGeoLocation::isEmpty() const

Renvoie « true » si la coordonnée de localisation est « invalid » et que tous les autres champs de localisation sont vides. Sinon, renvoie « false ».

void QGeoLocation::setAddress(const QGeoAddress &address)

Définit l'address de l'emplacement.

Voir aussi address().

[since 6.2] void QGeoLocation::setBoundingShape(const QGeoShape &boundingShape)

Définit l'boundingShape s de l'emplacement.

Cette fonction a été introduite dans Qt 6.2.

Voir également boundingShape().

void QGeoLocation::setCoordinate(const QGeoCoordinate &coordinate)

Définit l'coordinate e de l'emplacement.

Voir aussi coordinate().

void QGeoLocation::setExtendedAttributes(const QVariantMap &data)

Définit les attributs étendus de l'emplacement à l'aide des paramètres spécifiés dans data.

Voir également extendedAttributes().

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

Permute cet emplacement avec celui de other. Cette opération est très rapide et ne rencontre jamais d'échec.

Cette fonction a été introduite dans Qt 6.2.

[noexcept, since 6.2] QGeoLocation &QGeoLocation::operator=(QGeoLocation &&other)

Déplace l'objet other vers cet emplacement et renvoie une référence à cet emplacement.

Remarque : l’objet « moved-from » QGeoLocation 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.

QGeoLocation &QGeoLocation::operator=(const QGeoLocation &other)

Attribue la valeur « other » à cet emplacement et renvoie une référence à cet emplacement.

Éléments non membres associés

[noexcept] size_t qHash(const QGeoLocation &location, size_t seed = 0)

Renvoie la valeur de hachage de l'objet « location », en utilisant l'algorithme « seed » pour le calcul.

Remarque : le hachage ne tient pas compte des attributs étendus. Cela signifie que deux objets de géolocalisation qui ne diffèrent que par leurs attributs étendus fourniront des hachages similaires.

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

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

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

Renvoie « true » si l'adresse lhs correspond à 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.