QNmeaPositionInfoSource Класс

Класс QNmeaPositionInfoSource предоставляет информацию о местоположении, используя источник данных NMEA. Подробнее...

Этот класс был представлен в Qt 5.2.

• Список всех членов, включая унаследованные

Общедоступные типы

Общедоступные функции

Переопределённые общедоступные функции

Общедоступные слоты

Защищённые функции

Подробное описание

NMEA — это широко используемый протокол для указания глобального местоположения в определенный момент времени. Класс QNmeaPositionInfoSource считывает данные NMEA и использует их для предоставления данных о местоположении в виде объектов QGeoPositionInfo.

Экземпляр QNmeaPositionInfoSource работает в режиме РежимРеальногоВремени или РежимМоделирования. Эти режимы позволяют считывать данные NMEA из активного источника данных о местоположении или воспроизводить их для целей моделирования из ранее записанных данных NMEA.

Источник данных NMEA устанавливается с помощью setDevice().

Используйте startUpdates(), чтобы начать получение регулярных обновлений местоположения, и stopUpdates(), чтобы остановить эти обновления. Если вам нужны обновления только время от времени, вы можете вызвать requestUpdate(), чтобы запросить одно обновление.

В обоих случаях информация о местоположении принимается через сигнал positionUpdated(), и к последнему известному местоположению можно получить доступ с помощью lastKnownPosition().

QNmeaPositionInfoSource поддерживает отчёт о точности горизонтального и вертикального местоположения. Чтобы включить отчёт о точности местоположения, необходимо установить оценку User Equivalent Range Error, связанную с источником NMEA, с помощью setUserEquivalentRangeError().

Документация по типу члена

перечисление QNmeaPositionInfoSource::UpdateMode

Определяет доступные режимы обновления.

Документация по документации функции члена

QNmeaPositionInfoSource::QNmeaPositionInfoSource(QNmeaPositionInfoSource::UpdateMode updateMode, QObject *parent = nullptr)

Создаёт экземпляр QNmeaPositionInfoSource с заданным parent и updateMode.

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

Реализует: QGeoPositionInfoSource::requestUpdate(int timeout).

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

Реализует: QGeoPositionInfoSource::startUpdates().

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

Реализует: QGeoPositionInfoSource::stopUpdates().

[virtual] QNmeaPositionInfoSource::~QNmeaPositionInfoSource()

Удаляет источник местоположения.

QIODevice *QNmeaPositionInfoSource::device() const

Возвращает источник данных NMEA.

См. также setDevice().

[override virtual] QGeoPositionInfoSource::Error QNmeaPositionInfoSource::error() const

Реализует: QGeoPositionInfoSource::error() const.

[override virtual] QGeoPositionInfo QNmeaPositionInfoSource::lastKnownPosition(bool fromSatellitePositioningMethodsOnly = false) const

Реализует: QGeoPositionInfoSource::lastKnownPosition(bool fromSatellitePositioningMethodsOnly) const.

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

Реализует: QGeoPositionInfoSource::minimumUpdateInterval() const.

[virtual protected] bool QNmeaPositionInfoSource::parsePosInfoFromNmeaData(const char *data, int size, QGeoPositionInfo *posInfo, bool *hasFix)

Парсит строку предложения NMEA в QGeoPositionInfo.

Реализация по умолчанию будет анализировать стандартные предложения NMEA. Этот метод следует переопределять в подклассе всякий раз, когда возникает необходимость работать с нестандартными предложениями NMEA.

Парсер считывает size байтов из data и использует эту информацию для настройки posInfo и hasFix. Если hasFix установлено в false, то posInfo может содержать только время или дату и время.

Возвращает true, если предложение было успешно проанализировано, в противном случае возвращает false и не должно изменять posInfo или hasFix.

void QNmeaPositionInfoSource::setDevice(QIODevice *device)

Устанавливает источник данных NMEA в device. Если устройство не открыто, оно будет открыто в режиме QIODevice::ReadOnly.

Источник устройства может быть установлен только один раз и должен быть установлен перед вызовом startUpdates() или requestUpdate().

Примечание: device должен генерировать событие QIODevice::readyRead() для уведомления источника о том, что данные доступны для чтения. QNmeaPositionInfoSource не принимает на себя владение устройством и, следовательно, не удаляет его при уничтожении.

См. также device().

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

Реализует: QGeoPositionInfoSource::setUpdateInterval(int msec).

void QNmeaPositionInfoSource::setUserEquivalentRangeError(double uere)

Устанавливает ошибку эквивалентной дальности пользователя (UERE) в uere. UERE используется для расчета оценки точности информации о местоположении, предоставленной источником информации о местоположении. UERE следует устанавливать в значение, соответствующее устройству GPS, которое сгенерировало поток NMEA.

Истинное значение UERE рассчитывается по нескольким источникам ошибок, включая ошибки, введенные спутниками и задержки распространения сигнала через атмосферу, а также ошибки, введенные принимающим оборудованием GPS. Подробную информацию о точности GPS см. на сайте http://edu-observatory.org/gps/gps_accuracy.html.

Типичное значение UERE составляет примерно 5,1.

Эта функция была добавлена в Qt 5.3.

См. также userEquivalentRangeError().

[override virtual] QGeoPositionInfoSource::PositioningMethods QNmeaPositionInfoSource::supportedPositioningMethods() const

Реализует: QGeoPositionInfoSource::supportedPositioningMethods() const.

QNmeaPositionInfoSource::UpdateMode QNmeaPositionInfoSource::updateMode() const

Возвращает режим обновления.

double QNmeaPositionInfoSource::userEquivalentRangeError() const

Возвращает текущую ошибку эквивалентной дальности пользователя (UERE). UERE используется для расчета оценки точности информации о местоположении, предоставленной источником информации о местоположении. Значение по умолчанию — NaN, что означает, что информация о точности не будет предоставлена.

Эта функция была добавлена в Qt 5.3.

См. также setUserEquivalentRangeError().