geoCoordinate QML Value Type

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

속성

• altitude : real
• isValid : bool
• latitude : real
• longitude : real

방법

• geoCoordinate atDistanceAndAzimuth(real distance, real azimuth)
• real azimuthTo(geoCoordinate other)
• real distanceTo(geoCoordinate other)

상세 설명

이 유형은 ` QGeoCoordinate `의 QML 표현이며, ` latitude`, ` longitude `, ` altitude ` 속성의 형태로 지리적 위치를 나타냅니다. ` latitude ` 속성은 적도 위아래의 십진도 수치를 지정합니다. 양의 위도는 북반구를, 음의 위도는 남반구를 나타냅니다. ` longitude ` 속성은 동서 방향의 십진도 수치를 지정합니다. 양수 경도는 동반구를, 음수 경도는 서반구를 나타냅니다. altitude 속성은 해수면 위의 높이(미터 단위)를 지정합니다. 이 속성들은 종합적으로 지구 표면 위나 그 근처의 어느 위치에나 대한 3차원 위치를 지정합니다.

isValid 속성은 좌표가 유효한지 확인하는 데 사용할 수 있습니다. 좌표는 유효한 위도와 경도를 포함할 경우 유효한 것으로 간주됩니다. 유효한 고도는 필수 사항이 아닙니다. 위도는 -90에서 90 사이(양 끝값 포함)여야 하며, 경도는 -180에서 180 사이(양 끝값 포함)여야 합니다.

geoCoordinate 유형은 Qt Location 모듈 내의 다른 많은 유형에서 사용되며, 지도 상의 객체 위치 지정, 기기의 현재 위치 파악 및 기타 다양한 작업을 수행하는 데 활용됩니다. 또한 atDistanceAndAzimuth()와 같이, 복잡한 계산을 간편하게 처리할 수 있게 해주는 여러 가지 중요한 유틸리티 메서드도 제공합니다.

정확도

geoCoordinate 유형에 저장된 위도, 경도 및 고도 속성은 double 형으로 표현되며, 약 16자리의 소수점 정밀도를 갖습니다. 이는 마이크로미터를 지정하기에 충분한 수준입니다. azimuthTo() 및 distanceTo()과 같은 geoCoordinate 메서드에서 수행되는 계산도 모든 중간 값에 double을 사용하지만, 구형 지구 모델에 내재된 부정확성이 출력 오차의 주요 원인이 됩니다.

사용 예

geoCoordinate를 생성하려면 아래에 설명된 메서드 중 하나를 사용하십시오. 모든 경우에 altitude 속성을 지정하는 것은 선택 사항입니다.

geoCoordinate 값을 생성하려면 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 ` 값은 자동으로 `geoCoordinate` 값으로 변환되며, 그 반대의 경우도 마찬가지임을 유의하십시오.

속성 문서

altitude : real

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

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

isValid : bool

이 속성은 좌표의 현재 유효성을 나타냅니다. 좌표는 유효한 위도와 경도가 설정된 경우(고도는 필수 사항이 아님) 유효한 것으로 간주됩니다.

위도가 -90에서 90 사이(양쪽 끝값 포함)여야 유효한 것으로 간주되며, 경도가 -180에서 180 사이(양쪽 끝값 포함)여야 유효한 것으로 간주됩니다.

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

latitude : real

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

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

longitude : real

이 속성은 지리적 위치의 경도 값(소수점 도 단위)을 저장합니다. 양의 경도는 동반구를, 음의 경도는 서반구를 나타냅니다. 이 속성이 설정되지 않은 경우 기본값은 NaN입니다.

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

메서드 문서

geoCoordinate atDistanceAndAzimuth(real distance, real azimuth)

이 좌표에서 azimuth 도 방향으로 대원(great-circle)을 따라 distance 미터를 이동했을 때 도달하는 좌표를 반환합니다.

이 계산에서는 지구가 구형이라는 가정을 전제로 합니다.

real azimuthTo(geoCoordinate other)

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

이 계산에서는 지구가 구형이라는 가정을 전제로 합니다.

real distanceTo(geoCoordinate other)

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

이 계산은 두 좌표 간의 대원 거리를 반환하며, 계산의 목적으로 지구가 구형이라고 가정합니다.