QGeoPositionInfo Class
Die Klasse „QGeoPositionInfo“ enthält Informationen zu einer globalen Position, Richtung und Geschwindigkeit zu einem bestimmten Zeitpunkt. Mehr...
| Header: | #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 gehört zu den implizit gemeinsam genutzten Klassen.
Ö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) |
Verwandte Nicht-Mitglieder
| 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) |
Ausführliche Beschreibung
Ein QGeoPositionInfo enthält mindestens eine geografische Koordinate und einen Zeitstempel. Es kann außerdem Kurs- und Geschwindigkeitsmessungen sowie Schätzungen zur Genauigkeit der bereitgestellten Daten enthalten.
Siehe auch „ QGeoPositionInfoSource “.
Dokumentation zu Mitgliedstypen
enum QGeoPositionInfo::Attribute
Definiert die Attribute für Positionsangaben.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoPositionInfo::Direction | 0 | Die Peilung, gemessen in Grad im Uhrzeigersinn vom geografischen Norden in Richtung der Fahrtrichtung. |
QGeoPositionInfo::GroundSpeed | 1 | Die Geschwindigkeit über Grund in Metern pro Sekunde. |
QGeoPositionInfo::VerticalSpeed | 2 | Die Vertikalgeschwindigkeit in Metern pro Sekunde. |
QGeoPositionInfo::MagneticVariation | 3 | Der Winkel zwischen der horizontalen Komponente des Magnetfelds und dem geografischen Norden, in Grad. Auch als magnetische Deklination bezeichnet. Ein positiver Wert bezeichnet eine Richtung im Uhrzeigersinn vom geografischen Norden aus, ein negativer Wert eine Richtung gegen den Uhrzeigersinn. |
QGeoPositionInfo::HorizontalAccuracy | 4 | Die Genauigkeit der angegebenen Längen- und Breitengradwerte, in Metern. |
QGeoPositionInfo::VerticalAccuracy | 5 | Die Genauigkeit der bereitgestellten Höhenangabe in Metern. |
QGeoPositionInfo::DirectionAccuracy | 6 | Die Genauigkeit der angegebenen Peilung, in Grad. Dieses Attribut ist nur auf Android (API-Level 26 oder höher) und macOS/iOS verfügbar. Weitere Details finden Sie in der entsprechenden Dokumentation von Android und Apple. |
Das NMEA-Protokoll sieht außerdem eine weitere Art der Genauigkeit vor – „PositionAccuracy“ –, bei der es sich um einen 3D-Genauigkeitswert handelt. Qt stellt hierfür kein separates Attribut zur Verfügung. Wenn Sie diesen Wert benötigen, können Sie ihn anhand der folgenden Formel berechnen:
PositionAccuracy 2 = HorizontalAccuracy 2 + VerticalAccuracy 2
Dokumentation zu den Member-Funktionen
QGeoPositionInfo::QGeoPositionInfo()
Erstellt ein ungültiges QGeoPositionInfo-Objekt.
Siehe auch isValid().
QGeoPositionInfo::QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp)
Erstellt ein `QGeoPositionInfo`-Objekt für die angegebenen Werte ` coordinate ` und ` timestamp`.
QGeoPositionInfo::QGeoPositionInfo(const QGeoPositionInfo &other)
Erstellt ein `QGeoPositionInfo`-Objekt mit den Werten von ` other`.
[constexpr noexcept default, since 6.2] QGeoPositionInfo::QGeoPositionInfo(QGeoPositionInfo &&other)
Erstellt ein QGeoPositionInfo-Objekt, indem es von „ other “ verschoben wird.
Beachten Sie, dass ein verschobenes `QGeoPositionInfo`-Objekt nur zerstört oder zugewiesen werden kann. Die Auswirkungen des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren sind undefiniert.
Diese Funktion wurde in Qt 6.2 eingeführt.
[noexcept] QGeoPositionInfo::~QGeoPositionInfo()
Löscht 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 festgelegt wurde.
Um festzustellen, ob für ein Attribut ein Wert gesetzt wurde, sollte die Funktion ` hasAttribute()` verwendet werden.
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 von „ timestamp()“ und „ coordinate()“ beide gültig sind.
Siehe auch QGeoCoordinate::isValid() und QDateTime::isValid().
void QGeoPositionInfo::removeAttribute(QGeoPositionInfo::Attribute attribute)
Entfernt den angegebenen „ attribute “ und dessen 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.
timestamp muss in UTC-Zeit angegeben werden.
Siehe auch timestamp().
[noexcept, since 6.2] void QGeoPositionInfo::swap(QGeoPositionInfo &other)
Tauscht diese Positionsinformationen mit „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.
Diese Funktion wurde in Qt 6.2 eingeführt.
QDateTime QGeoPositionInfo::timestamp() const
Gibt das Datum und die Uhrzeit zurück, zu denen diese Position gemeldet wurde (in UTC).
Gibt ein ungültiges ` QDateTime ` zurück, wenn kein Datums-/Zeitwert festgelegt wurde.
Siehe auch ` setTimestamp()`.
[noexcept, since 6.2] QGeoPositionInfo &QGeoPositionInfo::operator=(QGeoPositionInfo &&other)
„move“ weist diesem Objekt die Werte aus „ other “ zu.
Beachten Sie, dass ein „ QGeoPositionInfo “, von dem Werte verschoben wurden, nur zerstört oder neu zugewiesen werden kann. Die Auswirkungen des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren sind undefiniert.
Diese Funktion wurde in Qt 6.2 eingeführt.
QGeoPositionInfo &QGeoPositionInfo::operator=(const QGeoPositionInfo &other)
Weist diesem QGeoPositionInfo die Werte von other 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 denen 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 vonQt-Datentypen“.
QDataStream &operator<<(QDataStream &stream, const QGeoPositionInfo &info)
Schreibt die angegebene ` info ` in die angegebene ` stream`.
Siehe auch „Serialisierung vonQt-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 das angegebene „ info “ ein.
Siehe auch „Serialisierung vonQt-Datentypen“.
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr)
Liest eine Attributaufzählung aus den angegebenen „ stream “-Informationen unter der angegebenen „ attr “ aus.
Siehe auch „Serialisierung vonQt-Datentypen“.
© 2026 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.
