geoCoordinate QML Value Type

Le type geoCoordinate représente et stocke une position géographique. Plus d'informations...

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 de QGeoCoordinate et représente une position géographique sous la forme des attributs latitude, longitude et altitude. L'attribut latitude indique le nombre de degrés décimaux au-dessus et au-dessous de l'équateur. Une latitude positive indique l'hémisphère nord et une latitude négative l'hémisphère sud. L'attribut longitude indique 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 indique le nombre de mètres au-dessus du niveau de la mer. Ensemble, ces attributs spécifient une position tridimensionnelle n'importe où sur ou près de la surface de la Terre.

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 possède une latitude et une longitude valides. Une altitude valide n'est pas nécessaire. La latitude doit être comprise entre -90 et 90 inclus et la longitude doit être comprise entre -180 et 180 inclus.

Le type geoCoordinate est utilisé par de nombreux autres types dans le module Qt Location, pour spécifier la position d'un objet sur une carte, la position actuelle d'un appareil et de nombreuses autres tâches. Ils disposent également d'un certain nombre de méthodes utilitaires importantes qui simplifient l'utilisation de calculs autrement complexes, telles que atDistanceAndAzimuth().

Précision

Les attributs de latitude, de longitude et d'altitude stockés dans le type geoCoordinate sont représentés par des doubles, ce qui leur confère une précision d'environ 16 chiffres après la virgule, 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 doubles pour toutes les valeurs intermédiaires, mais les imprécisions inhérentes à leur modèle de Terre sphérique dominent la quantité d'erreur dans leurs résultats.

Exemple d'utilisation

Pour créer une géocoordonnée, 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 de géocoordonnée, utilisez la fonction QtPositioning.coordinate() :

import QtPositioning

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

ou en tant que composants distincts latitude, longitude et altitude:

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

Lors de l'intégration avec C++, il convient de noter que toute valeur QGeoCoordinate transmise à QML à partir de C++ est automatiquement convertie en valeur de coordonnées géographiques, et vice-versa.

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 la propriété n'a pas été définie, sa valeur par défaut est NaN.

Pour plus de détails, voir la propriété QGeoCoordinate::altitude

isValid : bool

Cette propriété indique la validité actuelle de la coordonnée. 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 nécessaire).

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

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

latitude : real

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

Pour plus de détails, voir la propriété QGeoCoordinate::latitude

longitude : real

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

Pour plus de détails, voir la propriété QGeoCoordinate::longitude

Documentation de la méthode

geoCoordinate atDistanceAndAzimuth(real distance, real azimuth)

Renvoie la coordonnée que l'on atteint en parcourant distance mètres à partir de cette coordonnée à azimuth degrés le long d'un grand cercle.

Pour les besoins de ce calcul, on suppose que la Terre est sphérique.

real azimuthTo(geoCoordinate other)

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

Pour les besoins de ce calcul, on suppose 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 utilisée dans le calcul.

Ce calcul renvoie la distance orthodromique entre les deux coordonnées, en supposant que la Terre est sphérique pour les besoins de ce calcul.