Position QML Type
位置类型保存特定时间点的位置数据，如坐标（经度、纬度、高度）和速度。更多
| Import Statement: | import QtPositioning |
属性
- 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)
详细说明
位置类型保存与地理位置相关的值，如coordinate （经度、纬度和高度）、获取位置时的timestamp 、当时的speed 以及数据的准确性。
它主要用于position 属性中的PositionSource ，是系统位置数据源提供的基本数据单位。
位置对象的所有属性并不一定都有效或可用（例如，经度和纬度可能有效，但速度更新尚未 收到或未手动设置）。因此，可以使用相应的 "有效 "属性（例如coordinate 和longitudeValid,latitudeValid 等）来判别该位置更新中的数据是否可用和有效。
位置对象是只读的，只能由PositionSource 生成。
使用示例
请参阅PositionSource 类型的示例或卫星信息示例应用程序。
另请参阅 PositionSource 和coordinate 。
属性文档
altitudeValid : bool |
如果坐标的高度已设置，则此属性为 true（表示是否已收到该数据，因为每次更新并不一定包含所有数据）。
另请参阅 coordinate 。
coordinate : coordinate |
direction : double |
directionAccuracy : double |
该属性表示所提供的direction 的精确度，单位为度。该属性仅适用于 Android 和 macOS/iOS。更多详情，请参阅QGeoPositionInfo::Attribute 文档。
该属性在Qt Positioning 6.3 中引入。
另请参阅 direction 和directionAccuracyValid 。
directionAccuracyValid : bool |
directionValid : bool |
horizontalAccuracy : real |
该属性表示坐标的水平精度（单位：米）。
另请参阅 horizontalAccuracyValid 和coordinate 。
horizontalAccuracyValid : bool |
如果已设置horizontalAccuracy ，则此属性为 true（表示是否已收到数据，因为每次更新不一定包含所有数据）。
另请参阅 horizontalAccuracy 。
latitudeValid : bool |
如果已设置坐标的纬度，则此属性为 true（表示是否已收到该数据，因为每次更新不一定包含所有数据）。
另请参阅 coordinate 。
longitudeValid : bool |
如果已设置坐标的经度，则此属性为 true（表示是否已收到该数据，因为每次更新不一定包含所有数据）。
另请参阅 coordinate 。
magneticVariation : double |
该属性表示磁场水平分量与真北之间的夹角，单位为度。也称为磁偏角。正值表示从真北开始的顺时针方向，负值表示逆时针方向。
这是一个只读属性。
该属性在Qt Positioning 5.4 中引入。
另请参阅 magneticVariationValid 。
magneticVariationValid : bool |
如果已设置magneticVariation ，则此属性为 true（表示是否已收到数据，因为每次更新不一定包含所有数据）。
该属性在Qt Positioning 5.4 中引入。
另请参阅 magneticVariation 。
speed : double |
timestamp : date |
该属性保存接收到该位置的时间戳。如果该属性未被设置，则无效。
这是一个只读属性。
verticalAccuracy : real |
该属性保存坐标的垂直精度（以米为单位）。
另请参阅 verticalAccuracyValid 和coordinate 。
verticalAccuracyValid : bool |
如果已设置verticalAccuracy ，则此属性为 true（表示是否已收到数据，因为每次更新不一定包含所有数据）。
另请参阅 verticalAccuracy 。
verticalSpeed : double |
verticalSpeedValid : bool |
如果已设置verticalSpeed ，则此属性为 true（表示是否已收到数据，因为每次更新不一定包含所有数据）。
该属性在Qt Positioning 5.3 中引入。
另请参见 verticalSpeed 。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
