QGeoSatelliteInfo Class
La classe QGeoSatelliteInfo contient des informations de base sur un satellite. Plus d'informations...
| 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) |
Non-membres apparentés
| 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 de l'information satellite.
| Constante | Valeur | Description |
|---|---|---|
QGeoSatelliteInfo::Elevation | 0 | L'élévation du satellite, en degrés. |
QGeoSatelliteInfo::Azimuth | 1 | L'azimut par rapport au nord vrai, 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 satellitaire quasi-zénithal (Japon). |
QGeoSatelliteInfo::Multiple | 0xFF | Ce type indique normalement que les informations sont reçues d'un appareil qui prend en charge plusieurs systèmes de satellites, et que le système de satellites n'est pas explicitement spécifié. En fonction de la source de 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 ID des satellites utilisés, mais ne mentionne pas explicitement leurs types de systèmes. |
QGeoSatelliteInfo::CustomType | 0x100 | Le premier type qui peut être utilisé par l'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 en utilisant CustomType + 1, CustomType + 2 et ainsi de suite. |
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 peut être utilisé pour 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 du satellite GPS représente le numéro PRN (Pseudo-random noise), et l'identifiant du satellite GLONASS représente le numéro de slot.
Pour les backends basés sur la NMEA, l'identifiant du satellite peut être utilisé pour déterminer le type de système satellite s'il n'est pas disponible à partir d'autres sources. Vous pouvez consulter la liste des identifiants de satellite pour vérifier les plages d'identifiants des différents systèmes de satellites.
Note : En fonction de la plateforme et du backend sélectionné, les plages d'identifiants de satellites pour différents systèmes de satellites peuvent se croiser. Pour identifier un satellite de manière unique, il faut utiliser une combinaison de satelliteIndetifier() et satelliteSystem().
Fonctions d'accès :
| int | satelliteIdentifier() const |
[read-only] satelliteSystem : SatelliteSystem
Cette propriété indique le système de satellites utilisé, tel que GPS ou GLONASS.
Renvoie le système de satellites (GPS, GLONASS, ...)
Note : Cette valeur peut être utilisée avec satelliteIdentifier pour identifier un satellite de manière unique.
Fonctions d'accès :
| QGeoSatelliteInfo::SatelliteSystem | satelliteSystem() const |
Voir également satelliteIdentifier.
[read-only] signalStrength : qreal
Cette propriété indique l'intensité 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, since 6.2] QGeoSatelliteInfo::QGeoSatelliteInfo(QGeoSatelliteInfo &&other)
Crée un objet d'information satellite en le déplaçant depuis other.
Notez qu'un QGeoSatelliteInfo déplacé à partir d'un autre objet ne peut être que détruit ou assigné. L'effet de l'appel à d'autres fonctions que le destructeur ou l'un des opérateurs d'affectation n'est pas dé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'adresse attribute spécifiée sous la forme d'une valeur qreal.
Retourne -1 si la valeur n'a pas été définie.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également hasAttribute() et setAttribute().
[invokable] bool QGeoSatelliteInfo::hasAttribute(QGeoSatelliteInfo::Attribute attribute) const
Renvoie un résultat positif si l'adresse attribute spécifiée est présente dans cette mise à jour.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
void QGeoSatelliteInfo::removeAttribute(QGeoSatelliteInfo::Attribute attribute)
Supprime l'adresse attribute spécifiée et sa valeur.
int QGeoSatelliteInfo::satelliteIdentifier() const
Renvoie le numéro d'identification du satellite.
Note : Fonction d'obtention pour la propriété satelliteIdentifier.
Voir aussi setSatelliteIdentifier() et satelliteSystem().
void QGeoSatelliteInfo::setAttribute(QGeoSatelliteInfo::Attribute attribute, qreal value)
Définit la valeur de attribute à value.
Voir aussi attribute().
void QGeoSatelliteInfo::setSatelliteIdentifier(int satId)
Définit le numéro d'identification du satellite à satId.
Le numéro d'identification du satellite peut être utilisé pour 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 du satellite GPS représente le numéro PRN (Pseudo-random noise), et l'identifiant du satellite GLONASS représente le numéro de slot.
Voir aussi satelliteIdentifier().
void QGeoSatelliteInfo::setSatelliteSystem(QGeoSatelliteInfo::SatelliteSystem system)
Règle le système de satellites (GPS, GLONASS, ...) sur system.
Voir aussi satelliteSystem().
void QGeoSatelliteInfo::setSignalStrength(int signalStrength)
Définit l'intensité du signal à signalStrength, en décibels.
Voir également signalStrength().
int QGeoSatelliteInfo::signalStrength() const
Renvoie l'intensité du signal, ou -1 si la valeur n'a pas été définie.
Remarque : fonction Getter pour la propriété signalStrength.
Voir également setSignalStrength().
[noexcept, since 6.2] void QGeoSatelliteInfo::swap(QGeoSatelliteInfo &other)
Échange cette information satellite avec other. Cette opération est très rapide et n'échoue jamais.
Cette fonction a été introduite dans Qt 6.2.
[noexcept, since 6.2] QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(QGeoSatelliteInfo &&other)
Déplacer - assigne la valeur de other à cet objet
Notez qu'un objet déplacé de QGeoSatelliteInfo ne peut être détruit ou assigné qu'à cet objet. L'effet de l'appel à d'autres fonctions que le destructeur ou l'un des opérateurs d'affectation n'est pas défini.
Cette fonction a été introduite dans Qt 6.2.
QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(const QGeoSatelliteInfo &other)
Attribue les valeurs de other à cet objet.
Non-membres apparentés
bool operator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
Renvoie true si l'un des paramètres du satellite lhs n'est pas le même que celui de rhs. Sinon, renvoie false.
QDataStream &operator<<(QDataStream &stream, const QGeoSatelliteInfo &info)
Écrit l'adresse info donnée dans l'adresse stream spécifiée.
Voir aussi Serializing Qt Data Types (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 les mêmes que ceux de rhs. Sinon, renvoie false.
QDataStream &operator>>(QDataStream &stream, QGeoSatelliteInfo &info)
Lit les informations sur les satellites à partir du site stream spécifié dans le site info donné.
Voir aussi Serializing Qt Data Types (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.
