PySide6.QtPositioning.QGeoPositionInfo¶

class QGeoPositionInfo¶

QGeoPositionInfo 类包含在特定时间点收集的全球位置、方向和速度信息。更多…

概要¶

方法¶

def __init__()
def attribute()
def coordinate()
def hasAttribute()
def isValid()
def __ne__()
def __eq__()
def removeAttribute()
def setAttribute()
def setCoordinate()
def setTimestamp()
def swap()
def timestamp()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

一个QGeoPositionInfo至少包含一个地理坐标和一个时间戳。它还可能包含方向和速度测量值，以及提供数据准确性的估计。

另请参阅

QGeoPositionInfoSource

class Attribute¶

定义位置信息的属性。

常量

描述

QGeoPositionInfo.Direction

从正北方向顺时针测量到行进方向的方位角，单位为度。

QGeoPositionInfo.GroundSpeed

地面速度，单位为米/秒。

QGeoPositionInfo.VerticalSpeed

垂直速度，单位为米/秒。

QGeoPositionInfo.MagneticVariation

磁场水平分量与真北之间的角度，以度为单位。也称为磁偏角。正值表示从真北顺时针方向，负值表示逆时针方向。

QGeoPositionInfo.HorizontalAccuracy

提供的纬度-经度值的精度，单位为米。

QGeoPositionInfo.VerticalAccuracy

提供的海拔值的精度，单位为米。

QGeoPositionInfo.DirectionAccuracy

提供的方向的精度，以度为单位。此属性仅在Android（API级别26或更高）和macOS/iOS上可用。有关更多详细信息，请参阅相应的Android和Apple文档。

常量	描述
QGeoPositionInfo.Direction	从正北方向顺时针测量到行进方向的方位角，单位为度。
QGeoPositionInfo.GroundSpeed	地面速度，单位为米/秒。
QGeoPositionInfo.VerticalSpeed	垂直速度，单位为米/秒。
QGeoPositionInfo.MagneticVariation	磁场水平分量与真北之间的角度，以度为单位。也称为磁偏角。正值表示从真北顺时针方向，负值表示逆时针方向。
QGeoPositionInfo.HorizontalAccuracy	提供的纬度-经度值的精度，单位为米。
QGeoPositionInfo.VerticalAccuracy	提供的海拔值的精度，单位为米。
QGeoPositionInfo.DirectionAccuracy	提供的方向的精度，以度为单位。此属性仅在Android（API级别26或更高）和macOS/iOS上可用。有关更多详细信息，请参阅相应的Android和Apple文档。

NMEA协议还建议了另一种类型的精度——PositionAccuracy，这是一个3D精度值。Qt没有为它提供单独的属性。如果你需要这个值，可以根据以下公式计算：

PositionAccuracy ² = HorizontalAccuracy ² + VerticalAccuracy ²

__init__()¶

创建一个无效的 QGeoPositionInfo 对象。

另请参阅

isValid()

__init__(other)

Parameters:: 其他 – QGeoPositionInfo

创建一个QGeoPositionInfo，其值为other。

__init__(coordinate, updateTime)

Parameters:

coordinate – QGeoCoordinate
updateTime – QDateTime

为给定的coordinate和timestamp创建一个QGeoPositionInfo。

attribute(attribute)¶

Parameters:: 属性 – Attribute
Return type:: 浮点数

返回指定attribute的值作为qreal值。

如果值未设置，则返回NaN。

函数 hasAttribute() 应该用于确定是否为属性设置了值。

另请参阅

hasAttribute() setAttribute()

coordinate()¶

Return type:: QGeoCoordinate

返回此位置的坐标。

如果没有设置坐标，则返回一个无效的坐标。

另请参阅

setCoordinate()

hasAttribute(attribute)¶

Parameters:: 属性 – Attribute
Return type:: 布尔

如果指定的attribute存在于这个QGeoPositionInfo对象中，则返回true。

isValid()¶

Return type:: 布尔

如果timestamp()和coordinate()的值都有效，则返回true。

另请参阅

isValid() isValid()

__ne__(rhs)¶

Parameters:: rhs – QGeoPositionInfo
Return type:: 布尔

如果lhs对象的任何值与rhs的值不相同，则返回true。否则返回false。

__eq__(rhs)¶

Parameters:: rhs – QGeoPositionInfo
Return type:: 布尔

如果lhs对象的所有值与rhs的值相同，则返回true。否则返回false。

removeAttribute(attribute)¶

Parameters:: 属性 – Attribute

移除指定的attribute及其值。

setAttribute(attribute, value)¶

Parameters:

属性 – Attribute
value – 浮点数

将attribute的值设置为value。

另请参阅

attribute()

setCoordinate(coordinate)¶

Parameters:: 坐标 – QGeoCoordinate

将此位置的坐标设置为 coordinate。

另请参阅

coordinate()

setTimestamp(timestamp)¶

Parameters:: 时间戳 – QDateTime

将此位置报告的日期和时间设置为timestamp。

timestamp 必须使用UTC时间。

另请参阅

timestamp()

swap(other)¶

Parameters:: 其他 – QGeoPositionInfo

timestamp()¶

Return type:: QDateTime

返回此位置报告的日期和时间，以UTC时间为准。

如果没有设置日期/时间值，则返回一个无效的QDateTime。

另请参阅

setTimestamp()