QGeoPositionInfo Class
La clase QGeoPositionInfo contiene información recogida sobre una posición global, dirección y velocidad en un momento determinado. Más...
| Cabecera: | #include <QGeoPositionInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
- Lista de todos los miembros, incluyendo los heredados
- QGeoPositionInfo es parte de Clases Implícitamente Compartidas.
Tipos Públicos
| enum | Attribute { Direction, GroundSpeed, VerticalSpeed, MagneticVariation, HorizontalAccuracy, …, DirectionAccuracy } |
Funciones Públicas
| QGeoPositionInfo() | |
| QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp) | |
| QGeoPositionInfo(const QGeoPositionInfo &other) | |
(since 6.2) | QGeoPositionInfo(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) |
(since 6.2) void | swap(QGeoPositionInfo &other) |
| QDateTime | timestamp() const |
(since 6.2) QGeoPositionInfo & | operator=(QGeoPositionInfo &&other) |
| QGeoPositionInfo & | operator=(const QGeoPositionInfo &other) |
No miembros relacionados
| bool | operator!=(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs) |
| QDataStream & | operator<<(QDataStream &stream, QGeoPositionInfo::Attribute attr) |
| QDataStream & | operator<<(QDataStream &stream, const QGeoPositionInfo &info) |
| bool | operator==(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QGeoPositionInfo &info) |
| QDataStream & | operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr) |
Descripción Detallada
Un QGeoPositionInfo contiene, como mínimo, una coordenada geográfica y una marca de tiempo. También puede contener medidas de rumbo y velocidad, así como estimaciones de la precisión de los datos proporcionados.
Véase también QGeoPositionInfoSource.
Documentación de tipos de miembros
enum QGeoPositionInfo::Attribute
Define los atributos para la información posicional.
| Constante | Valor | Descripción |
|---|---|---|
QGeoPositionInfo::Direction | 0 | El rumbo medido en grados en el sentido de las agujas del reloj desde el norte verdadero hacia la dirección de desplazamiento. |
QGeoPositionInfo::GroundSpeed | 1 | La velocidad terrestre, en metros/seg. |
QGeoPositionInfo::VerticalSpeed | 2 | La velocidad vertical, en metros/seg. |
QGeoPositionInfo::MagneticVariation | 3 | El ángulo entre la componente horizontal del campo magnético y el norte verdadero, en grados. También se conoce como declinación magnética. Un valor positivo indica una dirección en el sentido de las agujas del reloj con respecto al norte verdadero y un valor negativo indica una dirección en sentido contrario a las agujas del reloj. |
QGeoPositionInfo::HorizontalAccuracy | 4 | La precisión del valor de latitud-longitud proporcionado, en metros. |
QGeoPositionInfo::VerticalAccuracy | 5 | La precisión del valor de altitud proporcionado, en metros. |
QGeoPositionInfo::DirectionAccuracy | 6 | La precisión del rumbo proporcionado, en grados. Este atributo sólo está disponible en Android (nivel de API 26 o superior) y macOS/iOS. Consulte la documentación correspondiente de Android y Apple para más detalles. |
El protocolo NMEA también sugiere otro tipo de precisión - PositionAccuracy, que es un valor de precisión 3D. Qt no proporciona un atributo separado para ello. Si necesitas este valor, puedes calcularlo basándote en la siguiente fórmula:
PositionAccuracy 2 = HorizontalAccuracy 2 + VerticalAccuracy 2
Documentación de la Función Miembro
QGeoPositionInfo::QGeoPositionInfo()
Crea un objeto QGeoPositionInfo inválido.
Véase también isValid().
QGeoPositionInfo::QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp)
Crea un QGeoPositionInfo para los datos coordinate y timestamp.
QGeoPositionInfo::QGeoPositionInfo(const QGeoPositionInfo &other)
Crea un QGeoPositionInfo con los valores de other.
[constexpr noexcept, since 6.2] QGeoPositionInfo::QGeoPositionInfo(QGeoPositionInfo &&other)
Crea un objeto QGeoPositionInfo movido desde other.
Ten en cuenta que un QGeoPositionInfo movido desde sólo 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] QGeoPositionInfo::~QGeoPositionInfo()
Destruye un objeto QGeoPositionInfo.
qreal QGeoPositionInfo::attribute(QGeoPositionInfo::Attribute attribute) const
Devuelve el valor del attribute especificado como un valor qreal.
Devuelve NaN si no se ha establecido el valor.
La función hasAttribute() debe utilizarse para determinar si se ha establecido o no un valor para un atributo.
Véase también hasAttribute() y setAttribute().
QGeoCoordinate QGeoPositionInfo::coordinate() const
Devuelve la coordenada de esta posición.
Devuelve una coordenada inválida si no se ha establecido ninguna coordenada.
Véase también setCoordinate().
bool QGeoPositionInfo::hasAttribute(QGeoPositionInfo::Attribute attribute) const
Devuelve true si el attribute especificado está presente para este objeto QGeoPositionInfo.
bool QGeoPositionInfo::isValid() const
Devuelve verdadero si los valores timestamp() y coordinate() son ambos válidos.
Véase también QGeoCoordinate::isValid() y QDateTime::isValid().
void QGeoPositionInfo::removeAttribute(QGeoPositionInfo::Attribute attribute)
Elimina la dirección attribute especificada y su valor.
void QGeoPositionInfo::setAttribute(QGeoPositionInfo::Attribute attribute, qreal value)
Establece el valor de attribute en value.
Véase también attribute().
void QGeoPositionInfo::setCoordinate(const QGeoCoordinate &coordinate)
Establece la coordenada de esta posición en coordinate.
Véase también coordinate().
void QGeoPositionInfo::setTimestamp(const QDateTime ×tamp)
Establece la fecha y hora en la que se informó de esta posición a timestamp.
timestamp debe estar en hora UTC.
Véase también timestamp().
[noexcept, since 6.2] void QGeoPositionInfo::swap(QGeoPositionInfo &other)
Intercambia esta información de posición con other. Esta operación es muy rápida y nunca falla.
Esta función se introdujo en Qt 6.2.
QDateTime QGeoPositionInfo::timestamp() const
Devuelve la fecha y hora en la que se informó de esta posición, en hora UTC.
Devuelve un QDateTime inválido si no se ha establecido ningún valor de fecha/hora.
Véase también setTimestamp().
[noexcept, since 6.2] QGeoPositionInfo &QGeoPositionInfo::operator=(QGeoPositionInfo &&other)
Mover-asigna los valores de other a este objeto.
Tenga en cuenta que un objeto movido desde QGeoPositionInfo sólo 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.
QGeoPositionInfo &QGeoPositionInfo::operator=(const QGeoPositionInfo &other)
Asigna los valores de other a este QGeoPositionInfo.
Relacionados No miembros
bool operator!=(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs)
Devuelve true si alguno de los valores del objeto lhs no coincide con los de rhs. En caso contrario devuelve false.
QDataStream &operator<<(QDataStream &stream, QGeoPositionInfo::Attribute attr)
Escribe la enumeración attr dada en el stream especificado.
Véase también Serializar tipos de datos Qt.
QDataStream &operator<<(QDataStream &stream, const QGeoPositionInfo &info)
Escribe el info dado en el stream especificado.
Véase también Serializar tipos de datos Qt.
bool operator==(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs)
Devuelve true si todos los valores del objeto lhs son iguales a los de rhs. En caso contrario devuelve false.
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo &info)
Lee una coordenada del stream especificado en el info dado.
Véase también Serializar tipos de datos Qt.
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr)
Lee una enumeración de atributos del stream especificado info el attr dado .
Véase también Serializar tipos de datos 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.
