1// Copyright (C) 2022 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
5 \qmlvaluetype geoSatelliteInfo
7 \inqmlmodule QtPositioning
10 \brief The geoSatelliteInfo type represents basic information about a
13 This type is a QML representation of \l QGeoSatelliteInfo. The type is
14 uncreatable from QML and can only be used when handling satellite updates
15 from \l SatelliteSource.
17 This type contains the \c satelliteSystem, \c satelliteIdentifier and
18 \c signalStrength read-only properties, and also optional attributes.
20 Use the \l hasAttribute method to check if the attribute exists or not,
21 and the \l attribute method to get its value.
27 \qmlproperty enumeration QtPositioning::geoSatelliteInfo::satelliteSystem
30 Holds the GNSS system of the satellite.
32 \value GeoSatelliteInfo.Undefined Not defined.
33 \value GeoSatelliteInfo.GPS Global Positioning System (USA).
34 \value GeoSatelliteInfo.GLONASS Global Positioning System (Russia).
35 \value GeoSatelliteInfo.GALILEO Global navigation satellite system (EU).
36 \value GeoSatelliteInfo.BEIDOU BeiDou navigation satellite system (China).
37 \value GeoSatelliteInfo.QZSS Quasi-Zenith Satellite System (Japan).
38 \value GeoSatelliteInfo.Multiple This type normally indicates that the
39 information is received from a device that supports multiple
40 satellite systems, and the satellite system is not explicitly
42 \value GeoSatelliteInfo.CustomType The first type that can be used
47 \qmlproperty int QtPositioning::geoSatelliteInfo::satelliteIdentifier
50 Holds the satellite identifier number.
52 The satellite identifier number can be used to identify a satellite within
55 The actual value may vary, depending on the platform and the selected
60 \qmlproperty real QtPositioning::geoSatelliteInfo::signalStrength
63 Holds the signal strength in decibels.
67 \qmlmethod real QtPositioning::geoSatelliteInfo::attribute(Attribute attr)
69 Returns the value of the attribute \a attr or -1 if the value has not been
72 The following attributes are supported:
75 \li \c {GeoSatelliteInfo.Elevation} - the elevation of the satellite,
77 \li \c {GeoSatelliteInfo.Azimuth} - the azimuth to true north,
83 \qmlmethod bool QtPositioning::geoSatelliteInfo::hasAttribute(Attribute attr)
85 Returns \c true if the satellite information contains the attribute \a attr.
86 Otherwise returns \c false.
88 See \l attribute() for the list of supported attributes.