QGeoCoordinate Class

멤버 함수 문서

QGeoCoordinate::QGeoCoordinate()

좌표를 생성합니다. setLatitude() 및 setLongitude() 함수가 호출되기 전까지는 이 좌표가 유효하지 않습니다.

QGeoCoordinate::QGeoCoordinate(double latitude, double longitude)

지정된 latitude 및 longitude 을 사용하여 좌표를 생성합니다.

위도가 -90부터 90(포함) 사이가 아니거나, 경도가 -180부터 180(포함) 사이가 아닌 경우, 모든 값이 설정되지 않으며 ` type()`의 반환값은 ` QGeoCoordinate::InvalidCoordinate`가 됩니다.

isValid()도 참조하십시오 .

QGeoCoordinate::QGeoCoordinate(double latitude, double longitude, double altitude)

주어진 latitude, longitude 및 altitude 를 사용하여 좌표를 생성합니다.

위도가 -90에서 90(포함) 사이가 아니거나, 경도가 -180에서 180(포함) 사이가 아닌 경우, 모든 값이 설정되지 않으며 type()의 결과는 QGeoCoordinate::InvalidCoordinate 가 됩니다.

altitude 는 해수면 위 높이를 미터 단위로 지정한다는 점에 유의하십시오.

isValid()도 참조하십시오 .

QGeoCoordinate::QGeoCoordinate(const QGeoCoordinate &other)

other 의 내용을 바탕으로 좌표를 생성합니다.

[constexpr noexcept default, since 6.2] QGeoCoordinate::QGeoCoordinate(QGeoCoordinate &&other)

other 에서 이동하여 좌표를 생성합니다.

이 함수는 Qt 6.2에서 도입되었습니다.

[noexcept] QGeoCoordinate::~QGeoCoordinate()

좌표 객체를 삭제합니다.

double QGeoCoordinate::altitude() const

고도(해발 미터)를 반환합니다.

고도가 설정되지 않은 경우 반환 값은 정의되지 않습니다.

setAltitude() 및 type()도 참조하십시오 .

[invokable] QGeoCoordinate QGeoCoordinate::atDistanceAndAzimuth(qreal distance, qreal azimuth, qreal distanceUp = 0.0) const

현재 좌표( azimuth 또는 방위각)에서 대원(great-circle)을 따라 distance 미터 이동했을 때 도달하는 좌표를 반환합니다. 이 계산에서는 지구가 구형이라는 가정을 전제로 합니다.

고도 값에는 distanceUp 가 더해집니다.

이 좌표가 유효하지 않은 경우, 무효한 좌표를 반환합니다.

[invokable] qreal QGeoCoordinate::azimuthTo(const QGeoCoordinate &other) const

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

반환된 방위는 두 좌표 사이의 대원(great-circle)을 따라 원점(origin)에서 other 까지의 방위각입니다. 이 계산에서는 지구가 구형이라는 가정을 합니다.

이 좌표의 유형이나 other 의 유형이 ` QGeoCoordinate::InvalidCoordinate`인 경우 0을 반환합니다.

[invokable] qreal QGeoCoordinate::distanceTo(const QGeoCoordinate &other) const

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

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

이 좌표의 유형이나 other 의 유형이 QGeoCoordinate::InvalidCoordinate 인 경우 0을 반환합니다.

bool QGeoCoordinate::isValid() const

longitude 와 latitude 가 유효한 경우 true 를 반환합니다.

double QGeoCoordinate::latitude() const

위도를 소수점 도 단위로 반환합니다. 위도가 설정되지 않은 경우 반환값은 정의되지 않습니다.

양수 위도는 북반구를, 음수 위도는 남반구를 나타냅니다.

setLatitude() 및 type()도 참조하십시오 .

double QGeoCoordinate::longitude() const

경도를 소수점 도 단위로 반환합니다. 경도가 설정되지 않은 경우 반환 값은 정의되지 않습니다.

양수 경도는 동반구를, 음수 경도는 서반구를 나타냅니다.

setLongitude() 및 type()도 참조하십시오 .

void QGeoCoordinate::setAltitude(double altitude)

고도(해발 미터)를 altitude 로 설정합니다.

altitude()도 참조하십시오 .

void QGeoCoordinate::setLatitude(double latitude)

위도(십진도 단위)를 latitude 로 설정합니다. 값은 WGS84 좌표계 기준이어야 합니다.

유효한 값이 되려면 위도가 -90에서 90 사이의 범위(양쪽 끝값 포함)에 있어야 합니다.

latitude()도 참조하십시오 .

void QGeoCoordinate::setLongitude(double longitude)

경도(소수점 도 단위)를 longitude 로 설정합니다. 값은 WGS84 좌표계를 기준으로 해야 합니다.

경도는 유효하기 위해 -180부터 180까지(양쪽 끝 포함)의 범위 내에 있어야 합니다.

longitude()도 참조하십시오 .

[noexcept, since 6.2] void QGeoCoordinate::swap(QGeoCoordinate &other)

other 와 이 좌표를 서로 바꿉니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

이 함수는 Qt 6.2에서 도입되었습니다.

[invokable] QString QGeoCoordinate::toString(QGeoCoordinate::CoordinateFormat format = DegreesMinutesSecondsWithHemisphere) const

지정된 ` format` 형식으로 이 좌표를 문자열로 반환합니다.

예를 들어, 이 좌표의 위도가 -27.46758, 경도가 153.027892, 고도가 28.1인 경우, ` format`에 따라 다음과 같은 문자열이 반환됩니다:

고도가 설정되지 않은 경우 고도 필드는 생략됩니다.

좌표가 유효하지 않은 경우, 빈 문자열이 반환됩니다.

QGeoCoordinate::CoordinateType QGeoCoordinate::type() const

이 좌표의 유형을 반환합니다.

[noexcept, since 6.2] QGeoCoordinate &QGeoCoordinate::operator=(QGeoCoordinate &&other)

other 를 이 좌표에 할당하고, 이 좌표에 대한 참조를 반환합니다.

이 함수는 Qt 6.2에서 도입되었습니다.

QGeoCoordinate &QGeoCoordinate::operator=(const QGeoCoordinate &other)

이 좌표에 ` other `를 할당하고, 이 좌표에 대한 참조를 반환합니다.