QGeoSatelliteInfo Class
QGeoSatelliteInfo 클래스에는 위성에 대한 기본 정보가 포함되어 있습니다. 더 보기...
| 헤더: | #include <QGeoSatelliteInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
- 상속된 멤버를 포함한 모든 멤버 목록
- QGeoSatelliteInfo는 암시적 공유 클래스의 일부입니다.
공개 유형
| enum | Attribute { Elevation, Azimuth } |
| enum | SatelliteSystem { Undefined, GPS, GLONASS, GALILEO, BEIDOU, …, CustomType } |
속성
- satelliteIdentifier : int
- satelliteSystem : SatelliteSystem
- signalStrength : qreal
공개 행사
| QGeoSatelliteInfo() | |
| QGeoSatelliteInfo(const QGeoSatelliteInfo &other) | |
(since 6.2) | QGeoSatelliteInfo(QGeoSatelliteInfo &&other) |
| ~QGeoSatelliteInfo() | |
| qreal | attribute(QGeoSatelliteInfo::Attribute attribute) const |
| bool | hasAttribute(QGeoSatelliteInfo::Attribute attribute) const |
| void | removeAttribute(QGeoSatelliteInfo::Attribute attribute) |
| int | satelliteIdentifier() const |
| QGeoSatelliteInfo::SatelliteSystem | satelliteSystem() const |
| void | setAttribute(QGeoSatelliteInfo::Attribute attribute, qreal value) |
| void | setSatelliteIdentifier(int satId) |
| void | setSatelliteSystem(QGeoSatelliteInfo::SatelliteSystem system) |
| void | setSignalStrength(int signalStrength) |
| int | signalStrength() const |
(since 6.2) void | swap(QGeoSatelliteInfo &other) |
(since 6.2) QGeoSatelliteInfo & | operator=(QGeoSatelliteInfo &&other) |
| QGeoSatelliteInfo & | operator=(const QGeoSatelliteInfo &other) |
관련 비회원
| bool | operator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs) |
| QDataStream & | operator<<(QDataStream &stream, const QGeoSatelliteInfo &info) |
| bool | operator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QGeoSatelliteInfo &info) |
QGeoSatelliteInfoSource도 참조하십시오 .
멤버 유형 설명
enum QGeoSatelliteInfo::Attribute
위성 정보에 대한 속성을 정의합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QGeoSatelliteInfo::Elevation | 0 | 위성의 고도(도 단위). |
QGeoSatelliteInfo::Azimuth | 1 | 진북을 기준으로 한 방위각(도 단위). |
enum QGeoSatelliteInfo::SatelliteSystem
위성의 GNSS 시스템을 정의합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QGeoSatelliteInfo::Undefined | 0x00 | 정의되지 않음. |
QGeoSatelliteInfo::GPS | 0x01 | 위성항법시스템(미국). |
QGeoSatelliteInfo::GLONASS | 0x02 | 전 지구 위치 결정 시스템(러시아). |
QGeoSatelliteInfo::GALILEO | 0x03 | 글로벌 항법 위성 시스템 (EU). |
QGeoSatelliteInfo::BEIDOU | 0x04 | 베이두(BeiDou) 항법 위성 시스템(중국). |
QGeoSatelliteInfo::QZSS | 0x05 | 준천정 위성 시스템(일본). |
QGeoSatelliteInfo::IRNSS (since Qt 6.12) | 0x06 | 인도 지역 항법 위성 시스템. |
QGeoSatelliteInfo::SBAS (since Qt 6.12) | 0x07 | 위성 기반 보정 시스템. |
QGeoSatelliteInfo::Multiple | 0xFF | 이 유형은 일반적으로 여러 위성 시스템을 지원하는 장치에서 정보를 수신했음을 나타내며, 위성 시스템이 명시적으로 지정되어 있지 않음을 의미합니다. 데이터 소스에 따라 다른 정보를 사용하여 실제 시스템 유형을 파악할 수도 있습니다. 이 유형의 사용 예로는 NMEA $GNGSA 메시지가 있는데, 이 메시지에는 사용 중인 위성의 ID가 포함되어 있지만 시스템 유형은 명시적으로 언급되어 있지 않습니다. |
QGeoSatelliteInfo::CustomType | 0x100 | 사용자 용도로 사용할 수 있는 첫 번째 유형입니다. 예를 들어, QNmeaSatelliteInfoSource 에서 NMEA 데이터 파싱을 재구현할 때입니다. 사용자는 CustomType + 1, CustomType + 2 등을 사용하여 더 많은 유형을 추가할 수 있습니다. |
속성 설명서
[read-only] satelliteIdentifier : int
이 속성은 위성 식별 번호를 포함합니다.
위성 식별 번호는 위성 시스템 내에서 특정 위성을 식별하는 데 사용할 수 있습니다.
실제 값은 플랫폼 및 선택한 백엔드에 따라 달라질 수 있습니다.
예를 들어, nmea 플러그인을 사용하는 경우, GPS 위성 시스템의 위성 식별자는 PRN(의사 난수) 번호를 나타내고, GLONASS 위성 시스템의 위성 식별자는 슬롯 번호를 나타냅니다.
NMEA 기반 백엔드의 경우, 다른 소스에서 위성 식별자를 확인할 수 없는 경우 이 식별자를 사용하여 위성 시스템 유형을 파악할 수 있습니다. 위성 ID 목록을 참조하여 다양한 위성 시스템의 ID 범위를 확인할 수 있습니다.
참고: 플랫폼 및 선택된 백엔드에따라 서로 다른 위성 시스템의 위성 식별자 범위가 중복될 수 있습니다. 위성을 고유하게 식별하려면 satelliteIdentifier()와 satelliteSystem()를 함께 사용해야 합니다.
액세스 함수:
| int | satelliteIdentifier() const |
[read-only] satelliteSystem : SatelliteSystem
이 속성은 GPS나 GLONASS와 같이 사용 중인 위성 시스템을 나타냅니다.
위성 시스템(GPS, GLONASS 등)을 반환합니다.
참고: 이 값은 ` satelliteIdentifier `와 함께 사용하여 위성을 고유하게 식별할 수 있습니다.
액세스 함수:
| QGeoSatelliteInfo::SatelliteSystem | satelliteSystem() const |
satelliteIdentifier도 참조하십시오 .
[read-only] signalStrength : qreal
이 속성은 신호 강도를 저장합니다.
액세스 함수:
| int | signalStrength() const |
멤버 함수 설명서
QGeoSatelliteInfo::QGeoSatelliteInfo()
위성 정보 객체를 생성합니다.
QGeoSatelliteInfo::QGeoSatelliteInfo(const QGeoSatelliteInfo &other)
other 의 값을 가진 위성 정보 객체를 생성합니다.
[constexpr noexcept default, since 6.2] QGeoSatelliteInfo::QGeoSatelliteInfo(QGeoSatelliteInfo &&other)
other 에서 이동하여 위성 정보 객체를 생성합니다.
이동 원본인 QGeoSatelliteInfo는 소멸되거나 할당될 수만 있다는 점에 유의하십시오. 소멸자나 할당 연산자 이외의 다른 함수를 호출할 경우 그 결과는 정의되지 않습니다.
이 함수는 Qt 6.2에서 도입되었습니다.
[noexcept] QGeoSatelliteInfo::~QGeoSatelliteInfo()
위성 정보 객체를 삭제합니다.
[invokable] qreal QGeoSatelliteInfo::attribute(QGeoSatelliteInfo::Attribute attribute) const
지정된 ` attribute `의 값을 `qreal` 값으로 반환합니다.
값이 설정되지 않은 경우 -1을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. ` Q_INVOKABLE`를 참조하십시오.
hasAttribute() 및 setAttribute()도 참조하십시오 .
[invokable] bool QGeoSatelliteInfo::hasAttribute(QGeoSatelliteInfo::Attribute attribute) const
지정된 attribute 가 이 업데이트에 포함되어 있으면 true를 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
void QGeoSatelliteInfo::removeAttribute(QGeoSatelliteInfo::Attribute attribute)
지정된 attribute 와 그 값을 제거합니다.
int QGeoSatelliteInfo::satelliteIdentifier() const
위성 식별자 번호를 반환합니다.
참고: satelliteIdentifier 속성에 대한게터 함수입니다.
setSatelliteIdentifier() 및 satelliteSystem()도 참조하십시오 .
void QGeoSatelliteInfo::setAttribute(QGeoSatelliteInfo::Attribute attribute, qreal value)
attribute 의 값을 value 로 설정합니다.
attribute()도 참조하십시오 .
void QGeoSatelliteInfo::setSatelliteIdentifier(int satId)
위성 식별 번호를 ‘ satId ’로 설정합니다.
위성 식별 번호는 위성 시스템 내에서 특정 위성을 식별하는 데 사용할 수 있습니다.
실제 값은 플랫폼 및 선택된 백엔드에 따라 달라질 수 있습니다.
예를 들어, nmea 플러그인을 사용하는 경우, GPS 위성 시스템의 위성 식별자는 PRN(의사 난수) 번호를 나타내고, GLONASS 위성 시스템의 위성 식별자는 슬롯 번호를 나타냅니다.
satelliteIdentifier()도 참조하십시오 .
void QGeoSatelliteInfo::setSatelliteSystem(QGeoSatelliteInfo::SatelliteSystem system)
위성 시스템(GPS, GLONASS 등)을 ‘ system ’로 설정합니다.
satelliteSystem()도 참조하십시오 .
void QGeoSatelliteInfo::setSignalStrength(int signalStrength)
신호 강도를 데시벨( signalStrength) 단위로 설정합니다.
signalStrength()도 참조하십시오 .
int QGeoSatelliteInfo::signalStrength() const
신호 강도를 반환하며, 값이 설정되지 않은 경우 -1을 반환합니다.
참고: signalStrength 속성의게터 함수입니다.
참조: ` setSignalStrength()` 함수.
[noexcept, since 6.2] void QGeoSatelliteInfo::swap(QGeoSatelliteInfo &other)
other 와 이 위성 정보를 교환합니다. 이 작업은 매우 빠르며 실패하는 일이 없습니다.
이 함수는 Qt 6.2에서 도입되었습니다.
[noexcept, since 6.2] QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(QGeoSatelliteInfo &&other)
other 의 값을 이 객체로 이동 할당합니다.
이동된 QGeoSatelliteInfo 는 소멸되거나 값이 할당될 수만 있다는 점에 유의하십시오. 소멸자나 할당 연산자 중 하나를 제외한 다른 함수를 호출할 경우의 결과는 정의되지 않습니다.
이 함수는 Qt 6.2에서 도입되었습니다.
QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(const QGeoSatelliteInfo &other)
other 의 값을 이 객체에 할당합니다.
관련 비멤버
bool operator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
lhs 위성의 매개변수 중 하나라도 rhs 의 매개변수와 일치하지 않으면 true 를 반환합니다. 그렇지 않은 경우 false 를 반환합니다.
QDataStream &operator<<(QDataStream &stream, const QGeoSatelliteInfo &info)
지정된 ` info `를 ` stream`에 저장합니다.
'Qt 데이터 유형 직렬화'항목도 참조하십시오 .
bool operator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
lhs 위성의 모든 매개변수가 rhs 의 매개변수와 동일한 경우 true 을 반환합니다. 그렇지 않은 경우 false 을 반환합니다.
QDataStream &operator>>(QDataStream &stream, QGeoSatelliteInfo &info)
지정된 ` stream `에서 위성 정보를 읽어와 주어진 ` info`에 저장합니다.
'Qt 데이터 유형 직렬화'항목도 참조하십시오 .
© 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.
