QGeoSatelliteInfo Class

QGeoSatelliteInfo 클래스에는 위성에 대한 기본 정보가 포함되어 있습니다. 더 보기...

헤더: #include <QGeoSatelliteInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning

공용 유형

enum Attribute { Elevation, Azimuth }
enum SatelliteSystem { Undefined, GPS, GLONASS, GALILEO, BEIDOU, …, CustomType }

공용 함수

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::Elevation0위성의 고도(도)입니다.
QGeoSatelliteInfo::Azimuth1진북에 대한 방위각(도)입니다.

enum QGeoSatelliteInfo::SatelliteSystem

위성의 GNSS 시스템을 정의합니다.

Constant설명
QGeoSatelliteInfo::Undefined0x00정의되지 않았습니다.
QGeoSatelliteInfo::GPS0x01글로벌 포지셔닝 시스템(미국)입니다.
QGeoSatelliteInfo::GLONASS0x02글로벌 포지셔닝 시스템(러시아).
QGeoSatelliteInfo::GALILEO0x03글로벌 내비게이션 위성 시스템(EU).
QGeoSatelliteInfo::BEIDOU0x04베이더우 항법 위성 시스템(중국).
QGeoSatelliteInfo::QZSS0x05준천정위성 시스템(일본).
QGeoSatelliteInfo::Multiple0xFF이 유형은 일반적으로 여러 위성 시스템을 지원하는 장치에서 정보를 수신하고 위성 시스템이 명시적으로 지정되지 않았음을 나타냅니다. 데이터 소스에 따라 다른 정보를 사용하여 실제 시스템 유형을 결정할 수 있습니다. 이 유형의 사용 예 중 하나는 사용 중인 위성의 ID를 포함하지만 시스템 유형을 명시적으로 언급하지 않는 NMEA $GNGSA 메시지입니다.
QGeoSatelliteInfo::CustomType0x100사용자 목적으로 사용할 수 있는 첫 번째 유형입니다. 예를 들어 QNmeaSatelliteInfoSource 에서 NMEA 데이터 구문 분석을 다시 구현할 때 사용합니다. 사용자는 CustomType + 1, CustomType + 2 등을 사용하여 더 많은 유형을 추가할 수 있습니다.

멤버 함수 문서

QGeoSatelliteInfo::QGeoSatelliteInfo()

위성 정보 개체를 생성합니다.

QGeoSatelliteInfo::QGeoSatelliteInfo(const QGeoSatelliteInfo &other)

other 값으로 위성 정보 객체를 생성합니다.

[noexcept, 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 이 업데이트에 존재하면 참을 반환합니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

void QGeoSatelliteInfo::removeAttribute(QGeoSatelliteInfo::Attribute attribute)

지정된 attribute 및 해당 값을 제거합니다.

int QGeoSatelliteInfo::satelliteIdentifier() const

위성 식별자 번호를 반환합니다.

위성 식별자 번호는 위성 시스템 내에서 위성을 식별하는 데 사용할 수 있습니다.

실제 값은 플랫폼과 선택한 백엔드에 따라 다를 수 있습니다.

예를 들어, NMEA 플러그인을 사용하는 경우 GPS 위성 시스템의 위성 식별자는 PRN(의사 랜덤 노이즈) 번호를 나타내고 GLONASS 위성 시스템의 위성 식별자는 슬롯 번호를 나타냅니다.

NMEA 기반 백엔드의 경우 다른 출처에서 위성 식별자를 사용할 수 없는 경우 위성 식별자를 사용하여 위성 시스템 유형을 확인할 수 있습니다. 위성 ID 목록을 참조하여 다양한 위성 시스템의 ID 범위를 확인할 수 있습니다.

참고: 플랫폼과 선택한 백엔드에 따라 서로 다른 위성 시스템의 위성 식별자 범위가 교차할 수 있습니다. 위성을 고유하게 식별하려면 satelliteIndetifier()와 satelliteSystem()를 조합하여 사용해야 합니다.

참고: 위성 식별자 속성에 대한 겟터 함수.

setSatelliteIdentifier() 및 satelliteSystem()도 참조하세요 .

QGeoSatelliteInfo::SatelliteSystem QGeoSatelliteInfo::satelliteSystem() const

위성 시스템(GPS, GLONASS, ...)을 반환합니다.

참고: 이 값은 satelliteIdentifier()와 함께 사용하여 위성을 고유하게 식별할 수 있습니다.

참고: 위성 시스템 속성에 대한 게터 함수입니다.

setSatelliteSystem() 및 satelliteIdentifier()도 참조하세요 .

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 데이터 유형 직렬화도참조하십시오 .

© 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.