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)
상세 설명
Position 유형은 좌표( coordinate, 경도, 위도, 고도)와 같은 지리적 위치 관련 값, 위치 정보가 획득된 시점의 시간( timestamp ), 해당 시점의 시각( speed ), 데이터의 정확도 등을 포함합니다.
주로 위치 객체( PositionSource)의 위치 정보( position ) 속성에서 시스템 위치 데이터 소스에서 제공되는 데이터의 기본 단위로 사용됩니다.
Position 객체의 모든 속성이 반드시 유효하거나 사용 가능한 것은 아닙니다(예를 들어, 위도와 경도는 유효할 수 있지만, 속도 업데이트는 수신되지 않았거나 수동으로 설정되지 않았을 수 있습니다). 그 결과, 해당 위치 업데이트에서 데이터가 사용 가능하고 유효한지 여부를 식별하기 위해 "유효한" 속성(예: coordinate, longitudeValid, latitudeValid 등)을 사용할 수 있습니다.
위치 객체는 읽기 전용이며, PositionSource 를 통해서만 생성될 수 있습니다.
사용 예
PositionSource 유형에 대한 예제나 Satellite Info 예제 애플리케이션을 참조하십시오.
PositionSource 및 coordinate도 참조하십시오 .
속성 문서
altitudeValid : bool
이 속성은 좌표의 고도가 설정된 경우 true를 반환합니다(모든 업데이트에 반드시 모든 데이터가 포함되는 것은 아니므로, 해당 데이터가 수신되었는지 여부를 나타내기 위함입니다).
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 의 정확도를 도(degree) 단위로 나타냅니다. 이 속성은 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 가 설정된 경우 이 속성은 true입니다(모든 업데이트에 반드시 모든 데이터가 포함되는 것은 아니므로, 해당 데이터가 수신되었는지 여부를 나타내기 위함입니다).
horizontalAccuracy항목도 참조하십시오 .
latitudeValid : bool
이 속성은 좌표의 위도가 설정된 경우 true를 반환합니다(모든 업데이트에 반드시 모든 데이터가 포함되는 것은 아니므로, 해당 데이터를 수신했는지 여부를 나타내기 위함입니다).
coordinate도 참조하십시오 .
longitudeValid : bool
이 속성은 좌표의 경도가 설정된 경우 true입니다(모든 업데이트에 반드시 모든 데이터가 포함되는 것은 아니므로, 해당 데이터가 수신되었는지 여부를 나타내기 위함입니다).
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도 참조하십시오 .
© 2026 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.