QGeoCoordinate Class

Dokumentation zu den Mitgliedsfunktionen

QGeoCoordinate::QGeoCoordinate()

Erstellt eine Koordinate. Die Koordinate ist erst gültig, nachdem die Funktionen „ setLatitude()“ und „ setLongitude()“ aufgerufen wurden.

QGeoCoordinate::QGeoCoordinate(double latitude, double longitude)

Erstellt eine Koordinate mit den angegebenen Werten für „ latitude “ und „ longitude “.

Liegt der Breitengrad nicht im Bereich von -90 bis einschließlich 90 oder der Längengrad nicht im Bereich von -180 bis einschließlich 180, wird keiner der Werte gesetzt und die Funktion ` type()` gibt ` QGeoCoordinate::InvalidCoordinate` zurück.

Siehe auch ` isValid()`.

QGeoCoordinate::QGeoCoordinate(double latitude, double longitude, double altitude)

Erstellt eine Koordinate mit den angegebenen Werten „ latitude “, „ longitude “ und „ altitude “.

Liegt der Breitengrad nicht im Bereich von -90 bis einschließlich 90 oder der Längengrad nicht im Bereich von -180 bis einschließlich 180, wird keiner der Werte gesetzt und type() ist gleich QGeoCoordinate::InvalidCoordinate.

Beachten Sie, dass „ altitude “ die Höhe in Metern über dem Meeresspiegel angibt.

Siehe auch ` isValid()`.

QGeoCoordinate::QGeoCoordinate(const QGeoCoordinate &other)

Erstellt eine Koordinate aus dem Inhalt von „ other “.

[constexpr noexcept default, since 6.2] QGeoCoordinate::QGeoCoordinate(QGeoCoordinate &&other)

Erstellt eine Koordinate durch Verschieben von other.

Diese Funktion wurde in Qt 6.2 eingeführt.

[noexcept] QGeoCoordinate::~QGeoCoordinate()

Löscht das Koordinatenobjekt.

double QGeoCoordinate::altitude() const

Gibt die Höhe (in Metern über dem Meeresspiegel) zurück.

Der Rückgabewert ist undefiniert, wenn die Höhe nicht festgelegt wurde.

Siehe auch setAltitude() und type().

[invokable] QGeoCoordinate QGeoCoordinate::atDistanceAndAzimuth(qreal distance, qreal azimuth, qreal distanceUp = 0.0) const

Gibt die Koordinate zurück, die erreicht wird, wenn man von der aktuellen Koordinate bei azimuth (bzw. Peilung) entlang eines Großkreises distance Meter zurücklegt. Für diese Berechnung wird davon ausgegangen, dass die Erde kugelförmig ist.

Zur Höhe wird ein Wert von distanceUp addiert.

Gibt eine ungültige Koordinate zurück, wenn diese Koordinate ungültig ist.

[invokable] qreal QGeoCoordinate::azimuthTo(const QGeoCoordinate &other) const

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.

Die zurückgegebene Peilung ist die Peilung vom Ursprung zu ` other ` entlang des Großkreises zwischen den beiden Koordinaten. Für diese Berechnung wird davon ausgegangen, dass die Erde kugelförmig ist.

Gibt 0 zurück, wenn der Typ dieser Koordinate oder der Typ von ` other ` ` QGeoCoordinate::InvalidCoordinate` ist.

[invokable] qreal QGeoCoordinate::distanceTo(const QGeoCoordinate &other) const

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 liefert die Großkreisdistanz zwischen den beiden Koordinaten, wobei für diese Berechnung davon ausgegangen wird, dass die Erde kugelförmig ist.

Gibt 0 zurück, wenn der Typ dieser Koordinate oder der Typ von ` other ` ` QGeoCoordinate::InvalidCoordinate` ist.

bool QGeoCoordinate::isValid() const

Gibt „ true “ zurück, wenn „ longitude “ und „ latitude “ gültig sind.

double QGeoCoordinate::latitude() const

Gibt den Breitengrad in Dezimalgrad zurück. Der Rückgabewert ist undefiniert, wenn der Breitengrad nicht festgelegt wurde.

Ein positiver Breitengrad bezeichnet die nördliche Hemisphäre, ein negativer Breitengrad die südliche Hemisphäre.

Siehe auch „ setLatitude()“ und „ type()“.

double QGeoCoordinate::longitude() const

Gibt den Längengrad in Dezimalgrad zurück. Der Rückgabewert ist undefiniert, wenn der Längengrad nicht festgelegt wurde.

Ein positiver Längengrad bezeichnet die östliche Hemisphäre, ein negativer Längengrad die westliche Hemisphäre.

Siehe auch „ setLongitude()“ und „ type()“.

void QGeoCoordinate::setAltitude(double altitude)

Setzt die Höhe (in Metern über dem Meeresspiegel) auf „ altitude “.

Siehe auch „ altitude()“.

void QGeoCoordinate::setLatitude(double latitude)

Setzt den Breitengrad (in Dezimalgrad) auf latitude. Der Wert sollte im WGS84-Bezugssystem angegeben werden.

Um gültig zu sein, muss der Breitengrad zwischen -90 und 90 (einschließlich) liegen.

Siehe auch latitude().

void QGeoCoordinate::setLongitude(double longitude)

Setzt die Längengradangabe (in Dezimalgrad) auf longitude. Der Wert sollte im WGS84-Bezugssystem angegeben werden.

Um gültig zu sein, muss der Längengrad zwischen -180 und 180 (einschließlich) liegen.

Siehe auch „ longitude()“.

[noexcept, since 6.2] void QGeoCoordinate::swap(QGeoCoordinate &other)

Tauscht diese Koordinate mit other aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

Diese Funktion wurde in Qt 6.2 eingeführt.

[invokable] QString QGeoCoordinate::toString(QGeoCoordinate::CoordinateFormat format = DegreesMinutesSecondsWithHemisphere) const

Gibt diese Koordinate als Zeichenkette im angegebenen Format „ format “ zurück.

Wenn diese Koordinate beispielsweise eine Breite von -27,46758, eine Länge von 153,027892 und eine Höhe von 28,1 hat, werden je nach „ format “ folgende Zeichenfolgen zurückgegeben:

Das Feld „Höhe“ wird weggelassen, wenn keine Höhe angegeben ist.

Ist die Koordinate ungültig, wird eine leere Zeichenkette zurückgegeben.

QGeoCoordinate::CoordinateType QGeoCoordinate::type() const

Gibt den Typ dieser Koordinate zurück.

[noexcept, since 6.2] QGeoCoordinate &QGeoCoordinate::operator=(QGeoCoordinate &&other)

Die Move-Zuweisung weist „ other “ dieser Koordinate zu und gibt einen Verweis auf diese Koordinate zurück.

Diese Funktion wurde in Qt 6.2 eingeführt.

QGeoCoordinate &QGeoCoordinate::operator=(const QGeoCoordinate &other)

Weist dieser Koordinate den Wert „ other “ zu und gibt eine Referenz auf diese Koordinate zurück.