QGeoPositionInfo Class
Die Klasse QGeoPositionInfo enthält Informationen über eine globale Position, Richtung und Geschwindigkeit zu einem bestimmten Zeitpunkt. Mehr...
| Kopfzeile: | #include <QGeoPositionInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QGeoPositionInfo ist Teil von Implicitly Shared Classes.
Öffentliche Typen
| enum | Attribute { Direction, GroundSpeed, VerticalSpeed, MagneticVariation, HorizontalAccuracy, …, DirectionAccuracy } |
Öffentliche Funktionen
| QGeoPositionInfo() | |
| QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp) | |
| QGeoPositionInfo(const QGeoPositionInfo &other) | |
(since 6.2) | QGeoPositionInfo(QGeoPositionInfo &&other) |
| ~QGeoPositionInfo() | |
| qreal | attribute(QGeoPositionInfo::Attribute attribute) const |
| QGeoCoordinate | coordinate() const |
| bool | hasAttribute(QGeoPositionInfo::Attribute attribute) const |
| bool | isValid() const |
| void | removeAttribute(QGeoPositionInfo::Attribute attribute) |
| void | setAttribute(QGeoPositionInfo::Attribute attribute, qreal value) |
| void | setCoordinate(const QGeoCoordinate &coordinate) |
| void | setTimestamp(const QDateTime ×tamp) |
(since 6.2) void | swap(QGeoPositionInfo &other) |
| QDateTime | timestamp() const |
(since 6.2) QGeoPositionInfo & | operator=(QGeoPositionInfo &&other) |
| QGeoPositionInfo & | operator=(const QGeoPositionInfo &other) |
Zugehörige Nicht-Members
| bool | operator!=(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs) |
| QDataStream & | operator<<(QDataStream &stream, QGeoPositionInfo::Attribute attr) |
| QDataStream & | operator<<(QDataStream &stream, const QGeoPositionInfo &info) |
| bool | operator==(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QGeoPositionInfo &info) |
| QDataStream & | operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr) |
Detaillierte Beschreibung
Eine QGeoPositionInfo enthält mindestens eine geografische Koordinate und einen Zeitstempel. Sie kann auch Kurs- und Geschwindigkeitsmessungen sowie Schätzungen der Genauigkeit der bereitgestellten Daten enthalten.
Siehe auch QGeoPositionInfoSource.
Dokumentation der Mitgliedstypen
enum QGeoPositionInfo::Attribute
Definiert die Attribute für Positionsangaben.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoPositionInfo::Direction | 0 | Die Peilung, gemessen in Grad im Uhrzeigersinn vom wahren Norden zur Fahrtrichtung. |
QGeoPositionInfo::GroundSpeed | 1 | Geschwindigkeit über Grund, in Metern/Sek. |
QGeoPositionInfo::VerticalSpeed | 2 | Die vertikale Geschwindigkeit in Metern/Sekunde. |
QGeoPositionInfo::MagneticVariation | 3 | Der Winkel zwischen der horizontalen Komponente des Magnetfelds und dem geografischen Norden, in Grad. Auch bekannt als magnetische Deklination. Ein positiver Wert bedeutet eine Abweichung vom geografischen Norden im Uhrzeigersinn und ein negativer Wert eine Abweichung gegen den Uhrzeigersinn. |
QGeoPositionInfo::HorizontalAccuracy | 4 | Die Genauigkeit des angegebenen Wertes für die geografische Länge und Breite, in Metern. |
QGeoPositionInfo::VerticalAccuracy | 5 | Die Genauigkeit des angegebenen Höhenwerts in Metern. |
QGeoPositionInfo::DirectionAccuracy | 6 | Die Genauigkeit der angegebenen Peilung in Grad. Dieses Attribut ist nur unter Android (API-Level 26 oder höher) und macOS/iOS verfügbar. Weitere Einzelheiten finden Sie in der entsprechenden Android- und Apple-Dokumentation. |
Das NMEA-Protokoll schlägt auch eine andere Art von Genauigkeit vor - PositionAccuracy, die ein 3D-Genauigkeitswert ist. Qt bietet kein separates Attribut für diesen Wert. Wenn Sie diesen Wert benötigen, können Sie ihn nach der folgenden Formel berechnen:
PositionAccuracy 2 = HorizontalAccuracy 2 + VerticalAccuracy 2
Dokumentation der Mitgliedsfunktionen
QGeoPositionInfo::QGeoPositionInfo()
Erzeugt ein ungültiges QGeoPositionInfo-Objekt.
Siehe auch isValid().
QGeoPositionInfo::QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp)
Erzeugt eine QGeoPositionInfo für die angegebenen coordinate und timestamp.
QGeoPositionInfo::QGeoPositionInfo(const QGeoPositionInfo &other)
Erzeugt eine QGeoPositionInfo mit den Werten von other.
[noexcept, since 6.2] QGeoPositionInfo::QGeoPositionInfo(QGeoPositionInfo &&other)
Erzeugt ein QGeoPositionInfo-Objekt durch Verschieben von other.
Beachten Sie, dass ein verschobenes QGeoPositionInfo nur zerstört oder zugewiesen werden kann. Die Wirkung des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren ist undefiniert.
Diese Funktion wurde in Qt 6.2 eingeführt.
[noexcept] QGeoPositionInfo::~QGeoPositionInfo()
Zerstört ein QGeoPositionInfo Objekt.
qreal QGeoPositionInfo::attribute(QGeoPositionInfo::Attribute attribute) const
Gibt den Wert des angegebenen attribute als qreal-Wert zurück.
Gibt NaN zurück, wenn der Wert nicht gesetzt wurde.
Die Funktion hasAttribute() sollte verwendet werden, um festzustellen, ob ein Wert für ein Attribut gesetzt wurde oder nicht.
Siehe auch hasAttribute() und setAttribute().
QGeoCoordinate QGeoPositionInfo::coordinate() const
Gibt die Koordinate für diese Position zurück.
Gibt eine ungültige Koordinate zurück, wenn keine Koordinate festgelegt wurde.
Siehe auch setCoordinate().
bool QGeoPositionInfo::hasAttribute(QGeoPositionInfo::Attribute attribute) const
Gibt true zurück, wenn die angegebene attribute für dieses QGeoPositionInfo Objekt vorhanden ist.
bool QGeoPositionInfo::isValid() const
Gibt true zurück, wenn die Werte timestamp() und coordinate() beide gültig sind.
Siehe auch QGeoCoordinate::isValid() und QDateTime::isValid().
void QGeoPositionInfo::removeAttribute(QGeoPositionInfo::Attribute attribute)
Entfernt die angegebene attribute und ihren Wert.
void QGeoPositionInfo::setAttribute(QGeoPositionInfo::Attribute attribute, qreal value)
Setzt den Wert für attribute auf value.
Siehe auch attribute().
void QGeoPositionInfo::setCoordinate(const QGeoCoordinate &coordinate)
Setzt die Koordinate für diese Position auf coordinate.
Siehe auch coordinate().
void QGeoPositionInfo::setTimestamp(const QDateTime ×tamp)
Legt das Datum und die Uhrzeit fest, zu der diese Position an timestamp gemeldet wurde.
Die timestamp muss in UTC-Zeit angegeben werden.
Siehe auch timestamp().
[noexcept, since 6.2] void QGeoPositionInfo::swap(QGeoPositionInfo &other)
Tauscht diese Positionsdaten mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.
Diese Funktion wurde in Qt 6.2 eingeführt.
QDateTime QGeoPositionInfo::timestamp() const
Gibt das Datum und die Uhrzeit zurück, zu der diese Position gemeldet wurde, in UTC-Zeit.
Gibt einen ungültigen QDateTime zurück, wenn kein Datums-/Zeitwert festgelegt wurde.
Siehe auch setTimestamp().
[noexcept, since 6.2] QGeoPositionInfo &QGeoPositionInfo::operator=(QGeoPositionInfo &&other)
Verschieben - weist die Werte von other diesem Objekt zu.
Beachten Sie, dass ein "moved-from" QGeoPositionInfo nur zerstört oder zugewiesen werden kann. Der Effekt des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren ist undefiniert.
Diese Funktion wurde in Qt 6.2 eingeführt.
QGeoPositionInfo &QGeoPositionInfo::operator=(const QGeoPositionInfo &other)
Weist die Werte von other dieser QGeoPositionInfo zu.
Verwandte Nicht-Mitglieder
bool operator!=(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs)
Gibt true zurück, wenn einer der Werte des Objekts lhs nicht mit dem Wert von rhs übereinstimmt. Andernfalls wird false zurückgegeben.
QDataStream &operator<<(QDataStream &stream, QGeoPositionInfo::Attribute attr)
Schreibt die angegebene Aufzählung attr in die angegebene stream.
Siehe auch Serialisierung von Qt-Datentypen.
QDataStream &operator<<(QDataStream &stream, const QGeoPositionInfo &info)
Schreibt die angegebene info in die angegebene stream.
Siehe auch Serialisierung von Qt-Datentypen.
bool operator==(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs)
Gibt true zurück, wenn alle Werte des Objekts lhs mit denen von rhs übereinstimmen. Andernfalls wird false zurückgegeben.
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo &info)
Liest eine Koordinate aus dem angegebenen stream in die angegebene info.
Siehe auch Serialisierung von Qt-Datentypen.
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr)
Liest eine Attribut-Aufzählung aus der angegebenen stream info die angegebene attr.
Siehe auch Serialisierung von Qt-Datentypen.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
