QGeoSatelliteInfo Class
La clase `QGeoSatelliteInfo` contiene información básica sobre un satélite. Más...
| Encabezado: | #include <QGeoSatelliteInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
- Lista de todos los miembros, incluidos los heredados
- QGeoSatelliteInfo forma parte de las clases compartidas implícitamente.
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) |
Personas no afiliadas relacionadas
| 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 sobre tipos de miembros
enum QGeoSatelliteInfo::Attribute
Define los atributos de la información sobre satélites.
| Constante | Valor | Descripción |
|---|---|---|
QGeoSatelliteInfo::Elevation | 0 | La elevación del satélite, en grados. |
QGeoSatelliteInfo::Azimuth | 1 | El azimut respecto 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 Global 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-cenital (Japón). |
QGeoSatelliteInfo::IRNSS (since Qt 6.12) | 0x06 | Sistema regional de navegación por satélite de la India. |
QGeoSatelliteInfo::SBAS (since Qt 6.12) | 0x07 | Sistema de aumento basado en satélites. |
QGeoSatelliteInfo::Multiple | 0xFF | Este tipo suele indicar que la información se recibe de un dispositivo compatible con varios sistemas de navegación por satélite y que el sistema de navegación no se especifica explícitamente. Dependiendo de la fuente de datos, es posible que se utilice 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 identificadores 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 puede utilizarse para fines de usuario. Por ejemplo, al reimplementar el análisis de datos NMEA en QNmeaSatelliteInfoSource. El usuario puede añadir más tipos utilizando CustomType + 1, CustomType + 2, etc. |
Documentación de las propiedades
[read-only] satelliteIdentifier : int
Esta propiedad contiene el número de identificación del satélite.
El número de identificación del satélite puede utilizarse para identificar un satélite dentro del sistema de satélites.
El valor real puede variar en función de la plataforma y del backend seleccionado.
Por ejemplo, si se utiliza el complemento NMEA, el identificador de satélite para el sistema GPS representa el número PRN (ruido pseudoaleatorio), y el identificador de satélite para el sistema GLONASS representa el número de ranura.
En el caso de los backends basados en NMEA, el identificador de satélite puede utilizarse para determinar el tipo de sistema de satélites si esta información no está disponible a través de otras fuentes. Puedes consultar la lista de identificadores de satélites para comprobar los rangos de identificadores de los distintos sistemas de satélites.
Nota: Dependiendo de la plataforma y del backend seleccionado, los rangos de identificadores de satélite de los distintos sistemas pueden solaparse. Para identificar de forma unívoca un satélite, debe utilizarse una combinación de `satelliteIdentifier()` y ` satelliteSystem()`.
Funciones de acceso:
| int | satelliteIdentifier() const |
[read-only] satelliteSystem : SatelliteSystem
Esta propiedad indica el sistema de satélites que se está utilizando, como GPS o GLONASS.
Devuelve el sistema de satélites (GPS, GLONASS, ...)
Nota: Este valor se puede utilizar junto con ` satelliteIdentifier ` para identificar de forma única un satélite.
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 las funciones de miembro
QGeoSatelliteInfo::QGeoSatelliteInfo()
Crea un objeto de información sobre satélites.
QGeoSatelliteInfo::QGeoSatelliteInfo(const QGeoSatelliteInfo &other)
Crea un objeto de información sobre un satélite con los valores de other.
[constexpr noexcept default, since 6.2] QGeoSatelliteInfo::QGeoSatelliteInfo(QGeoSatelliteInfo &&other)
Crea un objeto de información de satélite a partir de un objeto « other ».
Ten en cuenta que un QGeoSatelliteInfo del que se ha realizado una asignación solo 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()
Elimina un objeto de información de satélite.
[invokable] qreal QGeoSatelliteInfo::attribute(QGeoSatelliteInfo::Attribute attribute) const
Devuelve el valor del « attribute » especificado como un valor «qreal».
Devuelve -1 si el valor no se ha establecido.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véanse 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 se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
void QGeoSatelliteInfo::removeAttribute(QGeoSatelliteInfo::Attribute attribute)
Elimina la clave « attribute » especificada y su valor.
int QGeoSatelliteInfo::satelliteIdentifier() const
Devuelve el número de identificación del satélite.
Nota: Funcióngetter 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 de identificación del satélite en « satId ».
El número de identificación del satélite se puede utilizar para identificar un satélite dentro del sistema de satélites.
El valor real puede variar en función de la plataforma y del backend seleccionado.
Por ejemplo, si se utiliza el complemento NMEA, el identificador de satélite para el sistema GPS representa el número PRN (ruido pseudoaleatorio), y el identificador de satélite para el sistema GLONASS representa el número de ranura.
Véase también satelliteIdentifier().
void QGeoSatelliteInfo::setSatelliteSystem(QGeoSatelliteInfo::SatelliteSystem system)
Configura el sistema de satélites (GPS, GLONASS, etc.) 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 el valor no se ha establecido.
Nota: Funcióngetter para la propiedad signalStrength.
Véase también setSignalStrength().
[noexcept, since 6.2] void QGeoSatelliteInfo::swap(QGeoSatelliteInfo &other)
Intercambia esta información satelital 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)
Asigna por movimiento el valor de ` other ` a este objeto
Ten en cuenta que un ` QGeoSatelliteInfo ` del que se ha realizado una asignación por movimiento solo 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.
Elementos 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 objeto ` info ` proporcionado en el objeto ` stream` especificado.
Véase también «Serialización detipos de datos de Qt».
bool operator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
Devuelve « true » si todos los parámetros del satélite « lhs » son iguales a los de « rhs ». En caso contrario, devuelve « false ».
QDataStream &operator>>(QDataStream &stream, QGeoSatelliteInfo &info)
Lee la información del satélite del archivo « stream » especificado y la guarda en el archivo « info » indicado.
Véase también «Serialización detipos de datos de 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.