geoCoordinate QML Value Type

Le type « geoCoordinate » représente et stocke une position géographique. En savoir plus...

Propriétés

• altitude : real
• isValid : bool
• latitude : real
• longitude : real

Méthodes

• geoCoordinate atDistanceAndAzimuth(real distance, real azimuth)
• real azimuthTo(geoCoordinate other)
• real distanceTo(geoCoordinate other)

Description détaillée

Ce type est une représentation QML d'QGeoCoordinate et représente une position géographique sous la forme des attributs latitude, longitude et altitude. L'attribut latitude spécifie le nombre de degrés décimaux au-dessus et en dessous de l'équateur. Une latitude positive indique l'hémisphère nord et une latitude négative indique l'hémisphère sud. L'attribut longitude spécifie le nombre de degrés décimaux à l'est et à l'ouest. Une longitude positive indique l’hémisphère oriental et une longitude négative indique l’hémisphère occidental. L’attribut « altitude » spécifie le nombre de mètres au-dessus du niveau de la mer. Ensemble, ces attributs définissent une position tridimensionnelle en tout point de la surface terrestre ou à proximité de celle-ci.

L’attribut « isValid » peut être utilisé pour vérifier si une coordonnée est valide. Une coordonnée est considérée comme valide si elle comporte une latitude et une longitude valides. Une altitude valide n’est pas requise. La latitude doit être comprise entre -90 et 90 inclus, et la longitude entre -180 et 180 inclus.

Le type « geoCoordinate » est utilisé par de nombreux autres types du module « Qt Location » pour spécifier la position d’un objet sur une carte, la position actuelle d’un appareil et pour de nombreuses autres tâches. Il propose également plusieurs méthodes utilitaires importantes qui simplifient des calculs autrement complexes, telles que « atDistanceAndAzimuth() ».

Précision

Les attributs de latitude, longitude et altitude stockés dans le type geoCoordinate sont représentés sous forme de nombres de type double, ce qui leur confère une précision d’environ 16 chiffres décimaux – suffisante pour spécifier des micromètres. Les calculs effectués dans les méthodes de `geoCoordinate`, telles que ` azimuthTo()` et ` distanceTo()`, utilisent également des entiers à virgule flottante (`double`) pour toutes les valeurs intermédiaires, mais les imprécisions inhérentes à leur modèle sphérique de la Terre dominent l’ampleur de l’erreur dans leurs résultats.

Exemple d’utilisation

Pour créer une geoCoordinate, utilisez l’une des méthodes décrites ci-dessous. Dans tous les cas, la spécification de l’attribut ` altitude ` est facultative.

Pour créer une valeur geoCoordinate, utilisez la fonction QtPositioning.coordinate() :

import QtPositioning

Location { coordinate: QtPositioning.coordinate(-27.5, 153.1) }

ou sous forme de composants distincts : latitude, longitude et altitude:

Location {
    coordinate {
        latitude: -27.5
        longitude: 153.1
    }
}

Lors de l’intégration avec C++, notez que toute valeur ` QGeoCoordinate ` transmise à QML depuis C++ est automatiquement convertie en valeur `geoCoordinate`, et inversement.

Documentation sur les propriétés

altitude : real

Cette propriété contient la valeur de l'altitude (en mètres au-dessus du niveau de la mer). Si cette propriété n'a pas été définie, sa valeur par défaut est NaN.

Pour plus de détails, consultez la propriété « QGeoCoordinate::altitude »

isValid : bool

Cette propriété indique la validité actuelle des coordonnées. Les coordonnées sont considérées comme valides si elles ont été définies avec une latitude et une longitude valides (l'altitude n'est pas obligatoire).

Pour être considérée comme valide, la latitude doit être comprise entre -90 et 90 inclus, et la longitude doit être comprise entre -180 et 180 inclus.

Il s'agit d'une propriété en lecture seule.

latitude : real

Cette propriété contient la valeur de latitude de la position géographique (en degrés décimaux). Une latitude positive correspond à l'hémisphère nord, tandis qu'une latitude négative correspond à l'hémisphère sud. Si cette propriété n'a pas été définie, sa valeur par défaut est NaN.

Pour plus de détails, consultez la propriété « QGeoCoordinate::latitude ».

longitude : real

Cette propriété contient la valeur de longitude de la position géographique (en degrés décimaux). Une longitude positive correspond à l'hémisphère oriental, tandis qu'une longitude négative correspond à l'hémisphère occidental. Si cette propriété n'a pas été définie, sa valeur par défaut est NaN.

Pour plus de détails, consultez la propriété « QGeoCoordinate::longitude ».

Documentation sur les méthodes

geoCoordinate atDistanceAndAzimuth(real distance, real azimuth)

Renvoie la coordonnée atteinte après avoir parcouru distance mètres à partir de cette coordonnée, à azimuth degrés, le long d'un grand cercle.

Ce calcul repose sur l'hypothèse que la Terre est sphérique.

real azimuthTo(geoCoordinate other)

Renvoie l'azimut (ou relèvement) en degrés entre cette coordonnée et la coordonnée spécifiée par ` other`. L'altitude n'est pas prise en compte dans le calcul.

Ce calcul repose sur l'hypothèse que la Terre est sphérique.

real distanceTo(geoCoordinate other)

Renvoie la distance (en mètres) entre cette coordonnée et la coordonnée spécifiée par other. L'altitude n'est pas prise en compte dans le calcul.

Ce calcul renvoie la distance orthodromique entre les deux coordonnées, en partant du principe que la Terre est sphérique aux fins de ce calcul.