QGeoPositionInfo Class
QGeoPositionInfo 클래스에는 특정 시점의 글로벌 위치, 방향 및 속도에 대해 수집된 정보가 포함되어 있습니다. 더 보기...
| Header: | #include <QGeoPositionInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
- 상속된 멤버를 포함한 모든 멤버의 목록
- QGeoPositionInfo는 암시적으로 공유되는 클래스의 일부입니다.
공용 유형
| enum | Attribute { Direction, GroundSpeed, VerticalSpeed, MagneticVariation, HorizontalAccuracy, …, DirectionAccuracy } |
공용 함수
| QGeoPositionInfo() | |
| QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp) | |
| QGeoPositionInfo(const QGeoPositionInfo &other) | |
(since 6.2) | QGeoPositionInfo(QGeoPositionInfo &&other) |
| ~QGeoPositionInfo() | |
| qreal | attribute(QGeoPositionInfo::Attribute attribute) const |
| QGeoCoordinate | coordinate() const |
| bool | hasAttribute(QGeoPositionInfo::Attribute attribute) const |
| bool | isValid() const |
| void | removeAttribute(QGeoPositionInfo::Attribute attribute) |
| void | setAttribute(QGeoPositionInfo::Attribute attribute, qreal value) |
| void | setCoordinate(const QGeoCoordinate &coordinate) |
| void | setTimestamp(const QDateTime ×tamp) |
(since 6.2) void | swap(QGeoPositionInfo &other) |
| QDateTime | timestamp() const |
(since 6.2) QGeoPositionInfo & | operator=(QGeoPositionInfo &&other) |
| QGeoPositionInfo & | operator=(const QGeoPositionInfo &other) |
관련 비회원
| bool | operator!=(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs) |
| QDataStream & | operator<<(QDataStream &stream, QGeoPositionInfo::Attribute attr) |
| QDataStream & | operator<<(QDataStream &stream, const QGeoPositionInfo &info) |
| bool | operator==(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QGeoPositionInfo &info) |
| QDataStream & | operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr) |
상세 설명
QGeoPositionInfo는 최소한 지리적 좌표와 타임스탬프를 포함합니다. 또한 제공된 데이터의 정확도에 대한 추정치뿐만 아니라 방향 및 속도 측정값도 포함될 수 있습니다.
QGeoPositionInfoSource도 참조하세요 .
멤버 유형 문서
enum QGeoPositionInfo::Attribute
위치 정보에 대한 속성을 정의합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QGeoPositionInfo::Direction | 0 | 진북에서 진행 방향까지 시계 방향으로 측정된 방위입니다. |
QGeoPositionInfo::GroundSpeed | 1 | 지상 속도, 미터/초 단위입니다. |
QGeoPositionInfo::VerticalSpeed | 2 | 수직 속도(미터/초)입니다. |
QGeoPositionInfo::MagneticVariation | 3 | 자기장의 수평 성분과 진북 사이의 각도(도)입니다. 자기 편각이라고도 합니다. 양수 값은 진북에서 시계 방향을 나타내고 음수 값은 시계 반대 방향을 나타냅니다. |
QGeoPositionInfo::HorizontalAccuracy | 4 | 제공된 위도-경도 값의 정확도(미터 단위)입니다. |
QGeoPositionInfo::VerticalAccuracy | 5 | 제공된 고도 값의 정확도(미터)입니다. |
QGeoPositionInfo::DirectionAccuracy | 6 | 제공된 방위 값의 정확도(도)입니다. 이 속성은 Android(API 레벨 26 이상) 및 macOS/iOS에서만 사용할 수 있습니다. 자세한 내용은 해당 Android 및 Apple 설명서를 참조하세요. |
NMEA 프로토콜은 또 다른 유형의 정확도인 3D 정확도 값인 PositionAccuracy도 제안합니다. Qt는 이에 대한 별도의 어트리뷰트를 제공하지 않습니다. 이 값이 필요한 경우 다음 공식에 따라 계산할 수 있습니다:
PositionAccuracy 2 = HorizontalAccuracy 2 + VerticalAccuracy 2
멤버 함수 문서
QGeoPositionInfo::QGeoPositionInfo()
잘못된 QGeoPositionInfo 객체를 만듭니다.
isValid()도 참조하십시오 .
QGeoPositionInfo::QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp)
주어진 coordinate 와 timestamp 에 대한 QGeoPositionInfo 를 생성합니다.
QGeoPositionInfo::QGeoPositionInfo(const QGeoPositionInfo &other)
other 값으로 QGeoPositionInfo 를 생성합니다.
[noexcept, since 6.2] QGeoPositionInfo::QGeoPositionInfo(QGeoPositionInfo &&other)
other 에서 이동하여 QGeoPositionInfo 객체를 생성합니다.
QGeoPositionInfo에서 이동한 객체는 소멸하거나 할당할 수만 있습니다. 소멸자나 할당 연산자 중 하나가 아닌 다른 함수를 호출하는 효과는 정의되지 않았습니다.
이 함수는 Qt 6.2에 도입되었습니다.
[noexcept] QGeoPositionInfo::~QGeoPositionInfo()
QGeoPositionInfo 객체를 삭제합니다.
qreal QGeoPositionInfo::attribute(QGeoPositionInfo::Attribute attribute) const
지정된 attribute 값을 qreal 값으로 반환합니다.
값이 설정되지 않은 경우 NaN을 반환합니다.
hasAttribute() 함수는 속성에 대한 값이 설정되었는지 여부를 확인하는 데 사용해야 합니다.
hasAttribute() 및 setAttribute()도 참조하세요 .
QGeoCoordinate QGeoPositionInfo::coordinate() const
이 위치의 좌표를 반환합니다.
좌표가 설정되지 않은 경우 잘못된 좌표를 반환합니다.
setCoordinate()도 참조하세요 .
bool QGeoPositionInfo::hasAttribute(QGeoPositionInfo::Attribute attribute) const
지정된 attribute 이 QGeoPositionInfo 객체에 대해 존재하면 true를 반환합니다.
bool QGeoPositionInfo::isValid() const
timestamp() 및 coordinate() 값이 모두 유효하면 true를 반환합니다.
QGeoCoordinate::isValid() 및 QDateTime::isValid()도 참조하세요 .
void QGeoPositionInfo::removeAttribute(QGeoPositionInfo::Attribute attribute)
지정된 attribute 및 해당 값을 제거합니다.
void QGeoPositionInfo::setAttribute(QGeoPositionInfo::Attribute attribute, qreal value)
attribute 의 값을 value 으로 설정합니다.
attribute()도 참조하세요 .
void QGeoPositionInfo::setCoordinate(const QGeoCoordinate &coordinate)
이 위치의 좌표를 coordinate 로 설정합니다.
coordinate()도 참조하세요 .
void QGeoPositionInfo::setTimestamp(const QDateTime ×tamp)
이 위치가 timestamp 으로 보고된 날짜와 시간을 설정합니다.
timestamp 은 UTC 시간이어야 합니다.
timestamp()도 참조하세요 .
[noexcept, since 6.2] void QGeoPositionInfo::swap(QGeoPositionInfo &other)
이 위치 정보를 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.
이 기능은 Qt 6.2에 도입되었습니다.
QDateTime QGeoPositionInfo::timestamp() const
이 위치가 보고된 날짜와 시간을 UTC 시간으로 반환합니다.
날짜/시간 값이 설정되지 않은 경우 유효하지 않은 QDateTime 을 반환합니다.
setTimestamp()도 참조하세요 .
[noexcept, since 6.2] QGeoPositionInfo &QGeoPositionInfo::operator=(QGeoPositionInfo &&other)
이동 - other 의 값을 이 개체에 할당합니다.
QGeoPositionInfo 에서 이동한 객체는 소멸하거나 할당할 수만 있습니다. 소멸자나 할당 연산자 중 하나가 아닌 다른 함수를 호출하는 효과는 정의되지 않았습니다.
이 함수는 Qt 6.2에 도입되었습니다.
QGeoPositionInfo &QGeoPositionInfo::operator=(const QGeoPositionInfo &other)
other 의 값을 이 QGeoPositionInfo 에 할당합니다.
관련 비회원
bool operator!=(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs)
lhs 객체의 값이 rhs 의 값과 같지 않으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
QDataStream &operator<<(QDataStream &stream, QGeoPositionInfo::Attribute attr)
지정된 attr 열거형을 지정된 stream 에 씁니다.
Qt 데이터형 직렬화도참조하십시오 .
QDataStream &operator<<(QDataStream &stream, const QGeoPositionInfo &info)
주어진 info 을 지정된 stream 에 씁니다.
Qt 데이터 형 직렬화도참조하십시오 .
bool operator==(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs)
lhs 객체의 모든 값이 rhs 의 값과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo &info)
지정된 stream 에서 주어진 info 으로 좌표를 읽습니다.
Qt 데이터형 직렬화도참조하십시오 .
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr)
지정된 attr 에서 지정된 stream 정보로부터 어트리뷰트 열거를 읽습니다.
Qt 데이터형 직렬화도참조하십시오 .
© 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.
