Класс QGeoPositionInfo
Класс QGeoPositionInfo содержит информацию о глобальном положении, направлении и скорости в определенный момент времени. Подробнее...
| Заголовок: | #include <QGeoPositionInfo> |
| CMake: | find_package(Qt6 COMPONENTS Positioning REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| С момента: | Qt 5.2 |
Типы публичного доступа
| Перечисление | Attribute { Direction, GroundSpeed, VerticalSpeed, MagneticVariation, HorizontalAccuracy, VerticalAccuracy } |
Функции публичного доступа
| QGeoPositionInfo(QGeoPositionInfo &&other) | |
| QGeoPositionInfo(const QGeoPositionInfo &other) | |
| QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp) | |
| QGeoPositionInfo() | |
| QGeoPositionInfo & | operator=(QGeoPositionInfo &&other) |
| QGeoPositionInfo & | operator=(const QGeoPositionInfo &other) |
| ~QGeoPositionInfo() | |
| qreal | attribute(QGeoPositionInfo::Attribute attribute) const |
| QGeoCoordinate | coordinate() const |
| bool | hasAttribute(QGeoPositionInfo::Attribute attribute) const |
| bool | isValid() const |
| void | removeAttribute(QGeoPositionInfo::Attribute attribute) |
| void | setAttribute(QGeoPositionInfo::Attribute attribute, qreal value) |
| void | setCoordinate(const QGeoCoordinate &coordinate) |
| void | setTimestamp(const QDateTime ×tamp) |
| QDateTime | timestamp() const |
Связанные нечлены
| bool | operator!=(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs) |
| QDataStream & | operator<<(QDataStream &stream, const QGeoPositionInfo &info) |
| QDataStream & | operator<<(QDataStream &stream, QGeoPositionInfo::Attribute attr) |
| bool | operator==(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QGeoPositionInfo &info) |
| QDataStream & | operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr) |
Подробное описание
QGeoPositionInfo содержит, как минимум, географические координаты и метку времени. Он также может содержать данные о курсе и скорости, а также оценки точности предоставленных данных.
См. также QGeoPositionInfoSource.
Документация по типам членов
Перечисление QGeoPositionInfo::Attribute
Определяет атрибуты для информации о местоположении.
| Постоянная | Значение | Описание |
|---|---|---|
QGeoPositionInfo::Direction |
0 |
Угол в градусах по часовой стрелке от истинного севера до направления движения. |
QGeoPositionInfo::GroundSpeed |
1 |
Скорость по местности в метрах/сек. |
QGeoPositionInfo::VerticalSpeed |
2 |
Вертикальная скорость в метрах/сек. |
QGeoPositionInfo::MagneticVariation |
3 |
Угол между горизонтальной составляющей магнитного поля и истинным севером в градусах. Также известна как магнитная деклинация. Положительное значение указывает направление по часовой стрелке от истинного севера, а отрицательное - против часовой стрелки. |
QGeoPositionInfo::HorizontalAccuracy |
4 |
Точность предоставленного значения широты-долготы в метрах. |
QGeoPositionInfo::VerticalAccuracy |
5 |
Точность предоставленного значения высоты в метрах. |
Протокол NMEA также предполагает другой тип точности - PositionAccuracy, который является 3D-значением точности. Qt не предоставляет отдельный атрибут для него. Если вам нужно это значение, вы можете рассчитать его по следующей формуле:
PositionAccuracy 2 = HorizontalAccuracy 2 + VerticalAccuracy 2
Документация по функциям членов
[since 6.2] QGeoPositionInfo::QGeoPositionInfo(QGeoPositionInfo &&other)
Создает объект QGeoPositionInfo, перемещая данные из other.
Обратите внимание, что перемещенный объект QGeoPositionInfo может быть только уничтожен или присвоен. Эффект вызова других функций, кроме деструктора или одного из операторов присваивания, не определен.
Эта функция была добавлена в Qt 6.2.
QGeoPositionInfo::QGeoPositionInfo(const QGeoPositionInfo &other)
Создает QGeoPositionInfo со значениями other.
QGeoPositionInfo::QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp)
Создает QGeoPositionInfo для заданных coordinate и timestamp.
QGeoPositionInfo::QGeoPositionInfo()
Создает недействительный объект QGeoPositionInfo.
См. также isValid().
[since 6.2] QGeoPositionInfo &QGeoPositionInfo::operator=(QGeoPositionInfo &&other)
Перемещает значения из other в текущий объект.
Обратите внимание, что перемещенный объект QGeoPositionInfo может быть только уничтожен или присвоен. Эффект вызова других функций, кроме деструктора или одного из операторов присваивания, не определен.
Эта функция была добавлена в Qt 6.2.
QGeoPositionInfo &QGeoPositionInfo::operator=(const QGeoPositionInfo &other)
Присваивает значения из other в текущий объект QGeoPositionInfo.
QGeoPositionInfo::~QGeoPositionInfo()
Уничтожает объект QGeoPositionInfo.
END_OF_DOCUMENT_MARKERqreal QGeoPositionInfo::attribute(QGeoPositionInfo::Attribute attribute) const
Возвращает значение указанного атрибута attribute в виде значения типа qreal.
Возвращает NaN, если значение не задано.
Функция hasAttribute() должна использоваться для определения, задано ли значение для атрибута.
См. также hasAttribute() и setAttribute().
QGeoCoordinate QGeoPositionInfo::coordinate() const
Возвращает координаты для данной позиции.
Возвращает недействительные координаты, если координаты не заданы.
См. также setCoordinate().
bool QGeoPositionInfo::hasAttribute(QGeoPositionInfo::Attribute attribute) const
Возвращает true, если указанный атрибут attribute присутствует для данного объекта QGeoPositionInfo.
bool QGeoPositionInfo::isValid() const
Возвращает true, если значения timestamp() и coordinate() оба действительны.
См. также QGeoCoordinate::isValid() и QDateTime::isValid().
void QGeoPositionInfo::removeAttribute(QGeoPositionInfo::Attribute attribute)
Удаляет указанный атрибут attribute и его значение.
void QGeoPositionInfo::setAttribute(QGeoPositionInfo::Attribute attribute, qreal value)
Устанавливает значение для атрибута attribute в value.
См. также attribute().
void QGeoPositionInfo::setCoordinate(const QGeoCoordinate &coordinate)
Устанавливает координаты для данной позиции в coordinate.
См. также coordinate().
void QGeoPositionInfo::setTimestamp(const QDateTime ×tamp)
Устанавливает дату и время, в которые была получена эта позиция, в timestamp.
timestamp должно быть в формате UTC.
См. также timestamp().
QDateTime QGeoPositionInfo::timestamp() const
Возвращает дату и время, в которые была получена эта позиция, в формате UTC.
Возвращает недействительный объект QDateTime, если дата/время не заданы.
См. также setTimestamp().
Связанные нечленские функции
bool operator!=(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs)
Возвращает true если какие-либо значения объекта lhs не совпадают со значениями rhs. В противном случае возвращает false.
QDataStream &operator<<(QDataStream &stream, const QGeoPositionInfo &info)
Записывает данный объект info в указанный поток stream.
См. также Сериализация типов данных Qt.
QDataStream &operator<<(QDataStream &stream, QGeoPositionInfo::Attribute attr)
Записывает перечисление attr в указанный поток stream.
См. также Сериализация типов данных Qt.
bool operator==(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs)
Возвращает true если все значения объекта lhs совпадают со значениями rhs. В противном случае возвращает false.
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo &info)
Считывает координаты из указанного потока stream в объект info.
См. также Сериализация типов данных Qt.
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr)
Считывает перечисление атрибута из указанного потока stream в attr.
См. также Сериализация типов данных Qt.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qgeopositioninfo.html
