Geolocator.AllowFallbackToConsentlessPositions Method

Definition

Namespace:

Windows.Devices.Geolocation

Sets the Geolocator to use coarse location as a fallback option (see Remarks).

public:
 virtual void AllowFallbackToConsentlessPositions() = AllowFallbackToConsentlessPositions;

void AllowFallbackToConsentlessPositions();

public void AllowFallbackToConsentlessPositions();

function allowFallbackToConsentlessPositions()

Public Sub AllowFallbackToConsentlessPositions ()

Windows requirements

Device family	Windows 10 Anniversary Edition (introduced in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v3.0)
App capabilities	location

Remarks

The coarse location feature allows the app to bypass the app-specific location switch (located in system settings) and obtain a "rough" location that is obfuscated with at least a 4km radius of uncertainty. The PositionSource property of the retrieved Geocoordinate will evaluate to Obfuscated.

Coarse location, if enabled in the app, will be utilized when the app-specific location switch is set to off (that is, when precise location is not allowed). The system-wide location switch, however, must be still switched on in order for any location retrieval to take place.

This feature is enabled for any Geolocator object that calls AllowFallbackToConsentlessPositions. It is disabled by default.

Normally, an app that uses location services should first call RequestAccessAsync to check if its app-specific location is switched on, and if not, it should prompt the user to go to system settings and switch it on. However, an app that has coarse location capability does not need to call RequestAccessAsync, as it can function whether location access is allowed or denied. The user may still turn on the app-specific location in order to use precise location, but this is not needed for the app's location functionality to work.