QGeoSatelliteInfo Class

The QGeoSatelliteInfo class contains basic information about a satellite. 更多...

头: #include <QGeoSatelliteInfo>
CMake: find_package(Qt6 COMPONENTS Positioning REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning
Since: Qt 5.2

公共类型

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

公共函数

  QGeoSatelliteInfo (QGeoSatelliteInfo && other )
  QGeoSatelliteInfo (const QGeoSatelliteInfo & other )
  QGeoSatelliteInfo ()
QGeoSatelliteInfo & operator= (QGeoSatelliteInfo && other )
QGeoSatelliteInfo & operator= (const 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
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

Defines the attributes for the satellite information.

常量 描述
QGeoSatelliteInfo::Elevation 0 The elevation of the satellite, in degrees.
QGeoSatelliteInfo::Azimuth 1 The azimuth to true north, in degrees.

enum QGeoSatelliteInfo:: SatelliteSystem

Defines the GNSS system of the satellite.

常量 描述
QGeoSatelliteInfo::Undefined 0x00 Not defined.
QGeoSatelliteInfo::GPS 0x01 Global Positioning System (USA).
QGeoSatelliteInfo::GLONASS 0x02 Global Positioning System (Russia).
QGeoSatelliteInfo::GALILEO 0x03 Global navigation satellite system (EU).
QGeoSatelliteInfo::BEIDOU 0x04 BeiDou navigation satellite system (China).
QGeoSatelliteInfo::QZSS 0x05 Quasi-Zenith Satellite System (Japan).
QGeoSatelliteInfo::Multiple 0xFF This type normally indicates that the information is received from a device that supports multiple satellite systems, and the satellite system is not explicitly specified. Depending on the data source, you might use other information to determine the actual system type. One example of the usage of this type is an NMEA $GNGSA message, which contains the IDs of the satellites being used, but does not explicitly mention their system types.
QGeoSatelliteInfo::CustomType 0x100 The first type that can be used for user purposes. For example when reimplementing NMEA data parsing in QNmeaSatelliteInfoSource . User can add more types using CustomType + 1 , CustomType + 2 and so on.

成员函数文档编制

[since 6.2] QGeoSatelliteInfo:: QGeoSatelliteInfo ( QGeoSatelliteInfo && other )

Creates a satellite information object by moving from other .

Note that a moved-from QGeoSatelliteInfo can only be destroyed or assigned to. The effect of calling other functions than the destructor or one of the assignment operators is undefined.

该函数在 Qt 6.2 引入。

QGeoSatelliteInfo:: QGeoSatelliteInfo (const QGeoSatelliteInfo & other )

Creates a satellite information object with the values of other .

QGeoSatelliteInfo:: QGeoSatelliteInfo ()

Creates a satellite information object.

[since 6.2] QGeoSatelliteInfo &QGeoSatelliteInfo:: operator= ( QGeoSatelliteInfo && other )

Move-assigns the value from other to this object

Note that a moved-from QGeoSatelliteInfo can only be destroyed or assigned to. The effect of calling other functions than the destructor or one of the assignment operators is undefined.

该函数在 Qt 6.2 引入。

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

Assigns the values from other 到此对象。

QGeoSatelliteInfo:: ~QGeoSatelliteInfo ()

Destroys a satellite information object.

qreal QGeoSatelliteInfo:: attribute ( QGeoSatelliteInfo::Attribute attribute ) const

Returns the value of the specified attribute as a qreal value.

Returns -1 if the value has not been set.

另请参阅 hasAttribute () 和 setAttribute ().

bool QGeoSatelliteInfo:: hasAttribute ( QGeoSatelliteInfo::Attribute attribute ) const

返回 true 若指定 attribute is present in this update.

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

移除指定 attribute and its value.

int QGeoSatelliteInfo:: satelliteIdentifier () const

Returns the satellite identifier number.

The satellite identifier number can be used to identify a satellite within the satellite system.

The actual value may vary, depending on the platform and the selected backend.

例如,若 nmea plugin is used, the satellite identifier for GPS satellite system represents the PRN (Pseudo-random noise) number, and the satellite identifier for GLONASS satellite system represents the slot number.

For NMEA-based backends the satellite identifier can be used to determine the satellite system type if it is not available from other sources. You can refer to satellite IDs list to check the ID ranges for different satellite systems.

注意: Depending on the platform and the selected backend, the satellite identifier ranges for different satellite systems may intersect. To uniquely identify a satellite, a combination of satelliteIndetifier() and satelliteSystem () must be used.

另请参阅 setSatelliteIdentifier () 和 satelliteSystem ().

QGeoSatelliteInfo::SatelliteSystem QGeoSatelliteInfo:: satelliteSystem () const

Returns the Satellite System (GPS, GLONASS, ...)

注意: This value can be used together with satelliteIdentifier () to uniquely identify a satellite.

另请参阅 setSatelliteSystem () 和 satelliteIdentifier ().

void QGeoSatelliteInfo:: setAttribute ( QGeoSatelliteInfo::Attribute attribute , qreal value )

Sets the value for attribute to value .

另请参阅 attribute ().

void QGeoSatelliteInfo:: setSatelliteIdentifier ( int satId )

Sets the satellite identifier number to satId .

The satellite identifier number can be used to identify a satellite within the satellite system.

The actual value may vary, depending on the platform and the selected backend.

例如,若 nmea plugin is used, the satellite identifier for GPS satellite system represents the PRN (Pseudo-random noise) number, and the satellite identifier for GLONASS satellite system represents the slot number.

另请参阅 satelliteIdentifier ().

void QGeoSatelliteInfo:: setSatelliteSystem ( QGeoSatelliteInfo::SatelliteSystem system )

Sets the Satellite System (GPS, GLONASS, ...) to system .

另请参阅 satelliteSystem ().

void QGeoSatelliteInfo:: setSignalStrength ( int signalStrength )

Sets the signal strength to signalStrength , in decibels.

另请参阅 signalStrength ().

int QGeoSatelliteInfo:: signalStrength () const

Returns the signal strength, or -1 if the value has not been set.

另请参阅 setSignalStrength ().

相关非成员

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

返回 true if any of the parameters of the lhs satellite are not the same as those of rhs . Otherwise returns false .

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

写入给定 info 到指定 stream .

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

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

返回 true if all the parameters of the lhs satellite are the same as those of rhs . Otherwise returns false .

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

Reads satellite information from the specified stream 进给定 info .

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