Class QfPositioning
#include <qfpositioning.h>
Inherits the following classes: QObject
Public Properties
Public Signals
Public Functions
Detailed Description
This class manages the positioning source and offers positioning details.
Public Properties Documentation
property active [1/2]
bool QfPositioning::active;
property antennaHeight [1/2]
double QfPositioning::antennaHeight;
property averagedPosition [1/2]
bool QfPositioning::averagedPosition;
property averagedPositionCount [1/2]
int QfPositioning::averagedPositionCount;
property averagedPositionFilterAccuracy [1/2]
bool QfPositioning::averagedPositionFilterAccuracy;
property backgroundMode [1/2]
bool QfPositioning::backgroundMode;
property badAccuracyThreshold [1/2]
double QfPositioning::badAccuracyThreshold;
property coordinateTransformer [1/2]
QgsQuickCoordinateTransformer * QfPositioning::coordinateTransformer;
property deviceBatteryLevel [1/2]
double QfPositioning::deviceBatteryLevel;
property deviceCapabilities [1/2]
QfAbstractGnssReceiver::Capabilities QfPositioning::deviceCapabilities;
property deviceId [1/2]
QString QfPositioning::deviceId;
property deviceLastError [1/2]
QString QfPositioning::deviceLastError;
property deviceSocketState [1/2]
QAbstractSocket::SocketState QfPositioning::deviceSocketState;
property deviceSocketStateString [1/2]
QString QfPositioning::deviceSocketStateString;
property elevationCorrectionMode [1/2]
QfPositioningSource::ElevationCorrectionMode QfPositioning::elevationCorrectionMode;
property enableNtrip [1/2]
bool QfPositioning::enableNtrip;
property excellentAccuracyThreshold [1/2]
double QfPositioning::excellentAccuracyThreshold;
property logging [1/2]
bool QfPositioning::logging;
property loggingPath [1/2]
QString QfPositioning::loggingPath;
property ntripBytesReceived [1/2]
qint64 QfPositioning::ntripBytesReceived;
property ntripBytesSent [1/2]
qint64 QfPositioning::ntripBytesSent;
property ntripLastBytesReceivedUtcDateTime [1/2]
QDateTime QfPositioning::ntripLastBytesReceivedUtcDateTime;
property ntripSettings [1/2]
QfNtripSettings QfPositioning::ntripSettings;
property ntripState [1/2]
QfPositioningSource::NtripState QfPositioning::ntripState;
property orientation [1/2]
double QfPositioning::orientation;
property positionInformation [1/2]
QfGnssPositionInformation QfPositioning::positionInformation;
property projectedHorizontalAccuracy [1/2]
double QfPositioning::projectedHorizontalAccuracy;
property projectedPosition [1/2]
QgsPoint QfPositioning::projectedPosition;
property serviceMode [1/2]
bool QfPositioning::serviceMode;
property sourcePosition [1/2]
QgsPoint QfPositioning::sourcePosition;
property valid [1/2]
bool QfPositioning::valid;
Public Signals Documentation
signal activeChanged
void QfPositioning::activeChanged;
signal antennaHeightChanged
void QfPositioning::antennaHeightChanged;
signal averagedPositionChanged
void QfPositioning::averagedPositionChanged;
signal averagedPositionCountChanged
void QfPositioning::averagedPositionCountChanged;
signal averagedPositionFilterAccuracyChanged
void QfPositioning::averagedPositionFilterAccuracyChanged;
signal backgroundModeChanged
void QfPositioning::backgroundModeChanged;
signal badAccuracyThresholdChanged
void QfPositioning::badAccuracyThresholdChanged;
signal coordinateTransformerChanged
void QfPositioning::coordinateTransformerChanged;
signal deviceBatteryLevelChanged
void QfPositioning::deviceBatteryLevelChanged;
signal deviceChanged
void QfPositioning::deviceChanged;
signal deviceIdChanged
void QfPositioning::deviceIdChanged;
signal deviceLastErrorChanged
void QfPositioning::deviceLastErrorChanged;
signal deviceSocketStateChanged
void QfPositioning::deviceSocketStateChanged;
signal deviceSocketStateStringChanged
void QfPositioning::deviceSocketStateStringChanged;
signal elevationCorrectionModeChanged
void QfPositioning::elevationCorrectionModeChanged;
signal enableNtripChanged
void QfPositioning::enableNtripChanged;
signal excellentAccuracyThresholdChanged
void QfPositioning::excellentAccuracyThresholdChanged;
signal loggingChanged
void QfPositioning::loggingChanged;
signal loggingPathChanged
void QfPositioning::loggingPathChanged;
signal ntripBytesReceivedChanged
void QfPositioning::ntripBytesReceivedChanged;
signal ntripBytesSentChanged
void QfPositioning::ntripBytesSentChanged;
signal ntripLastBytesReceivedUtcDateTimeChanged
void QfPositioning::ntripLastBytesReceivedUtcDateTimeChanged;
signal ntripSettingsChanged
void QfPositioning::ntripSettingsChanged;
signal ntripStateChanged
void QfPositioning::ntripStateChanged;
signal orientationChanged
void QfPositioning::orientationChanged;
signal positionInformationChanged
void QfPositioning::positionInformationChanged;
signal projectedPositionChanged
void QfPositioning::projectedPositionChanged;
signal serviceModeChanged
void QfPositioning::serviceModeChanged;
signal triggerConnectDevice
void QfPositioning::triggerConnectDevice;
signal triggerDisconnectDevice
void QfPositioning::triggerDisconnectDevice;
signal validChanged
void QfPositioning::validChanged;
Public Functions Documentation
function QfPositioning
explicit QfPositioning::QfPositioning (
QObject * parent=nullptr
)
function active [2/2]
bool QfPositioning::active () const
Returns TRUE when positioning is active.
See also: setActive
function antennaHeight [2/2]
double QfPositioning::antennaHeight () const
Sets the GNSS device antenna height. This should be the pole height + sensore phase height.
Note:
When IMU is active this value is ignored as the device does the correction internally.
function averagedPosition [2/2]
bool QfPositioning::averagedPosition () const
Returns whether the position information is averaged from an ongoing stream of incoming positions from the device.
function averagedPositionCount [2/2]
int QfPositioning::averagedPositionCount () const
Returns the current number of collected position informations from which the averaged position is calculated.
Note:
When averaged position is off, the value is zero.
function averagedPositionFilterAccuracy [2/2]
bool QfPositioning::averagedPositionFilterAccuracy () const
Returns whether the average position filter accuracy is enabled.
function backgroundMode [2/2]
bool QfPositioning::backgroundMode () const
Returns TRUE if the background mode is active. When activated, position information details will not be signaled but instead saved to disk until deactivated.
See also: getBackgroundPositionInformation()
function badAccuracyThreshold [2/2]
inline double QfPositioning::badAccuracyThreshold () const
Returns the threshold above which accuracy is considered bad.
function coordinateTransformer [2/2]
inline QgsQuickCoordinateTransformer * QfPositioning::coordinateTransformer () const
Returns the coordinate transformer object used to reproject the position location.
function deviceBatteryLevel [2/2]
double QfPositioning::deviceBatteryLevel () const
Returns the device current battery level as a 0.0 to 1.0 double range.
function deviceCapabilities [2/2]
QfAbstractGnssReceiver::Capabilities QfPositioning::deviceCapabilities () const
function deviceDetails
QfGnssPositionDetails QfPositioning::deviceDetails () const
Returns extra details (such as hdop, vdop, pdop) provided by the positioning device.
function deviceId [2/2]
QString QfPositioning::deviceId () const
Returns the current positioning device id used to fetch position information.
See also: setDevice
function deviceLastError [2/2]
QString QfPositioning::deviceLastError () const
Returns positioning device's last error string.
function deviceSocketState [2/2]
QAbstractSocket::SocketState QfPositioning::deviceSocketState () const
Returns positioning device's socket state.
See also: deviceSocketStateString
function deviceSocketStateString [2/2]
QString QfPositioning::deviceSocketStateString () const
Returns a string representation of the positioning device's socket state.
See also: deviceSocketState
function elevationCorrectionMode [2/2]
QfPositioningSource::ElevationCorrectionMode QfPositioning::elevationCorrectionMode () const
Returns the current elevation correction mode.
Note:
Some modes depends on device capabilities.
function enableNtrip [2/2]
bool QfPositioning::enableNtrip () const
Returns TRUE if the NTRIP client is enabled.
function excellentAccuracyThreshold [2/2]
inline double QfPositioning::excellentAccuracyThreshold () const
Returns the threshold below which accuracy is considered excellent.
function getBackgroundPositionInformation
Q_INVOKABLE QList< QfGnssPositionInformation > QfPositioning::getBackgroundPositionInformation () const
Returns a list of position information collected while background mode is active.
See also: backgroundMode()
See also: setBackgroundMode()
function logging [2/2]
bool QfPositioning::logging () const
Returns whether GNSS devices will log their incoming position stream into a logfile.
Note:
Requires a device type with logging capability
function loggingPath [2/2]
QString QfPositioning::loggingPath () const
Returns the path where GNSS devices will log their incoming position stream into logfiles.
Note:
Requires a device type with logging capability
function ntripBytesReceived [2/2]
qint64 QfPositioning::ntripBytesReceived () const
Returns the number of bytes received via NTRIP.
function ntripBytesSent [2/2]
qint64 QfPositioning::ntripBytesSent () const
Returns the number of bytes sent via NTRIP.
function ntripLastBytesReceivedUtcDateTime [2/2]
QDateTime QfPositioning::ntripLastBytesReceivedUtcDateTime () const
Returns the last received bytes time in UTC.
function ntripSettings [2/2]
QfNtripSettings QfPositioning::ntripSettings () const
Returns the NTRIP settings.
function ntripState [2/2]
QfPositioningSource::NtripState QfPositioning::ntripState () const
Returns the current NTRIP connection status.
function orientation [2/2]
double QfPositioning::orientation () const
Returns the current device orientation
function positionInformation [2/2]
QfGnssPositionInformation QfPositioning::positionInformation () const
Returns a QfGnssPositionInformation position information object.
function projectedHorizontalAccuracy [2/2]
double QfPositioning::projectedHorizontalAccuracy () const
Returns the position horizontal accuracy in the destination CRS' map units.
function projectedPosition [2/2]
QgsPoint QfPositioning::projectedPosition () const
Returns the position point in its destination CRS defined in the coordinate transformer.
function serviceMode [2/2]
bool QfPositioning::serviceMode () const
Returns TRUE if the service mode is active. On supported platform, positioning runs into a dedicated service that is not suspended when devices are locked or the application is put suspended.
See also: setServiceMode()
function setActive
void QfPositioning::setActive (
bool active
)
Sets the positioning active status.
See also: active
function setAntennaHeight
void QfPositioning::setAntennaHeight (
double antennaHeight
)
Returns the GNSS device antenna height. This should be the pole height + sensore phase height.
Note:
When IMU is active this value is ignored as the device does the correction internally.
function setAveragedPosition
void QfPositioning::setAveragedPosition (
bool averaged
)
Sets whether the position information is averaged from an ongoing stream of incoming positions from the device.
function setAveragedPositionFilterAccuracy
void QfPositioning::setAveragedPositionFilterAccuracy (
bool enabled
)
Enables or disables the average position filter accuracy.
function setBackgroundMode
void QfPositioning::setBackgroundMode (
bool enabled
)
Sets whether the background mode is active. When activated, position information details will not be signaled but instead saved to disk until deactivated.
See also: getBackgroundPositionInformation()
function setBadAccuracyThreshold
void QfPositioning::setBadAccuracyThreshold (
double threshold
)
Sets the threshold above which accuracy is considered bad.
function setCoordinateTransformer
void QfPositioning::setCoordinateTransformer (
QgsQuickCoordinateTransformer * coordinateTransformer
)
Sets the coordinate transformer object used to reproject the position location.
Parameters:
coordinateTransformerA QgsQuickCoordinateTransformer object.
function setDeviceId
void QfPositioning::setDeviceId (
const QString & id
)
Sets the positioning device id used to fetch position information.
Note:
A blank string will connect the internal positioning device; bluetooth addresses will trigger an NMEA connection to external devices.
function setElevationCorrectionMode
void QfPositioning::setElevationCorrectionMode (
QfPositioningSource::ElevationCorrectionMode elevationCorrectionMode
)
Sets the current elevation correction mode.
Note:
Some modes depends on device capabilities.
function setEnableNtrip
void QfPositioning::setEnableNtrip (
bool enableNtrip
)
Sets whether the NTRIP client is enabled.
function setExcellentAccuracyThreshold
void QfPositioning::setExcellentAccuracyThreshold (
double threshold
)
Sets the threshold below which accuracy is considered excellent.
function setLogging
void QfPositioning::setLogging (
bool logging
)
Sets whether GNSS devices will log their incoming position stream into a logfile.
Note:
Requires a device type with logging capability
function setLoggingPath
void QfPositioning::setLoggingPath (
const QString & path
)
Sets the path where GNSS devices will log their incoming position stream into logfiles.
Note:
Requires a device type with logging capability
function setNtripSettings
void QfPositioning::setNtripSettings (
const QfNtripSettings & ntripSettings
)
Sets the NTRIP settings.
function setServiceMode
void QfPositioning::setServiceMode (
bool enabled
)
Sets whether the service mode is active. On supported platform, positioning runs into a dedicated service that is not suspended when devices are locked or the application is put suspended.
See also: serviceMode()
function setValid
void QfPositioning::setValid (
bool valid
)
Sets whether the positioning device is valid.
function sourcePosition [2/2]
QgsPoint QfPositioning::sourcePosition () const
Returns the position point in its original WGS84 projection.
function valid [2/2]
bool QfPositioning::valid () const
Returns TRUE when the positioning device is valid.
function ~QfPositioning
virtual QfPositioning::~QfPositioning () = default
The documentation for this class was generated from the following file src/core/positioning/qfpositioning.h