coordinate QML Value Type

좌표 유형은 지리적 위치를 나타내고 저장합니다. 더 보기...

상세 설명

이 유형은 QGeoCoordinate 의 QML 표현이며 latitude, longitude 및 altitude 속성의 형태로 지리적 위치를 나타냅니다. latitude 속성은 적도 위아래의 소수점 이하 도수를 지정합니다. 양수 위도는 북반구를 나타내고 음수 위도는 남반구를 나타냅니다. longitude 속성은 동쪽과 서쪽의 소수점 이하 도수를 지정합니다. 경도가 양수이면 동반구를 나타내고 경도가 음수이면 서반구를 나타냅니다. altitude 속성은 해발 미터 수를 지정합니다. 이러한 속성을 함께 사용하면 지구 표면 또는 그 근처의 3차원 위치를 지정할 수 있습니다.

isValid 속성은 좌표가 유효한지 테스트하는 데 사용할 수 있습니다. 좌표에 유효한 위도와 경도가 있으면 유효한 좌표로 간주됩니다. 유효한 고도는 필요하지 않습니다. 위도는 -90에서 90 사이여야 하고 경도는 -180에서 180 사이여야 합니다.

coordinate 유형은 Qt Location 모듈의 다른 많은 유형에서 맵에서 개체의 위치, 디바이스의 현재 위치 및 기타 여러 작업을 지정하는 데 사용됩니다. 또한 atDistanceAndAzimuth()와 같이 복잡한 계산을 간단하게 만들어주는 여러 가지 중요한 유틸리티 메서드도 있습니다.

정확도

좌표 유형에 저장된 위도, 경도 및 고도 속성은 두 배로 표시되어 약 16자리 소수점 이하의 정밀도를 가지며, 이는 마이크로미터를 지정하기에 충분합니다. azimuthTo () 및 distanceTo()와 같은 좌표 메서드에서 수행되는 계산도 모든 중간 값에 배수를 사용하지만 구형 지구 모델의 고유한 부정확성이 출력의 오차 범위를 지배합니다.

사용 예

var 유형의 속성을 사용하여 coordinate 을 저장합니다. coordinate 을 만들려면 아래 설명된 방법 중 하나를 사용합니다. 모든 경우에 altitude 속성을 지정하는 것은 선택 사항입니다.

coordinate 값을 만들려면 QtPositioning.coordinate() 함수를 사용합니다:

import QtPositioning

Location { coordinate: QtPositioning.coordinate(-27.5, 153.1) }

또는 별도의 latitude, longitude 및 altitude 컴포넌트를 사용합니다:

Location {
    coordinate {
        latitude: -27.5
        longitude: 153.1
    }
}

C++와 통합할 때 C++에서 QML로 전달된 QGeoCoordinate 값은 자동으로 coordinate 값으로 변환되며, 그 반대의 경우도 마찬가지입니다.

속성

latitude

real latitude

이 속성은 지리적 위치의 위도 값(소수점 이하)을 보유합니다. 양수 위도는 북반구를 나타내고 음수 위도는 남반구를 나타냅니다. 속성을 설정하지 않은 경우 기본값은 NaN입니다.

자세한 내용은 QGeoCoordinate::latitude 속성을 참조하세요.

경도

real longitude

이 속성은 지리적 위치의 경도 값(소수점 이하)을 보유합니다. 경도가 양수이면 동반구를 나타내고 경도가 음수이면 서반구를 나타냅니다. 속성이 설정되지 않은 경우 기본값은 NaN입니다.

자세한 내용은 QGeoCoordinate::longitude 속성을 참조하세요.

altitude

real altitude

이 속성은 고도 값(해발 미터)을 보유합니다. 속성이 설정되지 않은 경우 기본값은 NaN입니다.

자세한 내용은 QGeoCoordinate::altitude 속성을 참조하세요.

isValid

bool isValid

이 속성은 좌표의 현재 유효성을 보유합니다. 좌표가 유효한 위도와 경도로 설정된 경우 좌표가 유효한 것으로 간주됩니다(고도는 필요하지 않음).

위도는 -90에서 90 사이여야 유효하고 경도는 -180에서 180 사이여야 유효한 것으로 간주됩니다.

이 속성은 읽기 전용 속성입니다.

메서드

distanceTo()

real distanceTo(coordinate other)

이 좌표에서 other 에 지정된 좌표까지의 거리(미터)를 반환합니다. 고도는 계산에 사용되지 않습니다.

이 계산은 지구가 구형이라는 가정 하에 두 좌표 사이의 큰 원 거리를 반환합니다.

azimuthTo()

real azimuth(coordinate other)

이 좌표에서 other 에 지정된 좌표까지의 방위각(또는 방위)을 도 단위로 반환합니다. 고도는 계산에 사용되지 않습니다.

이 계산의 목적상 지구는 구형이라는 가정이 있습니다.

atDistanceAndAzimuth()

coordinate atDistanceAndAzimuth(real distance, real azimuth)

이 좌표에서 azimuth 도의 큰 원을 따라 distance 미터를 이동하여 도달한 좌표를 반환합니다.

이 계산의 목적상 지구는 구형이라는 가정이 있습니다.