이 페이지에서

위치 지정 (QML)

위치 및 위치 파악

위치 데이터는 위도-경도 좌표로 제공되는 지구 표면의 정확한 위치와 다음과 같은 관련 데이터를 포함합니다:

  • 위치가 보고된 날짜 및 시간
  • 위치를 보고한 기기의 속도
  • 보고된 위치의 고도(해발 높이)
  • 진북을 기준으로 한 기기의 방위각(도 단위)

자세한 내용은 ‘지리적 좌표’를 참조하십시오.

이 데이터는 다양한 방법을 통해 추출할 수 있습니다. 가장 잘 알려진 위치 파악 방법 중 하나는 GPS(Global Positioning System)로, 지구 궤도를 도는 위성에서 수신된 전파 신호를 사용하여 수신기의 정확한 위치와 시간을 계산하는 공개 시스템입니다. 또 다른 널리 사용되는 방법은 '셀 식별자 위치 파악(Cell Identifier Positioning)'으로, 수신 기기에 현재 서비스를 제공하고 있는 셀 사이트의 셀 식별자를 사용하여 대략적인 위치를 계산합니다. 이러한 위치 파악 방법과 그 밖의 방법들은 모두 위치 API와 함께 사용할 수 있습니다. API 내에서 위치 데이터 소스에 대한 유일한 요구 사항은 날짜/시간 값과 함께 위도-경도 좌표를 제공해야 한다는 것이며, 위에 나열된 다른 속성을 제공할 수도 있습니다.

좌표

geoCoordinate 유형은 지리 정보의 기본 단위인 좌표를 제공합니다. 이 유형에는 latitude, longitude 및 altitude 을 저장하는 속성이 있습니다. Location 에는 물리적 주소와 경계 상자 외에도 geoCoordinate 가 포함됩니다. 참조: retrieving a location

위치

객체의 3차원 위치를 저장하는 ` geoCoordinate` 외에도, ` Position ` 유형은 향후 위치를 계산하기 위한 ` speed ` 및 ` timestamp `을 제공합니다. ` Position `은 다음 속성으로 노출되는 이러한 속성에 대해 타당한 값인지 유효성 검사를 수행합니다:

PositionSource 유형

Position 와 geoCoordinate 유형이 있지만, 데이터는 어디에서 오는 것일까요? 대체 소스를 지정할 수 있는 기능도 유용합니다. 예를 들어, GPS 위성을 직접 수신하는 대신 데이터 파일을 사용하여 테스트를 수행하는 것이 바람직할 수도 있습니다.

PositionSource 유형은 개발자가 플랫폼이 허용하는 범위 내에서 지리 데이터의 출처를 제어할 수 있도록 해줍니다. PositionSource 는 NMEA 플러그인을 포함하여 여러 플러그인을 지원합니다.

NMEA는 항법 데이터를 지정하기 위한 일반적인 텍스트 기반 프로토콜입니다. PositionSource 의 NMEA 플러그인은 원시 파일이나 TCP 소켓을 포함한 다양한 데이터 소스를 지원합니다. 이 소스는 각 NMEA 문장의 타임스탬프에 따라 업데이트를 전송하여 기록된 데이터의 “재생”을 생성합니다.

사용 예시는 플러그인 설명서를 참조하십시오.

위성 정보 예제

'위성 정보' 예제는 PositionSource 및 SatelliteSource QML 유형을 사용하여 현재 위치와 관련된 위성 정보를 가져옵니다.

© 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.