QGeoSatelliteInfo Class

Die Klasse QGeoSatelliteInfo enthält grundlegende Informationen über einen Satelliten. Mehr...

Kopfzeile: #include <QGeoSatelliteInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning

Öffentliche Typen

enum Attribute { Elevation, Azimuth }
enum SatelliteSystem { Undefined, GPS, GLONASS, GALILEO, BEIDOU, …, CustomType }

Öffentliche Funktionen

QGeoSatelliteInfo()
QGeoSatelliteInfo(const QGeoSatelliteInfo &other)
(since 6.2) QGeoSatelliteInfo(QGeoSatelliteInfo &&other)
~QGeoSatelliteInfo()
qreal attribute(QGeoSatelliteInfo::Attribute attribute) const
bool hasAttribute(QGeoSatelliteInfo::Attribute attribute) const
void removeAttribute(QGeoSatelliteInfo::Attribute attribute)
int satelliteIdentifier() const
QGeoSatelliteInfo::SatelliteSystem satelliteSystem() const
void setAttribute(QGeoSatelliteInfo::Attribute attribute, qreal value)
void setSatelliteIdentifier(int satId)
void setSatelliteSystem(QGeoSatelliteInfo::SatelliteSystem system)
void setSignalStrength(int signalStrength)
int signalStrength() const
(since 6.2) void swap(QGeoSatelliteInfo &other)
(since 6.2) QGeoSatelliteInfo &operator=(QGeoSatelliteInfo &&other)
QGeoSatelliteInfo &operator=(const QGeoSatelliteInfo &other)
bool operator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
QDataStream &operator<<(QDataStream &stream, const QGeoSatelliteInfo &info)
bool operator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
QDataStream &operator>>(QDataStream &stream, QGeoSatelliteInfo &info)

Detaillierte Beschreibung

Siehe auch QGeoSatelliteInfoSource.

Dokumentation der Mitgliedstypen

enum QGeoSatelliteInfo::Attribute

Legt die Attribute für die Satelliteninformationen fest.

KonstanteWertBeschreibung
QGeoSatelliteInfo::Elevation0Die Elevation des Satelliten, in Grad.
QGeoSatelliteInfo::Azimuth1Der Azimut zum geografischen Norden in Grad.

enum QGeoSatelliteInfo::SatelliteSystem

Legt das GNSS-System des Satelliten fest.

KonstanteWertBeschreibung
QGeoSatelliteInfo::Undefined0x00Nicht definiert.
QGeoSatelliteInfo::GPS0x01Globales Positionsbestimmungssystem (USA).
QGeoSatelliteInfo::GLONASS0x02Globales Positionsbestimmungssystem (Russland).
QGeoSatelliteInfo::GALILEO0x03Globales Satellitennavigationssystem (EU).
QGeoSatelliteInfo::BEIDOU0x04BeiDou Navigationssatellitensystem (China).
QGeoSatelliteInfo::QZSS0x05Quasi-Zenith-Satellitensystem (Japan).
QGeoSatelliteInfo::Multiple0xFFDieser Typ zeigt normalerweise an, dass die Informationen von einem Gerät empfangen werden, das mehrere Satellitensysteme unterstützt, wobei das Satellitensystem nicht explizit angegeben ist. Je nach Datenquelle können Sie andere Informationen verwenden, um den tatsächlichen Systemtyp zu bestimmen. Ein Beispiel für die Verwendung dieses Typs ist eine NMEA $GNGSA-Nachricht, die die IDs der verwendeten Satelliten enthält, deren Systemtypen aber nicht explizit angegeben werden.
QGeoSatelliteInfo::CustomType0x100Der erste Typ, der für Benutzerzwecke verwendet werden kann. Zum Beispiel bei der Neuimplementierung von NMEA-Datenparsing in QNmeaSatelliteInfoSource. Der Benutzer kann weitere Typen hinzufügen, indem er CustomType + 1, CustomType + 2 und so weiter verwendet.

Dokumentation der Mitgliedsfunktionen

QGeoSatelliteInfo::QGeoSatelliteInfo()

Erzeugt ein Satelliteninformationsobjekt.

QGeoSatelliteInfo::QGeoSatelliteInfo(const QGeoSatelliteInfo &other)

Erzeugt ein Satelliteninformationsobjekt mit den Werten von other.

[noexcept, since 6.2] QGeoSatelliteInfo::QGeoSatelliteInfo(QGeoSatelliteInfo &&other)

Erzeugt ein Satelliteninformationsobjekt durch Verschieben von other.

Beachten Sie, dass ein verschobenes QGeoSatelliteInfo 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.

[noexcept] QGeoSatelliteInfo::~QGeoSatelliteInfo()

Zerstört ein Satelliteninformationsobjekt.

[invokable] qreal QGeoSatelliteInfo::attribute(QGeoSatelliteInfo::Attribute attribute) const

Gibt den Wert des angegebenen attribute als qreal-Wert zurück.

