gnss
– Global Navigation Satellite System¶
The gnss
module contains classes to control the GNSS and acquire positioning information.
-
class
gnss.
GNSS
(system: Union[SatelliteSystem, List[SatelliteSystem]])¶ Get updated positioning information from Global Navigation Satellite System (GNSS)
Usage:
import gnss import time nav = gnss.GNSS([gnss.SatelliteSystem.GPS, gnss.SatelliteSystem.GLONASS]) last_print = time.monotonic() while True: nav.update() current = time.monotonic() if current - last_print >= 1.0: last_print = current if nav.fix is gnss.PositionFix.INVALID: print("Waiting for fix...") continue print("Latitude: {0:.6f} degrees".format(nav.latitude)) print("Longitude: {0:.6f} degrees".format(nav.longitude))
Turn on the GNSS.
- Parameters
system – satellite system to use
-
latitude
:float¶ Latitude of current position in degrees (float).
-
longitude
:float¶ Longitude of current position in degrees (float).
-
altitude
:float¶ Altitude of current position in meters (float).
-
timestamp
:time.struct_time¶ Time when the position data was updated.
-
fix
:PositionFix¶ Fix mode.
-
class
gnss.
PositionFix
¶ Position fix mode
Enum-like class to define the position fix mode.
-
INVALID
:PositionFix¶ No measurement.
-
FIX_2D
:PositionFix¶ 2D fix.
-
FIX_3D
:PositionFix¶ 3D fix.
-
-
class
gnss.
SatelliteSystem
¶ Satellite system type
Enum-like class to define the satellite system type.
-
GPS
:SatelliteSystem¶ Global Positioning System.
-
GLONASS
:SatelliteSystem¶ GLObal NAvigation Satellite System.
-
SBAS
:SatelliteSystem¶ Satellite Based Augmentation System.
-
QZSS_L1CA
:SatelliteSystem¶ Quasi-Zenith Satellite System L1C/A.
-
QZSS_L1S
:SatelliteSystem¶ Quasi-Zenith Satellite System L1S.
-