En esta página

QNmeaSatelliteInfoSource Class

La clase « QNmeaSatelliteInfoSource » proporciona información sobre satélites utilizando una fuente de datos NMEA. Más información...

Encabezado: #include <QNmeaSatelliteInfoSource>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning
Desde: Qt 6.2
Heredado de: QGeoSatelliteInfoSource

Tipos públicos

enum class UpdateMode { RealTimeMode, SimulationMode }

Funciones públicas

QNmeaSatelliteInfoSource(QNmeaSatelliteInfoSource::UpdateMode mode, QObject *parent = nullptr)
virtual ~QNmeaSatelliteInfoSource() override
QIODevice *device() const
void setDevice(QIODevice *device)
QNmeaSatelliteInfoSource::UpdateMode updateMode() const

Funciones públicas reimplementadas

virtual QVariant backendProperty(const QString &name) const override
virtual QGeoSatelliteInfoSource::Error error() const override
virtual int minimumUpdateInterval() const override
virtual bool setBackendProperty(const QString &name, const QVariant &value) override
virtual void setUpdateInterval(int msec) override

Ranuras públicas

virtual void requestUpdate(int msec = 0) override
virtual void startUpdates() override
virtual void stopUpdates() override

Miembros públicos estáticos

Tipos protegidos

enum SatelliteInfoParseStatus { NotParsed, PartiallyParsed, FullyParsed }

Funciones protegidas

QNmeaSatelliteInfoSource(const QNmeaSatelliteInfoSource &)
virtual QNmeaSatelliteInfoSource::SatelliteInfoParseStatus parseSatelliteInfoFromNmea(const char *data, int size, QList<QGeoSatelliteInfo> &infos, QGeoSatelliteInfo::SatelliteSystem &system)
virtual QGeoSatelliteInfo::SatelliteSystem parseSatellitesInUseFromNmea(const char *data, int size, QList<int> &pnrsInUse)
QNmeaSatelliteInfoSource &operator=(const QNmeaSatelliteInfoSource &)

Descripción detallada

NMEA es un protocolo de uso común para especificar la posición global de un usuario en un momento determinado. La clase QNmeaSatelliteInfoSource lee datos NMEA y los utiliza para proporcionar información sobre los satélites visibles y los satélites en uso en forma de listas de objetos QGeoSatelliteInfo.

Una instancia de ` QNmeaSatelliteInfoSource ` funciona en los modos ` RealTimeMode ` o ` SimulationMode`. Estos modos permiten leer datos NMEA desde una fuente de datos en tiempo real o reproducirlos con fines de simulación a partir de datos NMEA grabados previamente.

La fuente de datos NMEA se configura mediante setDevice().

Utilice startUpdates() para comenzar a recibir actualizaciones periódicas de información sobre los satélites y stopUpdates() para detener dichas actualizaciones. Si solo necesita actualizaciones de forma ocasional, puede llamar a requestUpdate() para solicitar una única actualización tanto de los satélites visibles como de los satélites en uso.

La información sobre los satélites visibles se recibe a través de la señal satellitesInViewUpdated().

La información sobre los satélites en uso se recibe a través de la señal « satellitesInUseUpdated » ().

Documentación sobre tipos de miembros

enum QNmeaSatelliteInfoSource::SatelliteInfoParseStatus

Define el estado de análisis sintáctico de la información del satélite. La información del satélite puede dividirse en varias frases, y debemos analizar sintácticamente todas ellas.

ConstanteValorDescripción
QNmeaSatelliteInfoSource::NotParsed0Los datos no contienen información sobre satélites.
QNmeaSatelliteInfoSource::PartiallyParsed1Se ha recibido y analizado información válida sobre satélites, pero no está completa, por lo que hay que esperar a otra frase NMEA.
QNmeaSatelliteInfoSource::FullyParsed2Se ha recopilado y analizado íntegramente la información sobre los satélites.

enum class QNmeaSatelliteInfoSource::UpdateMode

Define los modos de actualización disponibles.

ConstanteValorDescripción
QNmeaSatelliteInfoSource::UpdateMode::RealTimeMode1La información del satélite se lee y se distribuye desde la fuente de datos a medida que está disponible. Utiliza este modo si estás utilizando una fuente de datos NMEA en tiempo real (por ejemplo, un dispositivo GPS).
QNmeaSatelliteInfoSource::UpdateMode::SimulationMode2La información de los satélites se lee y se distribuye desde la fuente de datos a la frecuencia especificada. La frecuencia viene determinada por el parámetro « SimulationUpdateInterval ». Utiliza este modo si la fuente de datos contiene datos NMEA grabados previamente y deseas reproducirlos con fines de simulación.

Documentación de las funciones de miembro

[explicit] QNmeaSatelliteInfoSource::QNmeaSatelliteInfoSource(QNmeaSatelliteInfoSource::UpdateMode mode, QObject *parent = nullptr)

Crea una instancia de ` QNmeaSatelliteInfoSource ` con los valores ` parent ` y ` mode` proporcionados.

[protected delete] QNmeaSatelliteInfoSource::QNmeaSatelliteInfoSource(const QNmeaSatelliteInfoSource &)

Crea una instancia de ` QNmeaSatelliteInfoSource` mediante copia. Esta función se ha eliminado.

[override virtual noexcept] QNmeaSatelliteInfoSource::~QNmeaSatelliteInfoSource()

Destruye la fuente de información del satélite.

