QGeoPositionInfo Class

The QGeoPositionInfo class contains information gathered on a global position, direction and velocity at a particular point in time. More...

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

• List of all members, including inherited members

Public Types

enum	Attribute { Direction, GroundSpeed, VerticalSpeed, MagneticVariation, HorizontalAccuracy, VerticalAccuracy }

Public Functions

	QGeoPositionInfo(QGeoPositionInfo &&other)
	QGeoPositionInfo(const QGeoPositionInfo &other)
	QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime &timestamp)
	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 &timestamp)
QDateTime	timestamp() const

Related Non-Members

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)

Detailed Description

A QGeoPositionInfo contains, at a minimum, a geographical coordinate and a timestamp. It may also have heading and speed measurements as well as estimates of the accuracy of the provided data.

See also QGeoPositionInfoSource.

Member Type Documentation

enum QGeoPositionInfo::Attribute

Defines the attributes for positional information.

Constant	Value	Description
QGeoPositionInfo::Direction	0	The bearing measured in degrees clockwise from true north to the direction of travel.
QGeoPositionInfo::GroundSpeed	1	The ground speed, in meters/sec.
QGeoPositionInfo::VerticalSpeed	2	The vertical speed, in meters/sec.
QGeoPositionInfo::MagneticVariation	3	The angle between the horizontal component of the magnetic field and true north, in degrees. Also known as magnetic declination. A positive value indicates a clockwise direction from true north and a negative value indicates a counter-clockwise direction.
QGeoPositionInfo::HorizontalAccuracy	4	The accuracy of the provided latitude-longitude value, in meters.
QGeoPositionInfo::VerticalAccuracy	5	The accuracy of the provided altitude value, in meters.

NMEA protocol also suggests another type of accuracy - PositionAccuracy, which is a 3D accuracy value. Qt does not provide a separate attribute for it. If you need this value, you can calculate it based on the following formula:

PositionAccuracy ² = HorizontalAccuracy ² + VerticalAccuracy ²

Member Function Documentation

[since 6.2] QGeoPositionInfo::QGeoPositionInfo(QGeoPositionInfo &&other)

Creates a QGeoPositionInfo object by moving from other.

Note that a moved-from QGeoPositionInfo can only be destroyed or assigned to. The effect of calling other functions than the destructor or one of the assignment operators is undefined.

This function was introduced in Qt 6.2.

QGeoPositionInfo::QGeoPositionInfo(const QGeoPositionInfo &other)

Creates a QGeoPositionInfo with the values of other.

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

Creates a QGeoPositionInfo for the given coordinate and timestamp.

QGeoPositionInfo::QGeoPositionInfo()

Creates an invalid QGeoPositionInfo object.

See also isValid().

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

Move-assigns the values from other to this object.

Note that a moved-from QGeoPositionInfo can only be destroyed or assigned to. The effect of calling other functions than the destructor or one of the assignment operators is undefined.

This function was introduced in Qt 6.2.

QGeoPositionInfo &QGeoPositionInfo::operator=(const QGeoPositionInfo &other)

Assigns the values from other to this QGeoPositionInfo.

QGeoPositionInfo::~QGeoPositionInfo()

Destroys a QGeoPositionInfo object.

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

Returns the value of the specified attribute as a qreal value.

Returns NaN if the value has not been set.

The function hasAttribute() should be used to determine whether or not a value has been set for an attribute.

See also hasAttribute() and setAttribute().

QGeoCoordinate QGeoPositionInfo::coordinate() const

Returns the coordinate for this position.

Returns an invalid coordinate if no coordinate has been set.

See also setCoordinate().

bool QGeoPositionInfo::hasAttribute(QGeoPositionInfo::Attribute attribute) const

Returns true if the specified attribute is present for this QGeoPositionInfo object.

bool QGeoPositionInfo::isValid() const

Returns true if the timestamp() and coordinate() values are both valid.

See also QGeoCoordinate::isValid() and QDateTime::isValid().

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

Removes the specified attribute and its value.

void QGeoPositionInfo::setAttribute(QGeoPositionInfo::Attribute attribute, qreal value)

Sets the value for attribute to value.

See also attribute().

void QGeoPositionInfo::setCoordinate(const QGeoCoordinate &coordinate)

Sets the coordinate for this position to coordinate.

See also coordinate().

void QGeoPositionInfo::setTimestamp(const QDateTime &timestamp)

Sets the date and time at which this position was reported to timestamp.

The timestamp must be in UTC time.

See also timestamp().

QDateTime QGeoPositionInfo::timestamp() const

Returns the date and time at which this position was reported, in UTC time.

Returns an invalid QDateTime if no date/time value has been set.

See also setTimestamp().