Gibt -1 zurück, wenn der Wert nicht gesetzt wurde.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch hasAttribute() und setAttribute().

[invokable] bool QGeoSatelliteInfo::hasAttribute(QGeoSatelliteInfo::Attribute attribute) const

Gibt true zurück, wenn die angegebene attribute in dieser Aktualisierung vorhanden ist.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

void QGeoSatelliteInfo::removeAttribute(QGeoSatelliteInfo::Attribute attribute)

Entfernt die angegebene attribute und ihren Wert.

int QGeoSatelliteInfo::satelliteIdentifier() const

Gibt die Nummer der Satellitenkennung zurück.

Die Satellitenkennnummer kann zur Identifizierung eines Satelliten innerhalb des Satellitensystems verwendet werden.

Der tatsächliche Wert kann je nach Plattform und ausgewähltem Backend variieren.

Wenn beispielsweise das nmea-Plugin verwendet wird, entspricht die Satellitenkennung für das GPS-Satellitensystem der PRN-Nummer (Pseudo-Random Noise) und die Satellitenkennung für das GLONASS-Satellitensystem der Slot-Nummer.

Bei NMEA-basierten Backends kann die Satellitenkennung verwendet werden, um den Typ des Satellitensystems zu bestimmen, wenn sie nicht aus anderen Quellen verfügbar ist. In der Liste der Satelliten-IDs können Sie die ID-Bereiche für verschiedene Satellitensysteme überprüfen.

Hinweis: Je nach Plattform und ausgewähltem Backend können sich die Satelliten-Kennungsbereiche für verschiedene Satellitensysteme überschneiden. Um einen Satelliten eindeutig zu identifizieren, muss eine Kombination aus satelliteIndetifier() und satelliteSystem() verwendet werden.

Hinweis: Getter-Funktion für die Eigenschaft satelliteIdentifier.

Siehe auch setSatelliteIdentifier() und satelliteSystem().

QGeoSatelliteInfo::SatelliteSystem QGeoSatelliteInfo::satelliteSystem() const

Liefert das Satellitensystem (GPS, GLONASS, ...)

Hinweis: Dieser Wert kann zusammen mit satelliteIdentifier() zur eindeutigen Identifizierung eines Satelliten verwendet werden.

Hinweis: Getter-Funktion für die Eigenschaft satelliteSystem.

Siehe auch setSatelliteSystem() und satelliteIdentifier().

void QGeoSatelliteInfo::setAttribute(QGeoSatelliteInfo::Attribute attribute, qreal value)

Setzt den Wert für attribute auf value.

Siehe auch attribute().

void QGeoSatelliteInfo::setSatelliteIdentifier(int satId)

Setzt die Satellitenkennnummer auf satId.

Die Satellitenkennnummer kann verwendet werden, um einen Satelliten innerhalb des Satellitensystems zu identifizieren.

Der tatsächliche Wert kann je nach Plattform und ausgewähltem Backend variieren.

Wenn beispielsweise das nmea-Plugin verwendet wird, entspricht die Satellitenkennung für das GPS-Satellitensystem der PRN-Nummer (Pseudo-Random-Noise), und die Satellitenkennung für das GLONASS-Satellitensystem entspricht der Slot-Nummer.

Siehe auch satelliteIdentifier().

void QGeoSatelliteInfo::setSatelliteSystem(QGeoSatelliteInfo::SatelliteSystem system)

Stellt das Satellitensystem (GPS, GLONASS, ...) auf system ein.

Siehe auch satelliteSystem().

void QGeoSatelliteInfo::setSignalStrength(int signalStrength)

Setzt die Signalstärke auf signalStrength, in Dezibel.

Siehe auch signalStrength().

int QGeoSatelliteInfo::signalStrength() const

Gibt die Signalstärke zurück, oder -1, wenn der Wert nicht gesetzt wurde.

Hinweis: Getter-Funktion für die Eigenschaft signalStrength.

Siehe auch setSignalStrength().

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

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

Diese Funktion wurde in Qt 6.2 eingeführt.

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

Verschieben - weist diesem Objekt den Wert von other zu.

Beachten Sie, dass ein "moved-from" QGeoSatelliteInfo 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.

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

Weist diesem Objekt die Werte von other zu.

Verwandte Nicht-Mitglieder

bool operator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)

Gibt true zurück, wenn einer der Parameter des Satelliten lhs nicht mit den Parametern von rhs übereinstimmt. Andernfalls wird false zurückgegeben.

QDataStream &operator<<(QDataStream &stream, const QGeoSatelliteInfo &info)

Schreibt die angegebene info in die angegebene stream.

Siehe auch Serialisierung von Qt-Datentypen.

bool operator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)

Gibt true zurück, wenn alle Parameter des Satelliten lhs mit denen von rhs übereinstimmen. Andernfalls wird false zurückgegeben.

QDataStream &operator>>(QDataStream &stream, QGeoSatelliteInfo &info)

Liest Satelliteninformationen aus dem angegebenen stream in den angegebenen info.

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.