QGeoSatelliteInfo Class
La classe `QGeoSatelliteInfo` contient des informations de base sur un satellite. En savoir plus...
| En-tête : | #include <QGeoSatelliteInfo> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake : | QT += positioning |
- Liste de tous les membres, y compris les membres hérités
- QGeoSatelliteInfo fait partie des classes partagées implicitement.
Types publics
| enum | Attribute { Elevation, Azimuth } |
| enum | SatelliteSystem { Undefined, GPS, GLONASS, GALILEO, BEIDOU, …, CustomType } |
Propriétés
- satelliteIdentifier : int
- satelliteSystem : SatelliteSystem
- signalStrength : qreal
Fonctions publiques
| 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) |
Personnes extérieures concernées
| 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) |
Voir aussi QGeoSatelliteInfoSource.
Documentation sur les types de membres
enum QGeoSatelliteInfo::Attribute
Définit les attributs relatifs aux informations sur les satellites.
| Constante | Valeur | Description |
|---|---|---|
QGeoSatelliteInfo::Elevation | 0 | L'élévation du satellite, en degrés. |
QGeoSatelliteInfo::Azimuth | 1 | L'azimut par rapport au nord géographique, en degrés. |
enum QGeoSatelliteInfo::SatelliteSystem
Définit le système GNSS du satellite.
| Constante | Valeur | Description |
|---|---|---|
QGeoSatelliteInfo::Undefined | 0x00 | Non défini. |
QGeoSatelliteInfo::GPS | 0x01 | Système de positionnement global (États-Unis). |
QGeoSatelliteInfo::GLONASS | 0x02 | Système de positionnement global (Russie). |
QGeoSatelliteInfo::GALILEO | 0x03 | Système mondial de navigation par satellite (UE). |
QGeoSatelliteInfo::BEIDOU | 0x04 | Système de navigation par satellite BeiDou (Chine). |
QGeoSatelliteInfo::QZSS | 0x05 | Système de satellites quasi-zénithaux (Japon). |
QGeoSatelliteInfo::IRNSS (since Qt 6.12) | 0x06 | Système régional indien de navigation par satellite. |
QGeoSatelliteInfo::SBAS (since Qt 6.12) | 0x07 | Système d’augmentation par satellite. |
QGeoSatelliteInfo::Multiple | 0xFF | Ce type indique généralement que les informations proviennent d’un appareil prenant en charge plusieurs systèmes satellitaires, sans que le système en question ne soit explicitement spécifié. Selon la source des données, vous pouvez utiliser d’autres informations pour déterminer le type de système réel. Un exemple d’utilisation de ce type est un message NMEA $GNGSA, qui contient les identifiants des satellites utilisés, mais ne mentionne pas explicitement leurs types de système. |
QGeoSatelliteInfo::CustomType | 0x100 | Premier type pouvant être utilisé à des fins utilisateur. Par exemple, lors de la réimplémentation de l’analyse des données NMEA dans QNmeaSatelliteInfoSource. L’utilisateur peut ajouter d’autres types à l’aide de CustomType + 1, CustomType + 2, etc. |
Documentation sur les propriétés
[read-only] satelliteIdentifier : int
Cette propriété contient le numéro d'identification du satellite.
Le numéro d'identification du satellite permet d'identifier un satellite au sein du système satellitaire.
La valeur réelle peut varier en fonction de la plateforme et du backend sélectionné.
Par exemple, si le plugin NMEA est utilisé, l’identifiant de satellite pour le système GPS correspond au numéro PRN (bruit pseudo-aléatoire), tandis que celui du système GLONASS correspond au numéro de slot.
Pour les backends basés sur le protocole NMEA, l’identifiant de satellite peut servir à déterminer le type de système satellitaire s’il n’est pas disponible à partir d’autres sources. Vous pouvez consulter la liste des identifiants de satellites pour vérifier les plages d’identifiants des différents systèmes satellitaires.
Remarque : en fonction de la plateforme et du backend sélectionné, les plages d’identifiants de satellites des différents systèmes peuvent se chevaucher. Pour identifier un satellite de manière unique, il faut utiliser une combinaison des fonctions `satelliteIdentifier()` et ` satelliteSystem()`.
Fonctions d'accès :
| int | satelliteIdentifier() const |
[read-only] satelliteSystem : SatelliteSystem
Cette propriété indique le système de navigation par satellite utilisé, tel que le GPS ou le GLONASS.
Renvoie le système satellitaire (GPS, GLONASS, etc.)
Remarque : cette valeur peut être utilisée conjointement avec la propriété « satelliteIdentifier » pour identifier de manière unique un satellite.
Fonctions d'accès :
| QGeoSatelliteInfo::SatelliteSystem | satelliteSystem() const |
Voir également satelliteIdentifier.
[read-only] signalStrength : qreal
Cette propriété contient la puissance du signal.
Fonctions d'accès :
| int | signalStrength() const |
Documentation des fonctions membres
QGeoSatelliteInfo::QGeoSatelliteInfo()
Crée un objet d'information satellite.
QGeoSatelliteInfo::QGeoSatelliteInfo(const QGeoSatelliteInfo &other)
Crée un objet d'information satellite avec les valeurs de other.
[constexpr noexcept default, since 6.2] QGeoSatelliteInfo::QGeoSatelliteInfo(QGeoSatelliteInfo &&other)
Crée un objet d'informations sur un satellite en le dérivant de ` other`.
Notez qu'un objet QGeoSatelliteInfo issu d'un déplacement ne peut être que détruit ou affecté. L'effet de l'appel à d'autres fonctions que le destructeur ou l'un des opérateurs d'affectation est indéfini.
Cette fonction a été introduite dans Qt 6.2.
[noexcept] QGeoSatelliteInfo::~QGeoSatelliteInfo()
Détruit un objet d'information satellite.
[invokable] qreal QGeoSatelliteInfo::attribute(QGeoSatelliteInfo::Attribute attribute) const
Renvoie la valeur de l'attribute spécifiée sous forme de valeur qreal.
Renvoie -1 si la valeur n’a pas été définie.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également ` hasAttribute()` et ` setAttribute()`.
[invokable] bool QGeoSatelliteInfo::hasAttribute(QGeoSatelliteInfo::Attribute attribute) const
Renvoie « true » si l'attribute e spécifiée est présente dans cette mise à jour.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
void QGeoSatelliteInfo::removeAttribute(QGeoSatelliteInfo::Attribute attribute)
Supprime l'attribute e spécifiée et sa valeur.
int QGeoSatelliteInfo::satelliteIdentifier() const
Renvoie le numéro d'identification du satellite.
Remarque : fonctiongetter pour la propriété satelliteIdentifier.
Voir également setSatelliteIdentifier() et satelliteSystem().
void QGeoSatelliteInfo::setAttribute(QGeoSatelliteInfo::Attribute attribute, qreal value)
Définit la valeur de « attribute » sur « value ».
Voir également attribute().
void QGeoSatelliteInfo::setSatelliteIdentifier(int satId)
Définit le numéro d'identification du satellite sur satId.
Le numéro d'identification du satellite permet d'identifier un satellite au sein du système satellitaire.
La valeur réelle peut varier en fonction de la plateforme et du backend sélectionné.
Par exemple, si le plugin nmea est utilisé, l’identifiant de satellite pour le système GPS correspond au numéro PRN (bruit pseudo-aléatoire), tandis que l’identifiant de satellite pour le système GLONASS correspond au numéro de slot.
Voir également satelliteIdentifier().
void QGeoSatelliteInfo::setSatelliteSystem(QGeoSatelliteInfo::SatelliteSystem system)
Définit le système de navigation par satellite (GPS, GLONASS, etc.) sur « system ».
Voir également satelliteSystem().
void QGeoSatelliteInfo::setSignalStrength(int signalStrength)
Définit l'intensité du signal sur signalStrength, en décibels.
Voir aussi signalStrength().
int QGeoSatelliteInfo::signalStrength() const
Renvoie l'intensité du signal, ou -1 si la valeur n'a pas été définie.
Remarque : fonctiongetter pour la propriété signalStrength.
Voir aussi setSignalStrength().
[noexcept, since 6.2] void QGeoSatelliteInfo::swap(QGeoSatelliteInfo &other)
Échange ces informations satellite avec other. Cette opération est très rapide et ne rencontre jamais d'échec.
Cette fonction a été introduite dans Qt 6.2.
[noexcept, since 6.2] QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(QGeoSatelliteInfo &&other)
L'opérateur « move » attribue la valeur de other à cet objet
Notez qu'un objet « QGeoSatelliteInfo » déplacé ne peut être ni détruit ni affecté. L'effet de l'appel de fonctions autres que le destructeur ou l'un des opérateurs d'affectation est indéfini.
Cette fonction a été introduite dans Qt 6.2.
QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(const QGeoSatelliteInfo &other)
Attribue à cet objet les valeurs de other.
Éléments non membres associés
bool operator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
Renvoie ` true ` si l'un des paramètres du satellite ` lhs ` ne correspond pas à ceux de ` rhs`. Sinon, renvoie ` false`.
QDataStream &operator<<(QDataStream &stream, const QGeoSatelliteInfo &info)
Écrit l'info on fournie dans l'stream on spécifiée.
Voir également Sérialisation des types de données Qt.
bool operator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
Renvoie « true » si tous les paramètres du satellite « lhs » sont identiques à ceux de « rhs ». Sinon, renvoie « false ».
QDataStream &operator>>(QDataStream &stream, QGeoSatelliteInfo &info)
Lit les informations satellite provenant de l'stream spécifié et les transfère vers l'info indiqué.
Voir également Sérialisation des types de données Qt.
© 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.
