QGeoPositionInfo Class
La classe `QGeoPositionInfo` contient des informations relatives à la position, à la direction et à la vitesse globales à un instant donné. En savoir plus...
| En-tête : | #include <QGeoPositionInfo> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake : | QT += positioning |
- Liste de tous les membres, y compris les membres hérités
- QGeoPositionInfo fait partie des classes à partage implicite.
Types publics
| enum | Attribute { Direction, GroundSpeed, VerticalSpeed, MagneticVariation, HorizontalAccuracy, …, DirectionAccuracy } |
Fonctions publiques
| QGeoPositionInfo() | |
| QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp) | |
| QGeoPositionInfo(const QGeoPositionInfo &other) | |
(since 6.2) | QGeoPositionInfo(QGeoPositionInfo &&other) |
| ~QGeoPositionInfo() | |
| qreal | attribute(QGeoPositionInfo::Attribute attribute) const |
| QGeoCoordinate | coordinate() const |
| bool | hasAttribute(QGeoPositionInfo::Attribute attribute) const |
| bool | isValid() const |
| void | removeAttribute(QGeoPositionInfo::Attribute attribute) |
| void | setAttribute(QGeoPositionInfo::Attribute attribute, qreal value) |
| void | setCoordinate(const QGeoCoordinate &coordinate) |
| void | setTimestamp(const QDateTime ×tamp) |
(since 6.2) void | swap(QGeoPositionInfo &other) |
| QDateTime | timestamp() const |
(since 6.2) QGeoPositionInfo & | operator=(QGeoPositionInfo &&other) |
| QGeoPositionInfo & | operator=(const QGeoPositionInfo &other) |
Éléments non membres associés
| bool | operator!=(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs) |
| QDataStream & | operator<<(QDataStream &stream, QGeoPositionInfo::Attribute attr) |
| QDataStream & | operator<<(QDataStream &stream, const QGeoPositionInfo &info) |
| bool | operator==(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QGeoPositionInfo &info) |
| QDataStream & | operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr) |
Description détaillée
Un objet QGeoPositionInfo contient au minimum une coordonnée géographique et un horodatage. Il peut également comporter des mesures de cap et de vitesse, ainsi que des estimations de la précision des données fournies.
Voir également QGeoPositionInfoSource.
Documentation sur les types de membres
enum QGeoPositionInfo::Attribute
Définit les attributs relatifs aux informations de position.
| Constante | Valeur | Description |
|---|---|---|
QGeoPositionInfo::Direction | 0 | Le relèvement, mesuré en degrés dans le sens des aiguilles d'une montre à partir du nord géographique, vers la direction du déplacement. |
QGeoPositionInfo::GroundSpeed | 1 | La vitesse au sol, en mètres/seconde. |
QGeoPositionInfo::VerticalSpeed | 2 | La vitesse verticale, en mètres par seconde. |
QGeoPositionInfo::MagneticVariation | 3 | L'angle entre la composante horizontale du champ magnétique et le nord géographique, en degrés. Également appelé déclinaison magnétique. Une valeur positive indique une direction dans le sens des aiguilles d'une montre à partir du nord géographique, tandis qu'une valeur négative indique une direction dans le sens inverse des aiguilles d'une montre. |
QGeoPositionInfo::HorizontalAccuracy | 4 | La précision des coordonnées de latitude et de longitude fournies, en mètres. |
QGeoPositionInfo::VerticalAccuracy | 5 | La précision des coordonnées d'altitude fournies, en mètres. |
QGeoPositionInfo::DirectionAccuracy | 6 | La précision du relèvement fourni, en degrés. Cet attribut n’est disponible que sur Android (niveau d’API 26 ou supérieur) et macOS/iOS. Consultez la documentation correspondante d’Android et d’Apple pour plus de détails. |
Le protocole NMEA propose également un autre type de précision : PositionAccuracy, qui est une valeur de précision 3D. Qt ne fournit pas d’attribut distinct pour celle-ci. Si vous avez besoin de cette valeur, vous pouvez la calculer à l’aide de la formule suivante :
PositionAccuracy 2 = HorizontalAccuracy 2 + VerticalAccuracy 2
Documentation des fonctions membres
QGeoPositionInfo::QGeoPositionInfo()
Crée un objet `QGeoPositionInfo` non valide.
Voir également isValid().
QGeoPositionInfo::QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp)
Crée un objet `QGeoPositionInfo` à partir des coordonnées ` coordinate ` et ` timestamp` fournies.
QGeoPositionInfo::QGeoPositionInfo(const QGeoPositionInfo &other)
Crée un objet `QGeoPositionInfo` avec les valeurs de ` other`.
[constexpr noexcept default, since 6.2] QGeoPositionInfo::QGeoPositionInfo(QGeoPositionInfo &&other)
Crée un objet `QGeoPositionInfo` à partir d'un ` other`.
Notez qu'un objet `QGeoPositionInfo` issu d'un déplacement ne peut être ni détruit ni 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] QGeoPositionInfo::~QGeoPositionInfo()
Supprime un objet de type « QGeoPositionInfo ».
qreal QGeoPositionInfo::attribute(QGeoPositionInfo::Attribute attribute) const
Renvoie la valeur de l'attribute e spécifiée sous forme de valeur qreal.
Renvoie NaN si la valeur n'a pas été définie.
La fonction hasAttribute() doit être utilisée pour déterminer si une valeur a été définie ou non pour un attribut.
Voir également hasAttribute() et setAttribute().
QGeoCoordinate QGeoPositionInfo::coordinate() const
Renvoie les coordonnées correspondant à cette position.
Renvoie une coordonnée non valide si aucune coordonnée n'a été définie.
Voir également setCoordinate().
bool QGeoPositionInfo::hasAttribute(QGeoPositionInfo::Attribute attribute) const
Renvoie « true » si l'attribute spécifié est associé à cet objet « QGeoPositionInfo ».
bool QGeoPositionInfo::isValid() const
Renvoie « true » si les valeurs de timestamp() et coordinate() sont toutes deux valides.
Voir également QGeoCoordinate::isValid() et QDateTime::isValid().
void QGeoPositionInfo::removeAttribute(QGeoPositionInfo::Attribute attribute)
Supprime l'attribute e spécifiée et sa valeur.
void QGeoPositionInfo::setAttribute(QGeoPositionInfo::Attribute attribute, qreal value)
Définit la valeur de « attribute » sur « value ».
Voir également attribute().
void QGeoPositionInfo::setCoordinate(const QGeoCoordinate &coordinate)
Définit les coordonnées de cette position sur coordinate.
Voir également coordinate().
void QGeoPositionInfo::setTimestamp(const QDateTime ×tamp)
Définit la date et l'heure auxquelles cette position a été signalée à timestamp.
L'timestamp doit être exprimée en heure UTC.
Voir également timestamp().
[noexcept, since 6.2] void QGeoPositionInfo::swap(QGeoPositionInfo &other)
Échange ces informations de position avec celles de other. Cette opération est très rapide et ne rate jamais.
Cette fonction a été introduite dans Qt 6.2.
QDateTime QGeoPositionInfo::timestamp() const
Renvoie la date et l'heure auxquelles cette position a été signalée, en heure UTC.
Renvoie une valeur non valide « QDateTime » si aucune valeur de date/heure n'a été définie.
Voir aussi setTimestamp().
[noexcept, since 6.2] QGeoPositionInfo &QGeoPositionInfo::operator=(QGeoPositionInfo &&other)
La fonction « move » attribue les valeurs de other à cet objet.
Notez qu’un objet « QGeoPositionInfo » dont les valeurs ont été déplacées 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.
QGeoPositionInfo &QGeoPositionInfo::operator=(const QGeoPositionInfo &other)
Attribue les valeurs de other à cette page QGeoPositionInfo.
Personnes concernées non membres
bool operator!=(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs)
Renvoie « true » si l'une des valeurs de l'objet « lhs » ne correspond pas à celles de « rhs ». Sinon, renvoie « false ».
QDataStream &operator<<(QDataStream &stream, QGeoPositionInfo::Attribute attr)
Écrit l'énumération « attr » donnée dans le fichier « stream » spécifié.
Voir également Sérialisation des types de données Qt.
QDataStream &operator<<(QDataStream &stream, const QGeoPositionInfo &info)
Écrit l'info on fournie dans l'stream on spécifiée.
Voir également Sérialisation des types de données Qt.
bool operator==(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs)
Renvoie « true » si toutes les valeurs de l'objet ` lhs ` sont identiques à celles de ` rhs`. Sinon, renvoie « false ».
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo &info)
Lit une coordonnée à partir de l'stream spécifié et la stocke dans l'info donné.
Voir également Sérialisation des types de données Qt.
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr)
Lit une énumération d'attributs à partir des informations d'stream spécifiées dans l'attr indiquée.
Voir également Sérialisation des types de données Qt.
© 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.
