Position QML Type
Le type « Position » contient des données de position à un instant donné, telles que les coordonnées (longitude, latitude, altitude) et la vitesse. En savoir plus…
| Import Statement: | import QtPositioning |
Propriétés
- altitudeValid : bool
- coordinate : coordinate
- direction : double
(since Qt Positioning 5.3) - directionAccuracy : double
(since Qt Positioning 6.3) - directionAccuracyValid : bool
(since Qt Positioning 6.3) - directionValid : bool
(since Qt Positioning 5.3) - horizontalAccuracy : real
- horizontalAccuracyValid : bool
- latitudeValid : bool
- longitudeValid : bool
- magneticVariation : double
(since Qt Positioning 5.4) - magneticVariationValid : bool
(since Qt Positioning 5.4) - speed : double
- speedValid : bool
- timestamp : date
- verticalAccuracy : real
- verticalAccuracyValid : bool
- verticalSpeed : double
(since Qt Positioning 5.3) - verticalSpeedValid : bool
(since Qt Positioning 5.3)
Description détaillée
Le type « Position » contient des valeurs liées à la localisation géographique, telles que les coordonnées géographiques ( coordinate ) (longitude, latitude et altitude), l’ timestamp à laquelle la position a été obtenue, l’ speed à ce moment-là et la précision des données.
Il est principalement utilisé dans la propriété « position » d’un objet « PositionSource », en tant qu’unité de base des données disponibles à partir de la source de données de localisation du système.
Toutes les propriétés d’un objet Position ne sont pas nécessairement valides ou disponibles (par exemple, la latitude et la longitude peuvent être valides, mais la mise à jour de la vitesse n’a pas été reçue ou n’a pas été définie manuellement). Par conséquent, les propriétés « valides » correspondantes sont disponibles (par exemple coordinate, longitudeValid, latitudeValid, etc.) pour déterminer si les données sont disponibles et valides dans cette mise à jour de position.
Les objets de position sont en lecture seule et ne peuvent être générés que par une méthode PositionSource.
Exemple d’utilisation
Consultez l’exemple fourni pour le type « PositionSource » ou l’application d’exemple « Satellite Info ».
Voir également « PositionSource » et « coordinate ».
Documentation sur les propriétés
altitudeValid : bool
Cette propriété est vraie si l'altitude de la coordonnée a été définie (pour indiquer si cette donnée a été reçue ou non, car chaque mise à jour ne contient pas nécessairement toutes les données).
Voir également coordinate.
coordinate : coordinate
Cette propriété contient les valeurs de latitude, de longitude et d'altitude de la position.
Il s'agit d'une propriété en lecture seule.
Voir également longitudeValid, latitudeValid et altitudeValid.
direction : double [since Qt Positioning 5.3]
Cette propriété contient la valeur de la direction de déplacement, exprimée en degrés par rapport au nord géographique.
Il s'agit d'une propriété en lecture seule.
Cette propriété a été introduite dans la version 5.3 d'Qt Positioning.
Voir également directionValid.
directionAccuracy : double [since Qt Positioning 6.3]
Cette propriété indique la précision de l'direction fournie, exprimée en degrés. Elle n'est disponible que sur Android et macOS/iOS. Pour plus d'informations, consultez la documentation relative à QGeoPositionInfo::Attribute.
Cette propriété a été introduite dans la version 6.3 d'Qt Positioning.
Voir également direction et directionAccuracyValid.
directionAccuracyValid : bool [since Qt Positioning 6.3]
Cette propriété prend la valeur « true » si « directionAccuracy » a été défini.
Cette propriété a été introduite dans Qt Positioning 6.3.
Voir également directionAccuracy.
directionValid : bool [since Qt Positioning 5.3]
Cette propriété est vraie si la variable « direction » a été définie (pour indiquer si ces données ont été reçues ou non, car chaque mise à jour ne contient pas nécessairement toutes les données).
Cette propriété a été introduite dans Qt Positioning 5.3.
Voir également direction.
horizontalAccuracy : real
Cette propriété indique la précision horizontale de la coordonnée (en mètres).
Voir également horizontalAccuracyValid et coordinate.
horizontalAccuracyValid : bool
Cette propriété est vraie si la variable « horizontalAccuracy » a été définie (pour indiquer si ces données ont été reçues ou non, car chaque mise à jour ne contient pas nécessairement toutes les données).
Voir également horizontalAccuracy.
latitudeValid : bool
Cette propriété est vraie si la latitude de la coordonnée a été définie (pour indiquer si cette donnée a été reçue ou non, car chaque mise à jour ne contient pas nécessairement toutes les données).
Voir également coordinate.
longitudeValid : bool
Cette propriété est vraie si la longitude de la coordonnée a été définie (pour indiquer si cette donnée a été reçue ou non, car chaque mise à jour ne contient pas nécessairement toutes les données).
Voir également coordinate.
magneticVariation : double [since Qt Positioning 5.4]
Cette propriété indique l'angle, en degrés, entre la composante horizontale du champ magnétique et le nord géographique. Elle est également appelée « déclinaison magnétique ». Une valeur positive indique une rotation dans le sens des aiguilles d'une montre à partir du nord géographique, tandis qu'une valeur négative indique une rotation dans le sens inverse des aiguilles d'une montre.
Il s'agit d'une propriété en lecture seule.
Cette propriété a été introduite dans la version 5.4 d'Qt Positioning.
Voir également magneticVariationValid.
magneticVariationValid : bool [since Qt Positioning 5.4]
Cette propriété est vraie si la propriété « magneticVariation » a été définie (pour indiquer si ces données ont été reçues ou non, car chaque mise à jour ne contient pas nécessairement toutes les données).
Cette propriété a été introduite dans la version 5.4 d'Qt Positioning.
Voir également magneticVariation.
speed : double
Cette propriété contient la valeur de la vitesse (vitesse au sol, en mètres par seconde).
Il s'agit d'une propriété en lecture seule.
Voir également speedValid et coordinate.
speedValid : bool
Cette propriété est vraie si la variable « speed » a été définie (pour indiquer si ces données ont été reçues ou non, car chaque mise à jour ne contient pas nécessairement toutes les données).
Voir également speed.
timestamp : date
Cette propriété contient l'horodatage correspondant au moment où cette position a été reçue. Si la propriété n'a pas été définie, elle n'est pas valide.
Il s'agit d'une propriété en lecture seule.
verticalAccuracy : real
Cette propriété indique la précision verticale de la coordonnée (en mètres).
Voir également verticalAccuracyValid et coordinate.
verticalAccuracyValid : bool
Cette propriété est vraie si la variable « verticalAccuracy » a été définie (pour indiquer si ces données ont été reçues ou non, car chaque mise à jour ne contient pas nécessairement toutes les données).
Voir également verticalAccuracy.
verticalSpeed : double [since Qt Positioning 5.3]
Cette propriété contient la valeur de la vitesse verticale en mètres par seconde.
Il s'agit d'une propriété en lecture seule.
Cette propriété a été introduite dans la version 5.3 d'Qt Positioning.
Voir également verticalSpeedValid.
verticalSpeedValid : bool [since Qt Positioning 5.3]
Cette propriété est vraie si la variable « verticalSpeed » a été définie (pour indiquer si ces données ont été reçues ou non, car chaque mise à jour ne contient pas nécessairement toutes les données).
Cette propriété a été introduite dans la version 5.3 d'Qt Positioning.
Voir également verticalSpeed.
© 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.
