QGeoSatelliteInfo Class
La clase QGeoSatelliteInfo contiene información básica sobre un satélite. Más...
| Cabecera: | #include <QGeoSatelliteInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
- Lista de todos los miembros, incluyendo los heredados
- QGeoSatelliteInfo es parte de Clases Implícitamente Compartidas.
Tipos Públicos
| enum | Attribute { Elevation, Azimuth } |
| enum | SatelliteSystem { Undefined, GPS, GLONASS, GALILEO, BEIDOU, …, CustomType } |
Propiedades
- satelliteIdentifier : int
- satelliteSystem : SatelliteSystem
- signalStrength : qreal
Funciones públicas
| 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) |
Relacionados No Miembros
| 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) |
Véase también QGeoSatelliteInfoSource.
Documentación de tipos de miembros
enum QGeoSatelliteInfo::Attribute
Define los atributos de la información del satélite.
| Constante | Valor | Descripción |
|---|---|---|
QGeoSatelliteInfo::Elevation | 0 | La elevación del satélite, en grados. |
QGeoSatelliteInfo::Azimuth | 1 | El acimut al norte verdadero, en grados. |
enum QGeoSatelliteInfo::SatelliteSystem
Define el sistema GNSS del satélite.
| Constante | Valor | Descripción |
|---|---|---|
QGeoSatelliteInfo::Undefined | 0x00 | No definido. |
QGeoSatelliteInfo::GPS | 0x01 | Sistema de Posicionamiento Global (EE.UU.). |
QGeoSatelliteInfo::GLONASS | 0x02 | Sistema de posicionamiento global (Rusia). |
QGeoSatelliteInfo::GALILEO | 0x03 | Sistema mundial de navegación por satélite (UE). |
QGeoSatelliteInfo::BEIDOU | 0x04 | Sistema de navegación por satélite BeiDou (China). |
QGeoSatelliteInfo::QZSS | 0x05 | Sistema de satélites cuasi cenitales (Japón). |
QGeoSatelliteInfo::Multiple | 0xFF | Este tipo indica normalmente que la información se recibe de un dispositivo que admite varios sistemas de satélites, y el sistema de satélites no se especifica explícitamente. Dependiendo de la fuente de datos, puede utilizar otra información para determinar el tipo de sistema real. Un ejemplo del uso de este tipo es un mensaje NMEA $GNGSA, que contiene los ID de los satélites que se están utilizando, pero no menciona explícitamente sus tipos de sistema. |
QGeoSatelliteInfo::CustomType | 0x100 | El primer tipo que se puede utilizar para fines de usuario. Por ejemplo al reimplementar el análisis sintáctico de datos NMEA en QNmeaSatelliteInfoSource. El usuario puede añadir más tipos utilizando CustomType + 1, CustomType + 2 y así sucesivamente. |
Documentación de propiedades
[read-only] satelliteIdentifier : int
Esta propiedad contiene el número identificador del satélite.
El número identificador de satélite puede utilizarse para identificar un satélite dentro del sistema de satélites.
El valor real puede variar, dependiendo de la plataforma y del backend seleccionado.
Por ejemplo, si se utiliza el plugin nmea, el identificador de satélite para el sistema de satélites GPS representa el número PRN (ruido pseudoaleatorio), y el identificador de satélite para el sistema de satélites GLONASS representa el número de ranura.
Para los backends basados en NMEA, el identificador de satélite se puede utilizar para determinar el tipo de sistema de satélite si no está disponible a partir de otras fuentes. Puede consultar la lista de identificadores de satélite para comprobar los rangos de identificación de los distintos sistemas de satélite.
Nota: Dependiendo de la plataforma y del backend seleccionado, los rangos de identificadores de satélite para diferentes sistemas de satélite pueden cruzarse. Para identificar un satélite de forma única, debe utilizarse una combinación de satelliteIndetifier() y satelliteSystem().
Funciones de acceso:
| int | satelliteIdentifier() const |
[read-only] satelliteSystem : SatelliteSystem
Esta propiedad contiene el sistema de satélites en uso, como GPS o GLONASS.
Devuelve el sistema de satélites (GPS, GLONASS, ...)
Nota: Este valor puede utilizarse junto con satelliteIdentifier para identificar un satélite de forma única.
Funciones de acceso:
| QGeoSatelliteInfo::SatelliteSystem | satelliteSystem() const |
Véase también satelliteIdentifier.
[read-only] signalStrength : qreal
Esta propiedad contiene la intensidad de la señal.
Funciones de acceso:
| int | signalStrength() const |
Documentación de funciones miembro
QGeoSatelliteInfo::QGeoSatelliteInfo()
Crea un objeto de información de satélite.
QGeoSatelliteInfo::QGeoSatelliteInfo(const QGeoSatelliteInfo &other)
Crea un objeto de información de satélite con los valores de other.
[constexpr noexcept, since 6.2] QGeoSatelliteInfo::QGeoSatelliteInfo(QGeoSatelliteInfo &&other)
Crea un objeto de información de satélite movido desde other.
Ten en cuenta que un QGeoSatelliteInfo movido desde sólo puede ser destruido o asignado. El efecto de llamar a otras funciones que no sean el destructor o uno de los operadores de asignación es indefinido.
Esta función se introdujo en Qt 6.2.
[noexcept] QGeoSatelliteInfo::~QGeoSatelliteInfo()
Destruye un objeto de información del satélite.
[invokable] qreal QGeoSatelliteInfo::attribute(QGeoSatelliteInfo::Attribute attribute) const
Devuelve el valor del attribute especificado como un valor qreal.
Devuelve -1 si no se ha establecido el valor.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también hasAttribute() y setAttribute().
[invokable] bool QGeoSatelliteInfo::hasAttribute(QGeoSatelliteInfo::Attribute attribute) const
Devuelve true si el attribute especificado está presente en esta actualización.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
void QGeoSatelliteInfo::removeAttribute(QGeoSatelliteInfo::Attribute attribute)
Elimina la dirección attribute especificada y su valor.
int QGeoSatelliteInfo::satelliteIdentifier() const
Devuelve el número de identificador del satélite.
Nota: Función Getter para la propiedad satelliteIdentifier.
Véase también setSatelliteIdentifier() y satelliteSystem().
void QGeoSatelliteInfo::setAttribute(QGeoSatelliteInfo::Attribute attribute, qreal value)
Establece el valor de attribute en value.
Véase también attribute().
void QGeoSatelliteInfo::setSatelliteIdentifier(int satId)
Establece el número identificador del satélite en satId.
El número identificador de satélite puede utilizarse para identificar un satélite dentro del sistema de satélites.
El valor real puede variar, dependiendo de la plataforma y del backend seleccionado.
Por ejemplo, si se utiliza el plugin nmea, el identificador de satélite para el sistema de satélites GPS representa el número PRN (ruido pseudoaleatorio), y el identificador de satélite para el sistema de satélites GLONASS representa el número de ranura.
Véase también satelliteIdentifier().
void QGeoSatelliteInfo::setSatelliteSystem(QGeoSatelliteInfo::SatelliteSystem system)
Establece el Sistema de Satélites (GPS, GLONASS, ...) en system.
Véase también satelliteSystem().
void QGeoSatelliteInfo::setSignalStrength(int signalStrength)
Establece la intensidad de la señal en signalStrength, en decibelios.
Véase también signalStrength().
int QGeoSatelliteInfo::signalStrength() const
Devuelve la intensidad de la señal, o -1 si no se ha establecido el valor.
Nota: Función Getter para la propiedad signalStrength.
Véase también setSignalStrength().
[noexcept, since 6.2] void QGeoSatelliteInfo::swap(QGeoSatelliteInfo &other)
Intercambia esta información de satélite con other. Esta operación es muy rápida y nunca falla.
Esta función se introdujo en Qt 6.2.
[noexcept, since 6.2] QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(QGeoSatelliteInfo &&other)
Mover-asigna el valor de other a este objeto.
Tenga en cuenta que un objeto movido desde QGeoSatelliteInfo sólo puede ser destruido o asignado. El efecto de llamar a otras funciones que no sean el destructor o uno de los operadores de asignación es indefinido.
Esta función se introdujo en Qt 6.2.
QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(const QGeoSatelliteInfo &other)
Asigna los valores de other a este objeto.
No miembros relacionados
bool operator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
Devuelve true si alguno de los parámetros del satélite lhs no coincide con los de rhs. En caso contrario devuelve false.
QDataStream &operator<<(QDataStream &stream, const QGeoSatelliteInfo &info)
Escribe el info dado en el stream especificado.
Véase también Serializar tipos de datos Qt.
bool operator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
Devuelve true si todos los parámetros del satélite lhs son los mismos que los de rhs. En caso contrario devuelve false.
QDataStream &operator>>(QDataStream &stream, QGeoSatelliteInfo &info)
Lee la información del satélite del stream especificado en el info dado.
Ver también Serializing Qt Data Types.
© 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.
