WeatherDataProvider, weather service manager. More...

#include <WeatherDataProvider.h>

Signals
void	downloadingChanged ()
	Notifier signal.

void	error (QString message)
	Signal emitted when a network error occurs.

void	QNHInfoChanged ()
	Notifier signal.

void	sunInfoChanged ()
	Notifier signal.

Public Member Functions
	WeatherDataProvider (QObject *parent=nullptr)
	Standard constructor.

bool	downloading () const
	Getter method for property of the same name.

QMap< QString, Weather::METAR >	METARs ()
	Getter method for property of the same name.

QBindable< QMap< QString, Weather::METAR > >	bindableMETARs ()
	Getter method for property of the same name.

Units::Pressure	QNH () const
	Getter method for property of the same name.

Units::Distance	QNHPressureAltitude () const
	Getter method for property of the same name.

QString	QNHInfo () const
	Getter method for property of the same name.

QMap< QString, Weather::TAF >	TAFs ()
	Getter method for property of the same name.

QBindable< QMap< QString, Weather::TAF > >	bindableTAFs ()
	Getter method for property of the same name.

Q_INVOKABLE void	requestUpdate ()
	Request update.

Q_INVOKABLE void	requestUpdate4Waypoint (const GeoMaps::Waypoint &wp)
	Request update.

Static Public Member Functions
static QString	sunInfo ()
	Getter method for property of the same name.

Properties
bool	downloading
	Downloading flag.

Units::Pressure	QNH
	QNH.

Units::Distance	QNHPressureAltitude
	QNHPressureAltitude.

QString	QNHInfo
	QNHInfo.

QString	sunInfo
	sunInfo

QMap< QString, Weather::METAR >	METARs
	List of METARs.

QMap< QString, Weather::TAF >	TAFs
	List of TAFs.

Detailed Description

WeatherDataProvider, weather service manager.

This class retrieves METAR/TAF weather reports from the server enroute-data.

Once constructed, the WeatherDataProvider class will regularly perform background updates to retrieve up-to-date information for a region around the current position and around the intended flight route. The class checks regularly for outdated METAR and TAF and deletes them automatically.

In order to avoid loss of data when the app is accidently closed in-flight, the class stores all weather data at destruction and at regular intervals, and reads the data back in on construction.

This class also contains a number or convenience methods and properties pertaining to sunrise and sunset.

Definition at line 54 of file WeatherDataProvider.h.

Constructor & Destructor Documentation

◆ WeatherDataProvider()

Weather::WeatherDataProvider::WeatherDataProvider ( QObject * parent = nullptr )

explicit

Standard constructor.

Parameters

parent The standard QObject parent pointer

Member Function Documentation

◆ bindableMETARs()

QBindable< QMap< QString, Weather::METAR > > Weather::WeatherDataProvider::bindableMETARs ( )

inline

Getter method for property of the same name.

Returns: Property METARs

Definition at line 150 of file WeatherDataProvider.h.

◆ bindableTAFs()

QBindable< QMap< QString, Weather::TAF > > Weather::WeatherDataProvider::bindableTAFs ( )

inline

Getter method for property of the same name.

Returns: Property TAFs

Definition at line 186 of file WeatherDataProvider.h.

◆ downloading()

bool Weather::WeatherDataProvider::downloading ( ) const

nodiscard

Getter method for property of the same name.

Returns: Property downloading

◆ error

void Weather::WeatherDataProvider::error ( QString message )

signal

Signal emitted when a network error occurs.

This signal is emitted to indicate that the WeatherDataProvider failed to download weather data.

Parameters

message A human-readable, translated error message

◆ METARs()

QMap< QString, Weather::METAR > Weather::WeatherDataProvider::METARs ( )

inline

Getter method for property of the same name.

Returns: Property METARs

Definition at line 144 of file WeatherDataProvider.h.

◆ QNH()

Units::Pressure Weather::WeatherDataProvider::QNH ( ) const

