位置 QML 类型

位置类型在特定时间点持有位置数据，例如坐标（经度、纬度、海拔）和速度。更多信息...

导入语句	import QtPositioning

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

属性

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

详细说明

位置类型包含有关地理位置的信息，如坐标（经度、纬度和海拔），位置获得时的时间戳，当时的位置速度以及数据的精度。

主要用途是在位置属性中使用，它是系统位置数据源提供的基本数据单元。

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

位置对象是只读的，只能由一个 PositionSource 生成。

用法示例

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

另请参阅 PositionSource 和 coordinate。

属性说明

altitudeValid : bool

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

另请参阅 coordinate。

coordinate : coordinate

此属性包含位置对象的纬度、经度和海拔值。

这是一个只读属性。

另请参阅 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，则该属性为真（以指示该数据是否已接收到，因为每次更新并不一定包含所有数据）。

此属性从 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，则此属性为真（表示是否接收到了该数据，因为每个更新并不一定包含所有数据）。

此属性在 Qt Positioning 5.4 中被引入。

另请参阅 magneticVariation.

speed : double

此属性包含速度（地面速度，米/秒）的值。

这是一个只读属性。

另请参阅 speedValid 和 coordinate.

speedValid : bool

如果已设置 speed，则此属性为真（表示是否接收到了该数据，因为每个更新并不一定包含所有数据）。

另请参阅 speed.

timestamp : date

此属性包含接收此位置时的时间戳。如果此属性未设置，则无效。

这是一个只读属性。

verticalAccuracy : real

此属性包含坐标的垂直精度（米）。

另请参阅 verticalAccuracyValid 和 coordinate.

verticalAccuracyValid : bool

如果已设置 verticalAccuracy，则此属性为真（表示是否接收到了该数据，因为每个更新并不一定包含所有数据）。

另请参阅 verticalAccuracy.

verticalSpeed : double [since Qt Positioning 5.3]

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

这是一个只读属性。

此属性从 Qt Positioning 5.3 版本开始引入。

另请参阅 verticalSpeedValid。

verticalSpeedValid : bool [自 Qt Positioning 5.3 开始]

如果已设置 verticalSpeed（表示已接收到该数据，因为每次更新不一定会包含所有数据），则此属性为 true。

此属性从 Qt Positioning 5.3 版本开始引入。

另请参阅 verticalSpeed。