Windows.Devices.Geolocation Namespace
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Provides APIs for getting the current ___location or tracking the device's ___location over time. Location information may come from estimating a position from beacons like Wi-Fi access points and cell towers, from the device's IP address, or it may come from other sources such as a GNSS or GPS device. The Windows.Devices.Geolocation API provides the most appropriate geolocation data from all available sources.
The accuracy of the ___location information depends on the source. The latitude and longitude may vary within the following ranges:
- GPS : within approximately 10 meters
- Wi-Fi : between approximately 30 meters and 500 meters
- Cell towers : between approximately 300 meters and 3,000 meters
- IP address : between approximately 1,000 meters and 5,000 meters
In addition to latitude and longitude, GPS also provides information about heading, speed, and altitude. This additional information is optional when the ___location information comes from other sources.
The user sets the privacy of their ___location data with the ___location privacy settings in the Settings app. Your app can access the user's ___location only when:
- Location for this device... is turned on (not applicable to Windows 10 Mobile)
- The ___location services setting, Location, is turned on
- Under Choose apps that can use your ___location, your app is set to on
For more information about ___location privacy, see the Windows Privacy Statement.
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.
Location services architecture
The first layer of the ___location services architecture consists of hardware in the device. This includes the GPS receiver, Wi-Fi, and the cellular radio. These can all function as providers of ___location data with varying levels of accuracy and power consumption. On top of the hardware sits the native code layer. This layer communicates directly with the available sources of ___location data and decides which sources to use to determine the ___location of the device based on the availability of data and on the performance requirements specified by the application. The native code layer also communicates over the Internet with a Microsoft-hosted web service to look up ___location-related information from a database. The top layer of the ___location service is the managed interface, exposed through a DLL that is included with Windows SDK. An app uses this interface to start and stop ___location requests, to set the level of accuracy required by the app, and to receive ___location data from the native code layer as it becomes available.
Classes
| CivicAddress |
Unsupported API. |
| GeoboundingBox |
Represents a rectangle that defines a geographic area. |
| Geocircle |
Describes a geographic circle with a center point and a radius. |
| Geocoordinate |
Contains the information for identifying a geographic ___location. |
| GeocoordinateSatelliteData |
Provides additional information about a Geocoordinate. This information is only applicable to position estimates obtained using satellite signals. |
| Geolocator |
Provides access to the current geographic ___location. |
| Geopath |
Represents an ordered series of geographic points. |
| Geopoint |
Describes a geographic point. |
| Geoposition |
Represents a ___location that may contain latitude and longitude data or venue data. |
| Geovisit |
Represents a Visit-related state change. See Guidelines for using Visits tracking for information on how to use this feature. |
| GeovisitMonitor |
Handles the monitoring of a user's Visits when the app is in use (not in the background). |
| GeovisitStateChangedEventArgs |
Contains information about a VisitStateChanged event. |
| GeovisitTriggerDetails |
Manages the details of a trigger for a Visits-related background task. |
| PositionChangedEventArgs |
Provides data for the PositionChanged event. |
| StatusChangedEventArgs |
Provides information for the StatusChanged event. |
| VenueData |
Represents the venue associated with a geographic ___location. |
Structs
| BasicGeoposition |
The basic information to describe a geographic position. |
Interfaces
| IGeoshape |
Interface to define a geographic shape. |
Enums
| AltitudeReferenceSystem |
Indicates the altitude reference system to be used in defining a geographic shape. |
| GeolocationAccessStatus |
Indicates if your app has permission to access ___location data. |
| GeoshapeType |
Indicates the shape of a geographic region. |
| PositionAccuracy |
Indicates the requested accuracy level for the ___location data that the application uses. |
| PositionSource |
Indicates the source used to obtain a Geocoordinate. |
| PositionStatus |
Indicates the ability of the Geolocator object to provide ___location data. |
| VisitMonitoringScope |
Contains values that describe the intended scope of ___location monitoring for use with the Visits feature. |
| VisitStateChange |
Contains values that describe a Visit-related state change. |
Examples
Sample applications that use classes from this namespace include the Geolocation sample and the Geotag sample.