Position QML Type
Le type Position contient des données de position à un moment donné, telles que les coordonnées (longitude, latitude, altitude) et la vitesse. Plus d'informations...
| 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 relatives à l'emplacement géographique telles que coordinate (longitude, latitude et altitude), timestamp lorsque la position a été obtenue, 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 définie manuellement). Par conséquent, des propriétés "valides" correspondantes sont disponibles (par exemple coordinate et longitudeValid, latitudeValid etc.) pour déterminer si les données sont disponibles et valides dans cette mise à jour de la position.
Les objets de position sont en lecture seule et ne peuvent être produits que par PositionSource.
Exemple d'utilisation
Voir l'exemple donné pour le type PositionSource, ou l'exemple d'application 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 les données ont été reçues ou non, car chaque mise à jour ne contient pas nécessairement toutes les données).
Voir aussi 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 du voyage 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 Qt Positioning 5.3.
Voir aussi directionValid.
directionAccuracy : double [since Qt Positioning 6.3]
Cette propriété indique la précision de l'adresse direction en degrés. Cette propriété n'est valable que pour Android et macOS/iOS. Voir la documentation de QGeoPositionInfo::Attribute pour plus de détails.
Cette propriété a été introduite dans Qt Positioning 6.3.
Voir également direction et directionAccuracyValid.
directionAccuracyValid : bool [since Qt Positioning 6.3]
Cette propriété est true si directionAccuracy a été défini.
Cette propriété a été introduite dans Qt Positioning 6.3.
Voir aussi directionAccuracy.
directionValid : bool [since Qt Positioning 5.3]
Cette propriété est vraie si direction a été défini (pour indiquer si les 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 horizontalAccuracy a été défini (pour indiquer si les données ont été reçues ou non, car chaque mise à jour ne contient pas nécessairement toutes les données).
Voir aussi 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 aussi 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 entre la composante horizontale du champ magnétique et le nord géographique, en degrés. Également connue 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 géographique et une valeur négative indique une direction 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 Qt Positioning 5.4.
Voir également magneticVariationValid.
magneticVariationValid : bool [since Qt Positioning 5.4]
Cette propriété est vraie si magneticVariation a été défini (pour indiquer si les 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.4.
Voir également magneticVariation.
speed : double
Cette propriété contient la valeur de la vitesse (vitesse au sol, mètres / seconde).
Il s'agit d'une propriété en lecture seule.
Voir également speedValid et coordinate.
speedValid : bool
Cette propriété est vraie si speed a été défini (pour indiquer si les données ont été reçues ou non, car chaque mise à jour ne contient pas nécessairement toutes les données).
Voir aussi speed.
timestamp : date
Cette propriété contient l'horodatage de la réception de cette position. Si la propriété n'a pas été définie, elle est invalide.
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 verticalAccuracy a été défini (pour indiquer si les données ont été reçues ou non, car chaque mise à jour ne contient pas nécessairement toutes les données).
Voir aussi 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 Qt Positioning 5.3.
Voir également verticalSpeedValid.
verticalSpeedValid : bool [since Qt Positioning 5.3]
Cette propriété est vraie si verticalSpeed a été défini (pour indiquer si les 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 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.
