En esta página

QGeoPositionInfo Class

La clase `QGeoPositionInfo` contiene información recopilada sobre la posición global, la dirección y la velocidad en un momento determinado. Más información...

Encabezado: #include <QGeoPositionInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning

Tipos públicos

enum Attribute { Direction, GroundSpeed, VerticalSpeed, MagneticVariation, HorizontalAccuracy, …, DirectionAccuracy }

Funciones públicas

QGeoPositionInfo()
QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime &timestamp)
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 &timestamp)
(since 6.2) void swap(QGeoPositionInfo &other)
QDateTime timestamp() const
(since 6.2) QGeoPositionInfo &operator=(QGeoPositionInfo &&other)
QGeoPositionInfo &operator=(const QGeoPositionInfo &other)
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 objeto QGeoPositionInfo contiene, como mínimo, una coordenada geográfica y una marca de tiempo. También puede incluir mediciones de rumbo y velocidad, así como estimaciones de la precisión de los datos proporcionados.

Véase también QGeoPositionInfoSource.

Documentación sobre los tipos de miembros

enum QGeoPositionInfo::Attribute

Define los atributos de la información posicional.

ConstanteValorDescripción
QGeoPositionInfo::Direction0El rumbo, medido en grados en sentido horario desde el norte verdadero hacia la dirección de desplazamiento.
QGeoPositionInfo::GroundSpeed1La velocidad respecto al suelo, en metros por segundo.
QGeoPositionInfo::VerticalSpeed2La velocidad vertical, en metros por segundo.
QGeoPositionInfo::MagneticVariation3El ángulo entre la componente horizontal del campo magnético y el norte verdadero, en grados. También conocido como declinación magnética. Un valor positivo indica una dirección en el sentido de las agujas del reloj desde el norte verdadero, y un valor negativo indica una dirección en sentido contrario a las agujas del reloj.
QGeoPositionInfo::HorizontalAccuracy4La precisión del valor de latitud y longitud proporcionado, en metros.
QGeoPositionInfo::VerticalAccuracy5La precisión del valor de altitud proporcionado, en metros.
QGeoPositionInfo::DirectionAccuracy6La precisión del rumbo proporcionado, en grados. Este atributo solo está disponible en Android (nivel de API 26 o superior) y en macOS/iOS. Consulta la documentación correspondiente de Android y Apple para obtener 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 independiente para ello. Si necesitas este valor, puedes calcularlo basándote en la siguiente fórmula:

PositionAccuracy 2 = HorizontalAccuracy 2 + VerticalAccuracy 2

Documentación de las funciones miembro

QGeoPositionInfo::QGeoPositionInfo()

Crea un objeto `QGeoPositionInfo` no válido.

Véase también isValid().

QGeoPositionInfo::QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime &timestamp)

Crea un objeto `QGeoPositionInfo` a partir de los valores ` coordinate ` y ` timestamp` proporcionados.

QGeoPositionInfo::QGeoPositionInfo(const QGeoPositionInfo &other)

Crea un objeto `QGeoPositionInfo` con los valores de ` other`.

[constexpr noexcept default, since 6.2] QGeoPositionInfo::QGeoPositionInfo(QGeoPositionInfo &&other)

Crea un objeto `QGeoPositionInfo` a partir de un ` other`.

Ten en cuenta que un objeto QGeoPositionInfo del que se ha realizado un desplazamiento solo puede destruirse o asignarse. 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()

Elimina un objeto ` QGeoPositionInfo `.

qreal QGeoPositionInfo::attribute(QGeoPositionInfo::Attribute attribute) const

Devuelve el valor de la variable « attribute » especificada como un valor de tipo «qreal».

Devuelve NaN si no se ha establecido el valor.

Se debe utilizar la función hasAttribute() para determinar si se ha establecido o no un valor para un atributo.

Véanse también hasAttribute() y setAttribute().

QGeoCoordinate QGeoPositionInfo::coordinate() const

Devuelve la coordenada correspondiente a esta posición.

Devuelve una coordenada no vá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 en este objeto « QGeoPositionInfo ».

bool QGeoPositionInfo::isValid() const

Devuelve «true» si los valores de timestamp() y coordinate() son ambos válidos.

Véanse también QGeoCoordinate::isValid() y QDateTime::isValid().

void QGeoPositionInfo::removeAttribute(QGeoPositionInfo::Attribute attribute)

Elimina el elemento « attribute » especificado 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 &timestamp)

Establece la fecha y la hora en las que se comunicó esta posición a timestamp.

timestamp debe estar en horario 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 la hora en las que se notificó esta posición, en hora UTC.

Devuelve un objeto ` QDateTime ` no válido si no se ha establecido ningún valor de fecha y hora.

Véase también setTimestamp().

[noexcept, since 6.2] QGeoPositionInfo &QGeoPositionInfo::operator=(QGeoPositionInfo &&other)

Move-assigns asigna los valores de other a este objeto.

Ten en cuenta que un objeto de « QGeoPositionInfo » del que se ha realizado una asignación por movimiento solo 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 esta QGeoPositionInfo.

Artículos relacionados para no socios

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 » indicada en el « stream » especificado.

Véase también «Serialización detipos de datos de Qt».

QDataStream &operator<<(QDataStream &stream, const QGeoPositionInfo &info)

Escribe el objeto ` info ` dado en el objeto ` stream` especificado.

Véase también «Serialización detipos de datos de 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 archivo especificado stream y la guarda en el archivo dado info.

Véase también «Serialización detipos de datos de Qt».

QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr)

Lee una enumeración de atributos a partir de la información especificada en stream y la envía a la dirección indicada en attr.

Véase también «Serialización detipos de datos de 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.