Back to Qt.io
Contact Us Blog Download Qt

Position QML Type

위치 유형은 좌표(경도, 위도, 고도) 및 속도와 같은 특정 시점의 위치 데이터를 저장합니다. 자세히...

Import Statement: import QtPositioning

속성

상세 설명

위치 유형에는 coordinate (경도, 위도, 고도), 위치가 획득된 시점 timestamp, 당시 speed, 데이터의 정확도 등 지리적 위치와 관련된 값이 포함됩니다.

주로 시스템 위치 데이터 소스에서 사용할 수 있는 데이터의 기본 단위로 PositionSource 의 position 속성에서 사용됩니다.

위치 개체의 모든 속성이 반드시 유효하거나 사용 가능한 것은 아닙니다(예: 위도 및 경도는 유효할 수 있지만 속도 업데이트가 수신되지 않았거나 수동으로 설정되지 않은 경우). 따라서 해당 '유효한' 속성(예: 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 [since Qt Positioning 5.3]

이 속성은 verticalSpeed 이 설정된 경우 참입니다(모든 업데이트가 반드시 모든 데이터를 포함하지는 않으므로 해당 데이터를 수신했는지 여부를 나타내기 위해).

이 속성은 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.