geoCoordinate QML Value Type

Der Typ „geoCoordinate“ repräsentiert und speichert eine geografische Position. Mehr...

Eigenschaften

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

Methoden

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

Ausführliche Beschreibung

Dieser Typ ist eine QML-Darstellung von „ QGeoCoordinate “ und repräsentiert eine geografische Position in Form der Attribute „ latitude “, „ longitude “ und „ altitude “. Das Attribut „ latitude “ gibt die Anzahl der Dezimalgradwerte oberhalb und unterhalb des Äquators an. Ein positiver Breitengrad bezeichnet die nördliche Hemisphäre, ein negativer Breitengrad die südliche Hemisphäre. Das Attribut „ longitude “ gibt die Anzahl der Dezimalgradwerte östlich und westlich an. Ein positiver Längengrad bezeichnet die östliche Hemisphäre, ein negativer Längengrad die westliche Hemisphäre. Das Attribut „ altitude “ gibt die Höhe in Metern über dem Meeresspiegel an. Zusammen geben diese Attribute eine dreidimensionale Position an einem beliebigen Ort auf oder in der Nähe der Erdoberfläche an.

Das Attribut „ isValid “ kann verwendet werden, um zu prüfen, ob eine Koordinate gültig ist. Eine Koordinate gilt als gültig, wenn sie einen gültigen Breiten- und Längengrad aufweist. Eine gültige Höhe ist nicht erforderlich. Der Breitengrad muss zwischen -90 und 90 (einschließlich) liegen, und der Längengrad muss zwischen -180 und 180 (einschließlich) liegen.

Der Typ „geoCoordinate“ wird von vielen anderen Typen im Modul „ Qt Location “ verwendet, um die Position eines Objekts auf einer Karte, die aktuelle Position eines Geräts und viele andere Aufgaben zu bestimmen. Er verfügt außerdem über eine Reihe wichtiger Hilfsmethoden, die ansonsten komplexe Berechnungen einfach handhabbar machen, wie beispielsweise „ atDistanceAndAzimuth()“.

Genauigkeit

Die im Typ „geoCoordinate“ gespeicherten Attribute für Breitengrad, Längengrad und Höhe werden als „double“-Werte dargestellt, wodurch sie eine Genauigkeit von etwa 16 Dezimalstellen aufweisen – ausreichend, um Mikrometer anzugeben. Die in den Methoden von `geoCoordinate` durchgeführten Berechnungen, wie beispielsweise ` azimuthTo()` und ` distanceTo()`, verwenden ebenfalls `double`-Werte für alle Zwischenwerte, doch die dem sphärischen Erdmodell innewohnenden Ungenauigkeiten dominieren die Fehlergröße in den Ausgabewerten.

Anwendungsbeispiel

Um ein geoCoordinate zu erstellen, verwenden Sie eine der unten beschriebenen Methoden. In allen Fällen ist die Angabe des Attributs „ altitude “ optional.

Um einen „geoCoordinate“-Wert zu erstellen, verwenden Sie die Funktion „ QtPositioning.coordinate()“:

import QtPositioning

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

oder als separate Komponenten „ latitude “, „ longitude “ und „ altitude “:

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

Beachten Sie bei der Integration mit C++, dass jeder aus C++ an QML übergebene „ QGeoCoordinate “-Wert automatisch in einen „geoCoordinate“-Wert konvertiert wird und umgekehrt.

Dokumentation zu den Eigenschaften

altitude : real

Diese Eigenschaft enthält den Höhenwert (in Metern über dem Meeresspiegel). Wenn die Eigenschaft nicht festgelegt wurde, lautet ihr Standardwert „NaN“.

Weitere Informationen finden Sie unter der Eigenschaft „ QGeoCoordinate::altitude “.

isValid : bool

Diese Eigenschaft gibt die aktuelle Gültigkeit der Koordinaten an. Koordinaten gelten als gültig, wenn sie mit einem gültigen Breiten- und Längengrad festgelegt wurden (die Angabe der Höhe ist nicht erforderlich).

Der Breitengrad muss zwischen -90 und 90 (einschließlich) liegen, um als gültig zu gelten, und der Längengrad muss zwischen -180 und 180 (einschließlich) liegen, um als gültig zu gelten.

Dies ist eine schreibgeschützte Eigenschaft.

latitude : real

Diese Eigenschaft enthält den Breitengrad der geografischen Position (in Dezimalgrad). Ein positiver Breitengrad bezeichnet die nördliche Hemisphäre, ein negativer Breitengrad die südliche Hemisphäre. Wenn die Eigenschaft nicht festgelegt wurde, lautet ihr Standardwert „NaN“.

Weitere Informationen finden Sie unter der Eigenschaft „ QGeoCoordinate::latitude “.

longitude : real

Diese Eigenschaft enthält den Längengrad der geografischen Position (in Dezimalgrad). Ein positiver Längengrad bezeichnet die östliche Hemisphäre, ein negativer Längengrad die westliche Hemisphäre. Wenn die Eigenschaft nicht festgelegt wurde, lautet ihr Standardwert „NaN“.

Weitere Informationen finden Sie unter der Eigenschaft „ QGeoCoordinate::longitude “.

Methodendokumentation

geoCoordinate atDistanceAndAzimuth(real distance, real azimuth)

Gibt die Koordinate zurück, die erreicht wird, wenn man von dieser Koordinate aus distance Meter in Richtung azimuth Grad entlang eines Großkreises zurücklegt.

Für diese Berechnung wird davon ausgegangen, dass die Erde kugelförmig ist.

real azimuthTo(geoCoordinate other)

Gibt den Azimut (oder die Peilung) in Grad von dieser Koordinate zu der durch ` other` angegebenen Koordinate zurück. Die Höhe wird bei der Berechnung nicht berücksichtigt.

Für diese Berechnung wird davon ausgegangen, dass die Erde kugelförmig ist.

real distanceTo(geoCoordinate other)

Gibt die Entfernung (in Metern) von dieser Koordinate zu der durch other angegebenen Koordinate zurück. Die Höhe wird bei der Berechnung nicht berücksichtigt.

Diese Berechnung gibt die Großkreisentfernung zwischen den beiden Koordinaten zurück, wobei für diese Berechnung davon ausgegangen wird, dass die Erde kugelförmig ist.