class QGeoPositionInfo

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

Synopsis

Methods

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

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.

class Attribute

Defines the attributes for positional information.

Constant

Description

QGeoPositionInfo.Direction

The bearing measured in degrees clockwise from true north to the direction of travel.

QGeoPositionInfo.GroundSpeed

The ground speed, in meters/sec.

QGeoPositionInfo.VerticalSpeed

The vertical speed, in meters/sec.

QGeoPositionInfo.MagneticVariation

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

The accuracy of the provided latitude-longitude value, in meters.

QGeoPositionInfo.VerticalAccuracy

The accuracy of the provided altitude value, in meters.

QGeoPositionInfo.DirectionAccuracy

The accuracy of the provided bearing, in degrees. This attribute is available only on Android (API level 26 or above) and macOS/iOS. See corresponding Android and Apple documentation for more details.

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 2 = HorizontalAccuracy 2 + VerticalAccuracy 2

__init__()

Creates an invalid QGeoPositionInfo object.

See also

isValid()

__init__(other)
Parameters:

otherQGeoPositionInfo

Creates a QGeoPositionInfo with the values of other.

__init__(coordinate, updateTime)
Parameters:

Creates a QGeoPositionInfo for the given coordinate and timestamp.

attribute(attribute)
Parameters:

attributeAttribute

Return type:

float

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.

coordinate()
Return type:

QGeoCoordinate

Returns the coordinate for this position.

Returns an invalid coordinate if no coordinate has been set.

See also

setCoordinate()

hasAttribute(attribute)
Parameters:

attributeAttribute

Return type:

bool

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

isValid()
Return type:

bool

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

See also

isValid() isValid()

__ne__(rhs)
Parameters:

rhsQGeoPositionInfo

Return type:

bool

Returns true if any of the lhs object’s values are not the same as those of rhs. Otherwise returns false.

__eq__(rhs)
Parameters:

rhsQGeoPositionInfo

Return type:

bool

Returns true if all of the lhs object’s values are the same as those of rhs. Otherwise returns false.

removeAttribute(attribute)
Parameters:

attributeAttribute

Removes the specified attribute and its value.

setAttribute(attribute, value)
Parameters:

Sets the value for attribute to value.

See also

attribute()

setCoordinate(coordinate)
Parameters:

coordinateQGeoCoordinate

Sets the coordinate for this position to coordinate.

See also

coordinate()

setTimestamp(timestamp)
Parameters:

timestampQDateTime

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

The timestamp must be in UTC time.

See also

timestamp()

swap(other)
Parameters:

otherQGeoPositionInfo

timestamp()
Return type:

QDateTime

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()