QGeoPositionInfo Class
La classe QGeoPositionInfo contient des informations sur la position globale, la direction et la vitesse à un moment donné. Plus d'informations...
| 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 partagées implicitement.
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) |
Non-membres apparenté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 QGeoPositionInfo contient, au minimum, une coordonnée géographique et un horodatage. Il peut également contenir des mesures de cap et de vitesse ainsi que des estimations de la précision des données fournies.
Voir également QGeoPositionInfoSource.
Type de membre Documentation
enum QGeoPositionInfo::Attribute
Définit les attributs des informations de position.
| Constante | Valeur | Description |
|---|---|---|
QGeoPositionInfo::Direction | 0 | Le relèvement mesuré en degrés dans le sens des aiguilles d'une montre par rapport au nord vrai dans la direction du déplacement. |
QGeoPositionInfo::GroundSpeed | 1 | Vitesse au sol, en mètres/seconde. |
QGeoPositionInfo::VerticalSpeed | 2 | La vitesse verticale, en mètres/seconde. |
QGeoPositionInfo::MagneticVariation | 3 | Angle entre la composante horizontale du champ magnétique et le nord géographique, en degrés. Également connu sous le nom de déclinaison magnétique. Une valeur positive indique une direction dans le sens des aiguilles d'une montre par rapport au nord vrai et une valeur négative indique une direction dans le sens contraire des aiguilles d'une montre. |
QGeoPositionInfo::HorizontalAccuracy | 4 | La précision de la valeur latitude-longitude fournie, en mètres. |
QGeoPositionInfo::VerticalAccuracy | 5 | Précision de la valeur d'altitude fournie, 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 API 26 ou supérieur) et macOS/iOS. Pour plus de détails, voir la documentation correspondante d'Android et d'Apple. |
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 séparé pour cela. 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 invalide.
Voir aussi isValid().
QGeoPositionInfo::QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp)
Crée un QGeoPositionInfo pour les adresses coordinate et timestamp.
QGeoPositionInfo::QGeoPositionInfo(const QGeoPositionInfo &other)
Crée un QGeoPositionInfo avec les valeurs de other.
[constexpr noexcept, since 6.2] QGeoPositionInfo::QGeoPositionInfo(QGeoPositionInfo &&other)
Crée un objet QGeoPositionInfo en le déplaçant depuis other.
Notez qu'un QGeoPositionInfo 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] QGeoPositionInfo::~QGeoPositionInfo()
Détruit un objet QGeoPositionInfo.
qreal QGeoPositionInfo::attribute(QGeoPositionInfo::Attribute attribute) const
Renvoie la valeur de l'adresse attribute spécifiée sous la forme d'une 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 pour un attribut.
Voir également hasAttribute() et setAttribute().
QGeoCoordinate QGeoPositionInfo::coordinate() const
Renvoie la coordonnée de cette position.
Renvoie une coordonnée invalide si aucune coordonnée n'a été définie.
Voir également setCoordinate().
bool QGeoPositionInfo::hasAttribute(QGeoPositionInfo::Attribute attribute) const
Renvoie un résultat positif si l'objet attribute spécifié est présent pour cet objet QGeoPositionInfo.
bool QGeoPositionInfo::isValid() const
Renvoie un résultat positif si les valeurs timestamp() et coordinate() sont toutes deux valides.
Voir aussi QGeoCoordinate::isValid() et QDateTime::isValid().
void QGeoPositionInfo::removeAttribute(QGeoPositionInfo::Attribute attribute)
Supprime l'adresse attribute spécifiée et sa valeur.
void QGeoPositionInfo::setAttribute(QGeoPositionInfo::Attribute attribute, qreal value)
Définit la valeur de attribute à value.
Voir aussi attribute().
void QGeoPositionInfo::setCoordinate(const QGeoCoordinate &coordinate)
Fixe la coordonnée de cette position à coordinate.
Voir aussi coordinate().
void QGeoPositionInfo::setTimestamp(const QDateTime ×tamp)
Définit la date et l'heure auxquelles cette position a été signalée à timestamp.
L'adresse timestamp doit être en heure UTC.
Voir également timestamp().
[noexcept, since 6.2] void QGeoPositionInfo::swap(QGeoPositionInfo &other)
Échange cette information sur la position avec other. Cette opération est très rapide et n'échoue 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 adresse QDateTime invalide si aucune valeur de date/heure n'a été définie.
Voir également setTimestamp().
[noexcept, since 6.2] QGeoPositionInfo &QGeoPositionInfo::operator=(QGeoPositionInfo &&other)
Déplacer - assigne les valeurs de other à cet objet.
Notez qu'un objet QGeoPositionInfo 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.
QGeoPositionInfo &QGeoPositionInfo::operator=(const QGeoPositionInfo &other)
Attribue les valeurs de other à QGeoPositionInfo.
Non-membres apparentés
bool operator!=(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs)
Renvoie true si l'une des valeurs de l'objet lhs n'est pas la même que celle de l'objet rhs. Sinon, renvoie false.
QDataStream &operator<<(QDataStream &stream, QGeoPositionInfo::Attribute attr)
Écrit l'énumération attr donnée dans l'adresse stream spécifiée.
Voir aussi Serializing Qt Data Types (Sérialisation des types de données Qt).
QDataStream &operator<<(QDataStream &stream, const QGeoPositionInfo &info)
Écrit l'adresse info donnée dans l'adresse stream spécifiée.
Voir aussi Serializing Qt Data Types (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'adresse stream spécifiée dans l'adresse info donnée.
Voir aussi Serializing Qt Data Types (Sérialisation des types de données Qt).
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr)
Lit une énumération d'attributs à partir de l'info stream spécifiée dans l'info attr donnée.
Voir aussi Serializing Qt Data Types (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.
