CONFIG += link_pkgconfig
 PKGCONFIG += sailfishmdm

 #include <mdm-location.h>
 void enableOrDisableGps(bool enable, QObject *parent)
 {
     Sailfish::Mdm::LocationSettings *settings = new Sailfish::Mdm::LocationSettings(parent);
     settings->setGpsEnabled(enable);
     settings->setGpsFlightMode(!enable);
     settings->setLocationEnabled(enable);
 }

Member Function Documentation

LocationSettings::LocationSettings(QObject *parent = Q_NULLPTR)

Default constructs an instance of LocationSettings.

LocationSettings::LocationSettings(Mode mode, QObject *parent = Q_NULLPTR)

Default constructs an instance of LocationSettings.

bool LocationSettings::agpsAgreementAccepted(const QString &agpsProvider) const

Returns true if the usage terms agreement with the aGPS provider whose name matches the given agpsProvider name has been accepted.

See also setAgpsAgreementAccepted().

bool LocationSettings::agpsAvailable(const QString &agpsProvider) const

Returns true if the device has an aGPS provider whose name matches the given agpsProvider name.

Agps provider can be, for example, "here" or "mls" (Mozilla Location Services).

bool LocationSettings::agpsEnabled(const QString &agpsProvider) const

Returns true if the aGPS provider whose name matches the given agpsProvider name is enabled.

If the aGPS provider is enabled and positioning is globally enabled (as reported by locationEnabled()) then the aGPS provider will provide position updates to clients.

Note that if the aGPS provider is enabled but positioning is globally disabled (as reported by locationEnabled()) then the aGPS provider will NOT provide any position updates, nor attempt to communicate with the aGPS backend services, just as if the aGPS provider was itself disabled.

See also setAgpsEnabled().

void LocationSettings::allowDataSource(DataSource dataSource)

Allows the client to allow the device to use the specified dataSource to determine its location.

QStringList LocationSettings::availableAgpsProviders() const

Returns the names of known network location providers and device-local location assistance providers which are available on the device.

void LocationSettings::disallowDataSource(DataSource dataSource)

Allows the client to disallow the device from using the specified dataSource to determine its location.

bool LocationSettings::gpsFlightMode() const

Returns true if the GPS hardware is currently powered off due to Flight Mode.

Note that if the GPS is powered off due to Flight Mode, then the GPS provider will NOT provide any position updates, and the GPS hardware will be turned off.

See also setGpsFlightMode().

[signal] void LocationSettings::gpsFlightModeChanged()

This signal is emitted if the GPS hardware should be powered off due to flight mode, or if it can be powered on due to flight mode being disabled or due to the user explicitly allowing the GPS to be used even in flight mode.

void LocationSettings::setAgpsAgreementAccepted(const QString &agpsProvider, bool value)

Allows the client to accept or revoke the usage terms agreement with the aGPS provider whose name matches the given agpsProvider name, depending on the given acceptance value.

See also agpsAgreementAccepted().

void LocationSettings::setAgpsEnabled(const QString &agpsProvider, bool value)

Allows the client to enable or disable the aGPS provider whose name matches the given agpsProvider name, depending on the given enablement value.

Note that this method allows the MDM client to enable or disable aGPS providers, but doesn't prevent these settings from being changed via e.g. the settings UI. In order to prevent the value from being changed by the user, the MDM client should also set the policy for this setting via the libsailfishpolicy API.

See also agpsEnabled().

void LocationSettings::setGpsFlightMode(bool value)

Allows the client to set the Flight Mode state of the GPS hardware to value.

Note that this method allows the MDM client to set the GPS flight mode state, but doesn't prevent this setting from being changed via e.g. the settings UI. In order to prevent the value from being changed by the user, the MDM client should also set the policy for this setting via the libsailfishpolicy API.

See also gpsFlightMode().