Position QML Type

“位置”类型存储特定时间点的位置数据，例如坐标（经度、纬度、海拔）和速度。更多内容...

• 所有成员列表，包括继承的成员

属性

• altitudeValid : bool
• coordinate : coordinate
• direction : double (since Qt Positioning 5.3)
• directionAccuracy : double (since Qt Positioning 6.3)
• directionAccuracyValid : bool (since Qt Positioning 6.3)
• directionValid : bool (since Qt Positioning 5.3)
• horizontalAccuracy : real
• horizontalAccuracyValid : bool
• latitudeValid : bool
• longitudeValid : bool
• magneticVariation : double (since Qt Positioning 5.4)
• magneticVariationValid : bool (since Qt Positioning 5.4)
• speed : double
• speedValid : bool
• timestamp : date
• verticalAccuracy : real
• verticalAccuracyValid : bool
• verticalSpeed : double (since Qt Positioning 5.3)
• verticalSpeedValid : bool (since Qt Positioning 5.3)

详细说明

Position类型存储与地理位置相关的值，例如coordinate （经度、纬度和海拔）、获取Position时的timestamp 、当时的speed 以及数据的精度。

它主要用在PositionSource 的position 属性中，作为系统位置数据源提供的数据的基本单位。

Position 对象并非所有属性都必然有效或可用（例如，纬度和经度可能有效，但速度更新尚未收到或未手动设置）。因此，相应的“有效”属性（例如coordinate 、longitudeValid 、latitudeValid 等）可用于判断该位置更新中的数据是否可用且有效。

位置对象为只读对象，且只能由PositionSource 生成。

使用示例

请参阅PositionSource 类型的示例，或“卫星信息”示例应用程序。

另请参阅 PositionSource 和coordinate 。

属性文档

altitudeValid : bool

如果坐标的海拔已设置，则该属性为真（用于指示该数据是否已接收，因为每次更新并不一定包含所有数据）。

另请参阅 coordinate 。

coordinate : coordinate

该属性存储了“Position”的纬度、经度和海拔值。

这是一个只读属性。

另请参阅 longitudeValid 、latitudeValid 和altitudeValid 。

direction : double [since Qt Positioning 5.3]

该属性存储相对于真北的行进方向值（单位为度）。

这是一个只读属性。

该属性自Qt Positioning 5.3起引入。

另请参阅 directionValid 。

directionAccuracy : double [since Qt Positioning 6.3]

该属性表示所提供的direction 的精度（单位为度）。该属性仅适用于Android和macOS/iOS。更多详细信息请参阅QGeoPositionInfo::Attribute 文档。

该属性在Qt Positioning 6.3 中引入。

另请参阅 direction 和directionAccuracyValid 。

directionAccuracyValid : bool [since Qt Positioning 6.3]

如果已设置 `directionAccuracy `，则该属性为 `true `。

该属性自Qt Positioning 6.3 起引入。

另请参阅 directionAccuracy 。

directionValid : bool [since Qt Positioning 5.3]

如果已设置direction ，则该属性为 true（用于指示该数据是否已接收，因为并非每次更新都一定包含所有数据）。

该属性自Qt Positioning 5.3 版本起引入。

另请参阅 direction 。

horizontalAccuracy : real

该属性表示坐标的水平精度（单位：米）。

另请参阅 horizontalAccuracyValid 和coordinate 。

horizontalAccuracyValid : bool

如果已设置 `horizontalAccuracy `（用于指示该数据是否已接收，因为并非每次更新都包含全部数据），则此属性为真。

另请参阅 horizontalAccuracy 。

latitudeValid : bool

如果坐标的纬度已设置，则该属性为真（用于指示该数据是否已接收，因为并非每次更新都包含所有数据）。

另请参阅 coordinate 。

longitudeValid : bool

如果坐标的经度已被设置，则该属性为真（用于指示该数据是否已接收，因为并非每次更新都包含所有数据）。

另请参阅 coordinate 。

magneticVariation : double [since Qt Positioning 5.4]

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

这是一个只读属性。

该属性自Qt Positioning 5.4起引入。

另请参阅 magneticVariationValid 。

magneticVariationValid : bool [since Qt Positioning 5.4]

如果已设置magneticVariation （用于指示该数据是否已接收，因为并非每次更新都包含全部数据），则此属性为true。

该属性自Qt Positioning 5.4版本起引入。

另请参阅 magneticVariation 。

speed : double

该属性存储速度的值（地速，米/秒）。

这是一个只读属性。

另请参阅 speedValid 和coordinate 。

speedValid : bool

如果已设置speed （用于指示该数据是否已接收，因为并非每次更新都包含全部数据），则此属性为true。

另请参阅 speed 。

timestamp : date

该属性保存了接收此位置信息时的时间戳。如果该属性未被设置，则视为无效。

这是一个只读属性。

verticalAccuracy : real

该属性表示坐标的垂直精度（以米为单位）。

另请参阅 verticalAccuracyValid 和coordinate 。

verticalAccuracyValid : bool

如果已设置verticalAccuracy （用于指示该数据是否已接收，因为每次更新不一定都包含所有数据），则此属性为true。

另请参阅 verticalAccuracy 。

verticalSpeed : double [since Qt Positioning 5.3]

该属性存储垂直速度的值，单位为米每秒。

这是一个只读属性。

该属性自Qt Positioning 5.3起引入。

另请参阅《 verticalSpeedValid 》。

verticalSpeedValid : bool [since Qt Positioning 5.3]

如果已设置verticalSpeed （用于指示该数据是否已接收，因为并非每次更新都包含全部数据），则此属性为true。

该属性在Qt Positioning 5.3版本中引入。

另请参阅 verticalSpeed 。