class QGeoSatelliteInfo

The QGeoSatelliteInfo class contains basic information about a satellite. More

Synopsis

Properties

Methods

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description

class Attribute

Defines the attributes for the satellite information.

Constant

Description

QGeoSatelliteInfo.Elevation

The elevation of the satellite, in degrees.

QGeoSatelliteInfo.Azimuth

The azimuth to true north, in degrees.

class SatelliteSystem

Defines the GNSS system of the satellite.

Constant

Description

QGeoSatelliteInfo.Undefined

Not defined.

QGeoSatelliteInfo.GPS

Global Positioning System (USA).

QGeoSatelliteInfo.GLONASS

Global Positioning System (Russia).

QGeoSatelliteInfo.GALILEO

Global navigation satellite system (EU).

QGeoSatelliteInfo.BEIDOU

BeiDou navigation satellite system (China).

QGeoSatelliteInfo.QZSS

Quasi-Zenith Satellite System (Japan).

QGeoSatelliteInfo.Multiple

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

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.

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property satelliteIdentifierᅟ: int
Access functions:
property satelliteSystemᅟ: QGeoSatelliteInfo.SatelliteSystem
Access functions:
property signalStrengthᅟ: float
Access functions:
__init__()

Creates a satellite information object.

__init__(other)
Parameters:

otherQGeoSatelliteInfo

Creates a satellite information object with the values of other.

attribute(attribute)
Parameters:

attributeAttribute

Return type:

float

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

Returns -1 if the value has not been set.

hasAttribute(attribute)
Parameters:

attributeAttribute

Return type:

bool

Returns true if the specified attribute is present in this update.

__ne__(rhs)
Parameters:

rhsQGeoSatelliteInfo

Return type:

bool

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

__eq__(rhs)
Parameters:

rhsQGeoSatelliteInfo

Return type:

bool

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

removeAttribute(attribute)
Parameters:

attributeAttribute

Removes the specified attribute and its value.

satelliteIdentifier()
Return type:

int

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.

For example, if 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.

Note

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.

Getter of property satelliteIdentifierᅟ .

satelliteSystem()
Return type:

SatelliteSystem

Returns the Satellite System (GPS, GLONASS, …)

Note

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

Getter of property satelliteSystemᅟ .

setAttribute(attribute, value)
Parameters:

Sets the value for attribute to value.

See also

attribute()

setSatelliteIdentifier(satId)
Parameters:

satId – int

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.

For example, if 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.

setSatelliteSystem(system)
Parameters:

systemSatelliteSystem

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

setSignalStrength(signalStrength)
Parameters:

signalStrength – int

Sets the signal strength to signalStrength, in decibels.

See also

signalStrength()

signalStrength()
Return type:

int

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

swap(other)
Parameters:

otherQGeoSatelliteInfo