QGeoSatelliteInfo 类

QGeoSatelliteInfo 类包含有关卫星的基本信息。更多...

头文件 #include <QGeoSatelliteInfo>
CMakefind_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmakeQT += positioning

公共类型

枚举属性 { 高度, 方位角 }
枚举卫星系统 { 未定义, GPS, GLONASS, GALILEO, BEIDOU, …, 自定义类型 }

公共函数

QGeoSatelliteInfo()
QGeoSatelliteInfo(const QGeoSatelliteInfo &other)
(自 6.2) QGeoSatelliteInfo(QGeoSatelliteInfo &&other)
~QGeoSatelliteInfo()
qreal属性(QGeoSatelliteInfo::Attribute 属性) const
boolhasAttribute(QGeoSatelliteInfo::Attribute 属性) const
voidremoveAttribute(QGeoSatelliteInfo::Attribute 属性)
int卫星标识符() const
QGeoSatelliteInfo::SatelliteSystem卫星系统() const
voidsetAttribute(QGeoSatelliteInfo::Attribute 属性, qreal )
voidsetSatelliteIdentifier(int satId)
voidsetSatelliteSystem(QGeoSatelliteInfo::SatelliteSystem system)
voidsetSignalStrength(int signalStrength)
intsignalStrength() const
QGeoSatelliteInfo &operator=(const QGeoSatelliteInfo &other)
(自 6.2) QGeoSatelliteInfo &operator=(QGeoSatelliteInfo &&other)
booloperator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
QDataStream &operator<<(QDataStream &stream, const QGeoSatelliteInfo &info)
booloperator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
QDataStream &operator>>(QDataStream &stream, QGeoSatelliteInfo &info)

详细描述

另请参阅QGeoSatelliteInfoSource.

成员类型文档

枚举 QGeoSatelliteInfo::属性

定义卫星信息的属性。

常量描述
QGeoSatelliteInfo::Elevation0卫星的仰角,单位为度。
QGeoSatelliteInfo::Azimuth1真北方向的天文方位角,单位为度。

枚举 QGeoSatelliteInfo::SatelliteSystem

定义卫星的GNSS系统。

常量描述
QGeoSatelliteInfo::Undefined0x00未定义。
QGeoSatelliteInfo::GPS0x01全球定位系统(美国)。
QGeoSatelliteInfo::GLONASS0x02全球定位系统(俄罗斯)。
QGeoSatelliteInfo::GALILEO0x03全球导航卫星系统(欧盟)。
QGeoSatelliteInfo::BEIDOU0x04北斗导航卫星系统(中国)。
QGeoSatelliteInfo::QZSS0x05准地平线卫星系统(日本)。
QGeoSatelliteInfo::Multiple0xFF此类型通常表示从支持多个卫星系统的设备接收到的信息,且未明确指定卫星系统。根据数据源,可能需要使用其他信息来确定实际系统类型。此类型的用法示例之一是NMEA $GNGSA消息,其中包含正在使用的卫星ID,但未明确提及它们的系统类型。
QGeoSatelliteInfo::CustomType0x100第一个可以用于用户目的的类型。例如,在重新实现QNmeaSatelliteInfoSource中的NMEA数据解析时。用户可以使用CustomType + 1CustomType + 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

以qreal值返回指定attribute的值。

如果值未设置,则返回-1。

注意:此函数可以通过元对象系统从QML调用。请参见Q_INVOKABLE

另请参阅:hasAttribute() 和 setAttribute()。

[可调用的] bool QGeoSatelliteInfo::hasAttribute(QGeoSatelliteInfo::Attribute attribute) const

如果指定的 attribute 在此更新中存在,则返回 true。

注意:此函数可以通过元对象系统从QML调用。请参见Q_INVOKABLE

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

删除指定的 attribute 和其值。

int QGeoSatelliteInfo::satelliteIdentifier() const

返回卫星标识符号。

卫星标识符号可用于在卫星系统中识别卫星。

实际值可能因平台和选择的后端而异。

例如,如果使用 nmea 插件,GPS 卫星系统的卫星标识符表示 PRN(伪随机噪声)号,而 GLONASS 卫星系统的卫星标识符表示槽号。

对于基于 NMEA 的后端,如果其他来源不可用,则可以使用卫星标识符确定卫星系统类型。您可以参考 卫星 ID 列表 检查不同卫星系统的 ID 范围。

注意:根据平台和选择的后端,不同卫星系统的卫星标识符范围可能相交。为了唯一识别卫星,必须使用 satelliteIndetifier() 和 satelliteSystem() 的组合。

注意:属性 satelliteIdentifier 的获取函数。

另请参阅:setSatelliteIdentifier() 和 satelliteSystem()。

QGeoSatelliteInfo::SatelliteSystem QGeoSatelliteInfo::satelliteSystem() const

返回卫星系统(GPS、GLONASS、...)

注意:此值可以与 satelliteIdentifier() 结合使用,以唯一识别卫星。

注意:属性 satelliteSystem 的获取函数。

另请参阅: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()。

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

other中的值赋给此对象。

[noexcept, 自6.2以来] QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(QGeoSatelliteInfo &&other)

other的值移动赋给此对象

请注意,已移动的QGeoSatelliteInfo只能被销毁或赋值。调用除构造函数和赋值运算符之外的其他函数的效果是未定义的。

此函数自Qt 6.2起引入。

相关非成员

bool operator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)

如果lhs卫星的任何参数与rhs不相同,则返回true。 Otherwise returns false

QDataStream &operator<<(QDataStream &stream, const QGeoSatelliteInfo &info)

将给定的info写入指定的stream

另请参阅序列化Qt数据类型

bool operator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)

如果lhs卫星的所有参数与rhs相同,则返回true。 Otherwise returns false

QDataStream &operator>>(QDataStream &stream, QGeoSatelliteInfo &info)

从指定的stream读取卫星信息到给定的info中。

另请参阅序列化Qt数据类型

© 2024 Qt公司有限公司。本文档中的文档贡献的版权属于其各自的所有者。本文档根据自由软件基金会发布的GNU自由文档许可协议GNU Free Documentation License第1.3版许可。Qt及其标识是芬兰的Qt公司及其在世界其他地区的商标。所有其他商标均为其各自所有者的财产。