coordinate QML Value Type

Der Koordinatentyp repräsentiert und speichert eine geografische Position. Mehr...

Detaillierte 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 Dezimalgrade über und unter dem Äquator an. Ein positiver Breitengrad steht für die nördliche Hemisphäre und ein negativer Breitengrad für die südliche Hemisphäre. Das Attribut longitude gibt die Anzahl der Dezimalgrade nach Osten und Westen an. Ein positiver Längengrad steht für die östliche Hemisphäre und ein negativer Längengrad für die westliche Hemisphäre. Das Attribut altitude gibt die Anzahl der Meter über dem Meeresspiegel an. Zusammen geben diese Attribute eine dreidimensionale Position auf oder nahe 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 Breitengrad und Längengrad hat. Eine gültige Höhe ist nicht erforderlich. Der Breitengrad muss zwischen -90 und 90 einschließlich liegen und der Längengrad zwischen -180 und 180 einschließlich.

Der Typ coordinate 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 anzugeben. Sie verfügen auch über eine Reihe wichtiger Hilfsmethoden, die ansonsten komplexe Berechnungen vereinfachen, wie z. B. atDistanceAndAzimuth().

Genauigkeit

Die im Koordinatentyp gespeicherten Attribute Breitengrad, Längengrad und Höhe werden als Doubles dargestellt, was ihnen eine Genauigkeit von etwa 16 Dezimalstellen verleiht - genug, um Mikrometer anzugeben. Die Berechnungen, die in Koordinatenmethoden wie azimuthTo() und distanceTo() durchgeführt werden, verwenden ebenfalls Doubles für alle Zwischenwerte, aber die inhärenten Ungenauigkeiten in ihrem sphärischen Erdmodell dominieren die Fehlermenge in ihrer Ausgabe.

Beispiel für die Verwendung

Verwenden Sie Eigenschaften des Typs var, um eine coordinate zu speichern. Um eine coordinate zu erstellen, verwenden Sie eine der unten beschriebenen Methoden. In allen Fällen ist die Angabe des Attributs altitude optional.

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

import QtPositioning

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

oder als separate latitude, longitude und altitude Komponenten:

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

Bei der Integration mit C++ ist zu beachten, dass jeder QGeoCoordinate Wert, der von C++ an QML übergeben wird, automatisch in einen coordinate Wert umgewandelt wird und umgekehrt.

Eigenschaften

Breitengrad

real latitude

Diese Eigenschaft enthält den Breitengrad der geografischen Position (Dezimalgrad). Ein positiver Breitengrad steht für die nördliche Hemisphäre, ein negativer Breitengrad für die südliche Hemisphäre. Wenn die Eigenschaft nicht festgelegt wurde, ist ihr Standardwert NaN.

Weitere Einzelheiten finden Sie unter der Eigenschaft QGeoCoordinate::latitude

Längengrad

real longitude

Diese Eigenschaft enthält den Längengradwert der geografischen Position (Dezimalgrad). Ein positiver Längengrad gibt die östliche Hemisphäre an, ein negativer Längengrad die westliche Hemisphäre. Wenn die Eigenschaft nicht festgelegt wurde, ist ihr Standardwert NaN.

Weitere Einzelheiten finden Sie unter der Eigenschaft QGeoCoordinate::longitude

Höhe

real altitude

Diese Eigenschaft enthält den Höhenwert (Meter über dem Meeresspiegel). Wenn die Eigenschaft nicht festgelegt wurde, ist der Standardwert NaN.

Weitere Einzelheiten finden Sie in der Eigenschaft QGeoCoordinate::altitude

isValid

bool isValid

Diese Eigenschaft gibt die aktuelle Gültigkeit der Koordinate an. Koordinaten gelten als gültig, wenn sie mit einem gültigen Breitengrad und Längengrad festgelegt wurden (die 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.

Methoden

AbstandZu()

real distanceTo(coordinate 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ßkreisdistanz zwischen den beiden Koordinaten zurück, wobei davon ausgegangen wird, dass die Erde für die Zwecke dieser Berechnung kugelförmig ist.

azimutZu()

real azimuth(coordinate 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.

Bei dieser Berechnung wird davon ausgegangen, dass die Erde kugelförmig ist.

atDistanceAndAzimuth()

coordinate atDistanceAndAzimuth(real distance, real azimuth)

Gibt die Koordinate zurück, die erreicht wird, wenn man sich von dieser Koordinate aus in distance Metern und azimuth Grad entlang eines Großkreises bewegt.

Bei dieser Berechnung wird davon ausgegangen, dass die Erde kugelförmig ist.