PositionStatus PositionStatus PositionStatus PositionStatus Enum

Indicates the ability of the Geolocator object to provide location data.

Syntax

Declaration

public enum PositionStatuspublic enum PositionStatusPublic Enum PositionStatus

Fields

Disabled
Disabled
Disabled
Disabled

Location settings are turned off. This status indicates that the user has not granted the application permission to access location.

Initializing
Initializing
Initializing
Initializing

Location services is initializing. This is the status if a GPS is the source of location data and the GPS receiver does not yet have the required number of satellites in view to obtain an accurate position.

NoData
NoData
NoData
NoData

No location data is available from any source. LocationStatus will have this value if the application calls GetGeopositionAsync() or registers an event handler for the PositionChanged event, before data is available from a location sensor. Once data is available LocationStatus transitions to the Ready state.

NotAvailable
NotAvailable
NotAvailable
NotAvailable

Location services is not available on this version of Windows.

NotInitialized
NotInitialized
NotInitialized
NotInitialized

An operation to retrieve location has not yet been initialized. LocationStatus will have this value if the application has not yet called GetGeopositionAsync() or registered an event handler for the PositionChanged event. LocationStatus may also have this value if your app doesn’t have permission to access location.

Important

Starting in Windows 10, call the RequestAccessAsync() before accessing the user’s location. At that time, your app must be in the foreground and RequestAccessAsync must be called from the UI thread. Until the user grants your app permission to their location, your app can't access location data.

Ready
Ready
Ready
Ready

Location data is available.

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Capabilities

location
ID_CAP_LOCATION [Windows Phone]

Attributes

Windows.Foundation.Metadata.ContractVersionAttribute

Details

Assembly

Windows.Devices.Geolocation.dll