QNmeaPositionInfoSource Class
La clase QNmeaPositionInfoSource proporciona información de posición utilizando una fuente de datos NMEA. Más información...
| Encabezado: | #include <QNmeaPositionInfoSource> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Heredado de: | QGeoPositionInfoSource |
Tipos públicos
| enum | UpdateMode { RealTimeMode, SimulationMode } |
Funciones públicas
| QNmeaPositionInfoSource(QNmeaPositionInfoSource::UpdateMode updateMode, QObject *parent = nullptr) | |
| virtual | ~QNmeaPositionInfoSource() |
| QIODevice * | device() const |
| void | setDevice(QIODevice *device) |
| void | setUserEquivalentRangeError(double uere) |
| QNmeaPositionInfoSource::UpdateMode | updateMode() const |
| double | userEquivalentRangeError() const |
Funciones públicas reimplementadas
| virtual QGeoPositionInfoSource::Error | error() const override |
| virtual QGeoPositionInfo | lastKnownPosition(bool fromSatellitePositioningMethodsOnly = false) const override |
| virtual int | minimumUpdateInterval() const override |
| virtual void | setUpdateInterval(int msec) override |
| virtual QGeoPositionInfoSource::PositioningMethods | supportedPositioningMethods() const override |
Ranuras públicas
| virtual void | requestUpdate(int msec = 0) override |
| virtual void | startUpdates() override |
| virtual void | stopUpdates() override |
Funciones protegidas
| virtual bool | parsePosInfoFromNmeaData(const char *data, int size, QGeoPositionInfo *posInfo, bool *hasFix) |
Descripción detallada
NMEA es un protocolo de uso común para especificar la posición global en un momento determinado. La clase QNmeaPositionInfoSource lee datos NMEA y los utiliza para proporcionar datos de posición en forma de objetos « QGeoPositionInfo ».
Una instancia de QNmeaPositionInfoSource funciona en uno de los siguientes modos: « RealTimeMode » o « SimulationMode ». Estos modos permiten leer datos NMEA desde una fuente de datos de posición en tiempo real o reproducirlos con fines de simulación a partir de datos NMEA grabados previamente.
La fuente de datos NMEA se configura con setDevice().
Utiliza ` startUpdates()` para comenzar a recibir actualizaciones periódicas de posición y ` stopUpdates()` para detener dichas actualizaciones. Si solo necesitas actualizaciones de forma ocasional, puedes llamar a ` requestUpdate()` para solicitar una única actualización.
En ambos casos, la información de posición se recibe a través de la señal positionUpdated() y se puede acceder a la última posición conocida mediante lastKnownPosition().
QNmeaPositionInfoSource admite la notificación de la precisión de la posición horizontal y vertical. Para habilitar la notificación de la precisión de la posición, se debe establecer una estimación del error de alcance equivalente del usuario (User Equivalent Range Error) asociado a la fuente NMEA mediante setUserEquivalentRangeError().
Documentación sobre los tipos de miembro
enum QNmeaPositionInfoSource::UpdateMode
Define los modos de actualización disponibles.
| Constante | Valor | Descripción |
|---|---|---|
QNmeaPositionInfoSource::RealTimeMode | 1 | Los datos de posición se leen y distribuyen desde la fuente de datos a medida que están disponibles. Utiliza este modo si estás utilizando una fuente de datos de posición en tiempo real (por ejemplo, un dispositivo GPS). |
QNmeaPositionInfoSource::SimulationMode | 2 | La información de fecha y hora de los datos de origen NMEA se utiliza para proporcionar actualizaciones de posición a la frecuencia con la que se registraron originalmente los datos. Utiliza este modo si la fuente de datos contiene datos NMEA registrados previamente y deseas reproducirlos con fines de simulación. |
Documentación de funciones de miembro
[explicit] QNmeaPositionInfoSource::QNmeaPositionInfoSource(QNmeaPositionInfoSource::UpdateMode updateMode, QObject *parent = nullptr)
Crea una instancia de QNmeaPositionInfoSource con los valores proporcionados para « parent » y « updateMode ».
[virtual noexcept] QNmeaPositionInfoSource::~QNmeaPositionInfoSource()
Elimina la fuente de posición.
QIODevice *QNmeaPositionInfoSource::device() const
Devuelve la fuente de datos NMEA.
Véase también setDevice().
[override virtual] QGeoPositionInfoSource::Error QNmeaPositionInfoSource::error() const
Reimplementa: QGeoPositionInfoSource::error() const.
[override virtual] QGeoPositionInfo QNmeaPositionInfoSource::lastKnownPosition(bool fromSatellitePositioningMethodsOnly = false) const
Reimplementa: ` QGeoPositionInfoSource::lastKnownPosition` (`bool fromSatellitePositioningMethodsOnly`) const.
[override virtual] int QNmeaPositionInfoSource::minimumUpdateInterval() const
Reimplementa una función de acceso para la propiedad: QGeoPositionInfoSource::minimumUpdateInterval.
[virtual protected] bool QNmeaPositionInfoSource::parsePosInfoFromNmeaData(const char *data, int size, QGeoPositionInfo *posInfo, bool *hasFix)
Analiza una cadena de texto que contiene una frase NMEA y la convierte en un objeto ` QGeoPositionInfo`.
La implementación predeterminada analizará frases NMEA estándar. Este método debe reimplementarse en una subclase siempre que surja la necesidad de tratar frases NMEA no estándar.
El analizador lee los bytes de size desde data y utiliza esa información para configurar posInfo y hasFix. Si hasFix se establece en false, entonces posInfo solo puede contener la hora o la fecha y la hora.
Devuelve «true» si la frase se ha analizado correctamente; en caso contrario, devuelve «false» y no debe modificar posInfo ni hasFix.
[override virtual slot] void QNmeaPositionInfoSource::requestUpdate(int msec = 0)
Reimplementa: ` QGeoPositionInfoSource::requestUpdate` (int timeout).
void QNmeaPositionInfoSource::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 la fuente reciba una notificación cuando haya datos disponibles para su lectura. ` QNmeaPositionInfoSource ` no asume la propiedad del dispositivo y, por lo tanto, no lo desasigna al ser destruido.
Véase también device().
[override virtual] void QNmeaPositionInfoSource::setUpdateInterval(int msec)
Reimplementa una función de acceso para la propiedad: QGeoPositionInfoSource::updateInterval.
void QNmeaPositionInfoSource::setUserEquivalentRangeError(double uere)
Establece el error de alcance equivalente del usuario (UERE) en uere. El UERE se utiliza para calcular una estimación de la precisión de la información de posición facilitada por la fuente de información de posición. El UERE debe establecerse en un valor adecuado para el dispositivo GPS que generó el flujo NMEA.
El valor real del UERE se calcula a partir de múltiples fuentes de error, entre las que se incluyen los errores introducidos por los satélites y los retrasos en la propagación de la señal a través de la atmósfera, así como los errores introducidos por el equipo GPS receptor. Para obtener más detalles sobre la precisión del GPS, véase Sam J. Wormley, «GPS Errors & Estimating Your Receiver’s Accuracy».
Un valor típico para el UERE es aproximadamente 5,1.
Véase también « userEquivalentRangeError » ().
[override virtual slot] void QNmeaPositionInfoSource::startUpdates()
Reimplementa: QGeoPositionInfoSource::startUpdates().
[override virtual slot] void QNmeaPositionInfoSource::stopUpdates()
Reimplementa: ` QGeoPositionInfoSource::stopUpdates()`.
[override virtual] QGeoPositionInfoSource::PositioningMethods QNmeaPositionInfoSource::supportedPositioningMethods() const
Reimplementa: QGeoPositionInfoSource::supportedPositioningMethods() const.
QNmeaPositionInfoSource::UpdateMode QNmeaPositionInfoSource::updateMode() const
Devuelve el modo de actualización.
double QNmeaPositionInfoSource::userEquivalentRangeError() const
Devuelve el error de rango equivalente del usuario (UERE) actual. El UERE se utiliza para calcular una estimación de la precisión de la información de posición facilitada por la fuente de información de posición. El valor por defecto es NaN, lo que significa que no se proporcionará información sobre la precisión.
Véase también setUserEquivalentRangeError().
© 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.