En esta página

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

Tipos públicos

enum Attribute { Elevation, Azimuth }
enum SatelliteSystem { Undefined, GPS, GLONASS, GALILEO, BEIDOU, …, CustomType }

Propiedades

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)
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)

Descripción detallada

Véase también QGeoSatelliteInfoSource.

Documentación sobre tipos de miembros

enum QGeoSatelliteInfo::Attribute

Define los atributos de la información sobre satélites.

ConstanteValorDescripción
QGeoSatelliteInfo::Elevation0La elevación del satélite, en grados.
QGeoSatelliteInfo::Azimuth1El azimut respecto al norte verdadero, en grados.

enum QGeoSatelliteInfo::SatelliteSystem

Define el sistema GNSS del satélite.

ConstanteValorDescripción
QGeoSatelliteInfo::Undefined0x00No definido.
QGeoSatelliteInfo::GPS0x01Sistema de Posicionamiento Global (EE. UU.).
QGeoSatelliteInfo::GLONASS0x02Sistema de Posicionamiento Global (Rusia).
QGeoSatelliteInfo::GALILEO0x03Sistema Global de Navegación por Satélite (UE).
QGeoSatelliteInfo::BEIDOU0x04Sistema de navegación por satélite BeiDou (China).
QGeoSatelliteInfo::QZSS0x05Sistema de satélites cuasi-cenital (Japón).
QGeoSatelliteInfo::IRNSS (since Qt 6.12)0x06Sistema regional de navegación por satélite de la India.
QGeoSatelliteInfo::SBAS (since Qt 6.12)0x07Sistema de aumento basado en satélites.
QGeoSatelliteInfo::Multiple0xFFEste 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::CustomType0x100El 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.