[override virtual] QVariant QNmeaSatelliteInfoSource::backendProperty(const QString &name) const

Reimplementa: ` QGeoSatelliteInfoSource::backendProperty(const QString &name) const`.

Véase también setBackendProperty().

QIODevice *QNmeaSatelliteInfoSource::device() const

Devuelve la fuente de datos NMEA.

Véase también setDevice().

[override virtual] QGeoSatelliteInfoSource::Error QNmeaSatelliteInfoSource::error() const

Reimplementa: ` QGeoSatelliteInfoSource::error()` const.

[override virtual] int QNmeaSatelliteInfoSource::minimumUpdateInterval() const

Reimplementa una función de acceso para la propiedad: QGeoSatelliteInfoSource::minimumUpdateInterval.

[virtual protected] QNmeaSatelliteInfoSource::SatelliteInfoParseStatus QNmeaSatelliteInfoSource::parseSatelliteInfoFromNmea(const char *data, int size, QList<QGeoSatelliteInfo> &infos, QGeoSatelliteInfo::SatelliteSystem &system)

Analiza una cadena de texto con una frase NMEA para extraer la información sobre los satélites visibles.

La implementación predeterminada analizará sentencias NMEA $GPGSV estándar. Este método debe reimplementarse en una subclase siempre que surja la necesidad de gestionar sentencias NMEA no estándar.

El analizador lee size bytes de data y utiliza esa información para rellenar una list infos.

Devuelve un objeto ` SatelliteInfoParseStatus ` con el resultado del análisis. Modifica la lista ` infos ` en caso de que se devuelva ` PartiallyParsed ` o ` FullyParsed `. También establece el campo ` system ` al tipo de sistema de satélites correcto. Esto es necesario para determinar el tipo de sistema en caso de que no haya satélites a la vista.

[virtual protected] QGeoSatelliteInfo::SatelliteSystem QNmeaSatelliteInfoSource::parseSatellitesInUseFromNmea(const char *data, int size, QList<int> &pnrsInUse)

Analiza una cadena de texto con una frase NMEA para extraer los identificadores de los satélites en uso.

La implementación predeterminada analizará frases NMEA $GPGSA estándar. Este método debe reimplementarse en una subclase siempre que surja la necesidad de gestionar frases NMEA no estándar.

El analizador lee size bytes de data y utiliza esa información para rellenar una list pnrsInUse.

Devuelve el tipo del sistema si la frase se ha analizado correctamente; en caso contrario, devuelve QGeoSatelliteInfo::Undefined y no debe modificar pnrsInUse.

[override virtual slot] void QNmeaSatelliteInfoSource::requestUpdate(int msec = 0)

Reimplementa: ` QGeoSatelliteInfoSource::requestUpdate` (int timeout).

[override virtual] bool QNmeaSatelliteInfoSource::setBackendProperty(const QString &name, const QVariant &value)

Reimplementa: QGeoSatelliteInfoSource::setBackendProperty(const QString &name, const QVariant &value).

Véase también backendProperty().

void QNmeaSatelliteInfoSource::setDevice(QIODevice *device)

Establece la fuente de datos NMEA en device. Si el dispositivo no está abierto, se abrirá en modo ReadOnly.

El dispositivo de origen solo se puede configurar una vez y debe hacerse antes de llamar a startUpdates() o requestUpdate().

Nota: El ` device ` debe emitir ` QIODevice::readyRead()` para que se notifique a la fuente cuando haya datos disponibles para su lectura. ` QNmeaSatelliteInfoSource ` no asume la propiedad del dispositivo y, por lo tanto, no lo desasigna al ser destruido.

Véase también device().

[override virtual] void QNmeaSatelliteInfoSource::setUpdateInterval(int msec)

Reimplementa una función de acceso para la propiedad: QGeoSatelliteInfoSource::updateInterval.

[override virtual slot] void QNmeaSatelliteInfoSource::startUpdates()

Reimplementa: QGeoSatelliteInfoSource::startUpdates().

[override virtual slot] void QNmeaSatelliteInfoSource::stopUpdates()

Reimplementa: QGeoSatelliteInfoSource::stopUpdates().

QNmeaSatelliteInfoSource::UpdateMode QNmeaSatelliteInfoSource::updateMode() const

Devuelve el modo de actualización.

[protected delete] QNmeaSatelliteInfoSource &QNmeaSatelliteInfoSource::operator=(const QNmeaSatelliteInfoSource &)

Asigna por copia ` other ` a esta instancia de ` QNmeaSatelliteInfoSource `. Esta función se ha eliminado.

Documentación de variables de miembro

QString QNmeaSatelliteInfoSource::SimulationUpdateInterval

Esta variable contiene el nombre de la propiedad del backend correspondiente a la velocidad de lectura de datos en SimulationMode. El valor de esta propiedad es un número entero que representa la cantidad de milisegundos que transcurren entre lecturas consecutivas. Utiliza este parámetro en los métodos setBackendProperty() y backendProperty().

Nota: Esta propiedad es diferente del intervalo que se puede establecer mediante ` setUpdateInterval()` (). El valor establecido mediante ` setUpdateInterval()` indica un intervalo para la notificación al usuario, mientras que este parámetro especifica la frecuencia interna de lectura de los datos del archivo de origen. Esto significa que pueden producirse varias lecturas (o ninguna) durante el periodo de ` updateInterval()`.

© 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.