QGeoSatelliteInfo Class
Die Klasse „QGeoSatelliteInfo“ enthält grundlegende Informationen zu einem Satelliten. Mehr...
| Header: | #include <QGeoSatelliteInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QGeoSatelliteInfo gehört zu den implizit gemeinsam genutzten Klassen.
Öffentliche Typen
| enum | Attribute { Elevation, Azimuth } |
| enum | SatelliteSystem { Undefined, GPS, GLONASS, GALILEO, BEIDOU, …, CustomType } |
Eigenschaften
- satelliteIdentifier : int
- satelliteSystem : SatelliteSystem
- signalStrength : qreal
Öffentliche Veranstaltungen
| 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) |
Verwandte Nicht-Mitglieder
| 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) |
Siehe auch „ QGeoSatelliteInfoSource “.
Dokumentation zum Mitgliedstyp
enum QGeoSatelliteInfo::Attribute
Definiert die Attribute für die Satelliteninformationen.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoSatelliteInfo::Elevation | 0 | Die Elevation des Satelliten in Grad. |
QGeoSatelliteInfo::Azimuth | 1 | Der Azimut in Richtung des geografischen Nordens, in Grad. |
enum QGeoSatelliteInfo::SatelliteSystem
Definiert das GNSS-System des Satelliten.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoSatelliteInfo::Undefined | 0x00 | Nicht definiert. |
QGeoSatelliteInfo::GPS | 0x01 | Global Positioning System (USA). |
QGeoSatelliteInfo::GLONASS | 0x02 | Globales Positionierungssystem (Russland). |
QGeoSatelliteInfo::GALILEO | 0x03 | Globales Navigationssatellitensystem (EU). |
QGeoSatelliteInfo::BEIDOU | 0x04 | BeiDou-Navigationssatellitensystem (China). |
QGeoSatelliteInfo::QZSS | 0x05 | Quasi-Zenith-Satellitensystem (Japan). |
QGeoSatelliteInfo::IRNSS (since Qt 6.12) | 0x06 | Indisches regionales Satellitennavigationssystem. |
QGeoSatelliteInfo::SBAS (since Qt 6.12) | 0x07 | Satellitengestütztes Erweiterungssystem. |
QGeoSatelliteInfo::Multiple | 0xFF | Dieser Typ gibt normalerweise an, dass die Informationen von einem Gerät empfangen werden, das mehrere Satellitensysteme unterstützt, und das Satellitensystem nicht explizit angegeben ist. Je nach Datenquelle können Sie möglicherweise andere Informationen heranziehen, um den tatsächlichen Systemtyp zu ermitteln. Ein Beispiel für die Verwendung dieses Typs ist eine NMEA-$GNGSA-Meldung, die die IDs der verwendeten Satelliten enthält, deren Systemtypen jedoch nicht explizit nennt. |
QGeoSatelliteInfo::CustomType | 0x100 | Der erste Typ, der für Benutzerzwecke verwendet werden kann. Zum Beispiel bei der Neuimplementierung der NMEA-Datenauswertung in QNmeaSatelliteInfoSource. Benutzer können weitere Typen über CustomType + 1, CustomType + 2 usw. hinzufügen. |
Dokumentation zu den Eigenschaften
[read-only] satelliteIdentifier : int
Diese Eigenschaft enthält die Identifikationsnummer des Satelliten.
Die Satelliten-Identifikationsnummer kann zur Identifizierung eines Satelliten innerhalb des Satellitensystems verwendet werden.
Der tatsächliche Wert kann je nach Plattform und ausgewähltem Backend variieren.
Wird beispielsweise das NMEA- Plugin verwendet, entspricht die Satellitenkennung für das GPS-Satellitensystem der PRN-Nummer (Pseudo-Random Noise), während die Satellitenkennung für das GLONASS-Satellitensystem der Slot-Nummer entspricht.
Bei NMEA-basierten Backends kann die Satelliten-Identifikationsnummer zur Bestimmung des Satellitensystemtyps verwendet werden, falls dieser nicht aus anderen Quellen verfügbar ist. In der Liste der Satelliten-IDs können Sie die ID-Bereiche für verschiedene Satellitensysteme nachschlagen.
Hinweis: Je nach Plattform und ausgewähltem Backend können sich die Satelliten-ID-Bereiche verschiedener Satellitensysteme überschneiden. Um einen Satelliten eindeutig zu identifizieren, muss eine Kombination aus `satelliteIdentifier()` und ` satelliteSystem()` verwendet werden.
Zugriffsfunktionen:
| int | satelliteIdentifier() const |
[read-only] satelliteSystem : SatelliteSystem
Diese Eigenschaft gibt das verwendete Satellitensystem an, z. B. GPS oder GLONASS.
Gibt das Satellitensystem zurück (GPS, GLONASS, ...)
Hinweis: Dieser Wert kann zusammen mit „ satelliteIdentifier “ verwendet werden, um einen Satelliten eindeutig zu identifizieren.
Zugriffsfunktionen:
| QGeoSatelliteInfo::SatelliteSystem | satelliteSystem() const |
Siehe auch „ satelliteIdentifier “.
[read-only] signalStrength : qreal
Diese Eigenschaft enthält die Signalstärke.
Zugriffsfunktionen:
| int | signalStrength() const |
Dokumentation der Member-Funktionen
QGeoSatelliteInfo::QGeoSatelliteInfo()
Erstellt ein Satelliteninformationsobjekt.
QGeoSatelliteInfo::QGeoSatelliteInfo(const QGeoSatelliteInfo &other)
Erstellt ein Satelliteninformationsobjekt mit den Werten von „ other “.
[constexpr noexcept default, since 6.2] QGeoSatelliteInfo::QGeoSatelliteInfo(QGeoSatelliteInfo &&other)
Erstellt ein Satelliteninformationsobjekt, indem es aus „ other “ verschoben wird.
Beachten Sie, dass ein QGeoSatelliteInfo, das verschoben wurde, nur zerstört oder zugewiesen werden kann. Die Auswirkung 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()
Löscht ein Satelliten-Informationsobjekt.
[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 festgelegt wurde.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe „ Q_INVOKABLE “.
Siehe auch ` hasAttribute()` und ` setAttribute()`.
[invokable] bool QGeoSatelliteInfo::hasAttribute(QGeoSatelliteInfo::Attribute attribute) const
Gibt „true“ zurück, wenn das angegebene „ attribute “ in diesem Update vorhanden ist.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
void QGeoSatelliteInfo::removeAttribute(QGeoSatelliteInfo::Attribute attribute)
Entfernt den angegebenen „ attribute “ und dessen Wert.
int QGeoSatelliteInfo::satelliteIdentifier() const
Gibt die Identifikationsnummer des Satelliten zurück.
Hinweis: Getter -Funktion für die Eigenschaft „satelliteIdentifier“.
Siehe auch „ setSatelliteIdentifier()“ und „ satelliteSystem()“.
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 Satelliten-Identifikationsnummer auf „ satId “.
Die Satelliten-Identifikationsnummer kann zur Identifizierung eines Satelliten innerhalb des Satellitensystems verwendet werden.
Der tatsächliche Wert kann je nach Plattform und ausgewähltem Backend variieren.
Wird beispielsweise das NMEA- Plugin verwendet, entspricht die Satellitenkennung für das GPS-Satellitensystem der PRN-Nummer (Pseudo-Random Noise), während die Satellitenkennung für das GLONASS-Satellitensystem der Slot-Nummer entspricht.
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)
Stellt die Signalstärke auf signalStrength in Dezibel ein.
Siehe auch ` signalStrength()`.
int QGeoSatelliteInfo::signalStrength() const
Gibt die Signalstärke zurück oder -1, wenn der Wert nicht festgelegt wurde.
Hinweis: Getter -Funktion für die Eigenschaft „signalStrength“.
Siehe auch „ setSignalStrength()“.
[noexcept, since 6.2] void QGeoSatelliteInfo::swap(QGeoSatelliteInfo &other)
Tauscht diese Satellitendaten mit other aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.
Diese Funktion wurde in Qt 6.2 eingeführt.
[noexcept, since 6.2] QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(QGeoSatelliteInfo &&other)
Weist diesem Objekt den Wert aus „ other “ per Move-Zuweisung zu
Beachten Sie, dass ein „ QGeoSatelliteInfo “, aus dem ein Wert verschoben wurde, 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.
QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(const QGeoSatelliteInfo &other)
Weist diesem Objekt die Werte aus „ 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 denen 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 vonQt-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 Satellitendaten aus der angegebenen Datei „ stream “ in die angegebene Datei „ info “ ein.
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.