nodiscard

Getter method for property of the same name.

Returns: Property QNH

◆ QNHInfo()

QString Weather::WeatherDataProvider::QNHInfo ( ) const

nodiscard

Getter method for property of the same name.

Returns: Property QNHInfo

◆ QNHPressureAltitude()

Units::Distance Weather::WeatherDataProvider::QNHPressureAltitude ( ) const

inlinenodiscard

Getter method for property of the same name.

Returns: Property QNHPressureAltitude

Definition at line 162 of file WeatherDataProvider.h.

◆ requestUpdate()

Q_INVOKABLE void Weather::WeatherDataProvider::requestUpdate ( )

Request update.

This method initiates the asynchronous download of weather information from the internet, for a region around the current position and around the current flight route. This method quits immediately if data for that region has been downloaded successfully less than five minutes ago.

If an error occurred while downloading, the signal "error" will be emitted.

◆ requestUpdate4Waypoint()

Q_INVOKABLE void Weather::WeatherDataProvider::requestUpdate4Waypoint ( const GeoMaps::Waypoint & wp )

Request update.

This method initiates the asynchronous download of weather information from the internet, for a region around the waypoint. This method quits immediately if data for that region is available or if the waypoint does not describe an airfield with METAR/TAF station.

If an error occurred while downloading, the signal "error" will be emitted.

Parameters

wp Waypoint

◆ sunInfo()

static QString Weather::WeatherDataProvider::sunInfo ( )

static

Getter method for property of the same name.

Returns: Property sunInfo

◆ TAFs()

QMap< QString, Weather::TAF > Weather::WeatherDataProvider::TAFs ( )

inline

Getter method for property of the same name.

Returns: Property TAFs

Definition at line 180 of file WeatherDataProvider.h.

Property Documentation

◆ downloading

bool Weather::WeatherDataProvider::downloading

read

Downloading flag.

Indicates that the WeatherDataProvider is currently downloading METAR/TAF information from the internet.

Definition at line 89 of file WeatherDataProvider.h.

◆ QNH

Units::Pressure Weather::WeatherDataProvider::QNH

read

QNH.

This property holds the QNH of the next airfield, if known. If no QNH is known, this property holds QNaN.

Definition at line 96 of file WeatherDataProvider.h.

◆ QNHInfo

QString Weather::WeatherDataProvider::QNHInfo

read

QNHInfo.

This property holds a human-readable, translated, rich-text string with information about the QNH of the nearest weather station. This could typically read like "QNH: 1019 hPa in LFGA, 4min ago". If no information is available, the property holds an empty string.

Definition at line 112 of file WeatherDataProvider.h.

◆ QNHPressureAltitude

Units::Distance Weather::WeatherDataProvider::QNHPressureAltitude

read

QNHPressureAltitude.

This property holds the altitude in the standard atmosphere which corresponds to the current QNH value

Definition at line 103 of file WeatherDataProvider.h.

◆ sunInfo

QString Weather::WeatherDataProvider::sunInfo

read

sunInfo

This property holds a human-readable, translated, rich-text string with information about the next sunset or sunrise at the current position. This could typically read like "SS 17:01, in 3h and 5min" or "Waiting for exact position …"

Definition at line 121 of file WeatherDataProvider.h.

The documentation for this class was generated from the following file:

/home/runner/work/enroute/enroute/src/weather/WeatherDataProvider.h

Signals

Public Member Functions

Static Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ WeatherDataProvider()

Member Function Documentation

◆ bindableMETARs()

◆ bindableTAFs()

◆ downloading()

◆ error

◆ METARs()

◆ QNH()

◆ QNHInfo()

◆ QNHPressureAltitude()

◆ requestUpdate()

◆ requestUpdate4Waypoint()

◆ sunInfo()

◆ TAFs()

Property Documentation

◆ downloading

◆ QNH

◆ QNHInfo

◆ QNHPressureAltitude

◆ sunInfo