Windows.Devices.Geolocation Espacio de nombres
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona API para obtener la ubicación actual o realizar el seguimiento de la ubicación del dispositivo a lo largo del tiempo. La información de ubicación puede provenir de la estimación de una posición de balizas como Wi-Fi puntos de acceso y torres de celdas, desde la dirección IP del dispositivo o puede provenir de otros orígenes como un dispositivo GNSS o GPS. La API Windows.Devices.Geolocation proporciona los datos de geolocalización más adecuados de todos los orígenes disponibles.
La precisión de la información de ubicación depende del origen. La latitud y longitud pueden variar dentro de los intervalos siguientes:
- GPS: dentro de aproximadamente 10 metros
- Wi-Fi: entre aproximadamente 30 metros y 500 metros
- Torres de celdas: entre aproximadamente 300 metros y 3.000 metros
- Dirección IP: entre aproximadamente 1.000 metros y 5.000 metros
Además de la latitud y longitud, GPS también proporciona información sobre el encabezado, la velocidad y la altitud. Esta información adicional es opcional cuando la información de ubicación procede de otros orígenes.
El usuario establece la privacidad de sus datos de ubicación con la configuración de privacidad de ubicación en la aplicación Configuración. La aplicación puede acceder a la ubicación del usuario solo cuando:
- Ubicación para este dispositivo... está activado (no aplicable a Windows 10 Mobile)
- La configuración de servicios de ubicación, "Ubicación", está activada
- En Elegir las aplicaciones que pueden usar tu ubicación, la aplicación está establecida en el valor activado
Para obtener más información sobre la privacidad de la ubicación, consulta la Declaración de privacidad de Windows.
Importante
A partir de Windows 10, llame a RequestAccessAsync antes de acceder a la ubicación del usuario. En ese momento, la aplicación debe estar en primer plano y se debe llamar a RequestAccessAsync desde el subproceso de la interfaz de usuario. La aplicación no puede tener acceso a los datos de ubicación hasta que el usuario conceda permiso.
Arquitectura de servicios de ubicación
La primera capa de la arquitectura de servicios de ubicación consta de hardware en el dispositivo. Esto incluye el receptor GPS, Wi-Fi y la radio celular. Todas ellas pueden funcionar como proveedores de datos de ubicación con distintos niveles de precisión y consumo de energía. En la parte superior del hardware se encuentra la capa de código nativa. Esta capa se comunica directamente con los orígenes disponibles de datos de ubicación y decide qué orígenes usar para determinar la ubicación del dispositivo en función de la disponibilidad de los datos y de los requisitos de rendimiento especificados por la aplicación. La capa de código nativa también se comunica a través de Internet con un servicio web hospedado por Microsoft para buscar información relacionada con la ubicación de una base de datos. La capa superior del servicio de ubicación es la interfaz administrada, expuesta a través de un archivo DLL que se incluye con Windows SDK. Una aplicación usa esta interfaz para iniciar y detener las solicitudes de ubicación, para establecer el nivel de precisión requerido por la aplicación y para recibir datos de ubicación de la capa de código nativo a medida que esté disponible.
Clases
CivicAddress |
API no admitida. |
GeoboundingBox |
Representa un rectángulo que define un área geográfica. |
Geocircle |
Describe un círculo geográfico con un punto central y un radio. |
Geocoordinate |
Contiene la información para identificar una ubicación geográfica. |
GeocoordinateSatelliteData |
Proporciona información adicional sobre una geocoordinación. Esta información solo es aplicable a las estimaciones de posición obtenidas mediante señales de satélite. |
Geolocator |
Proporciona acceso a la ubicación geográfica actual. |
Geopath |
Representa una serie ordenada de puntos geográficos. |
Geopoint |
Describe un punto geográfico. |
Geoposition |
Representa una ubicación que puede contener datos de latitud y longitud o datos de ubicación. |
Geovisit |
Representa un cambio de estado relacionado con la visita. Consulte Directrices para usar el seguimiento de visitas para obtener información sobre cómo usar esta característica. |
GeovisitMonitor |
Controla la supervisión de las visitas de un usuario cuando la aplicación está en uso (no en segundo plano). |
GeovisitStateChangedEventArgs |
Contiene información sobre un evento VisitStateChanged . |
GeovisitTriggerDetails |
Administra los detalles de un desencadenador para una tarea en segundo plano relacionada con visitas. |
PositionChangedEventArgs |
Proporciona datos para el evento PositionChanged . |
StatusChangedEventArgs |
Proporciona información para el evento StatusChanged . |
VenueData |
Representa el lugar asociado a una ubicación geográfica. |
Estructuras
BasicGeoposition |
Información básica para describir una posición geográfica. |
Interfaces
IGeoshape |
Interfaz para definir una forma geográfica. |
Enumeraciones
AltitudeReferenceSystem |
Indica el sistema de referencia de altitud que se va a usar para definir una forma geográfica. |
GeolocationAccessStatus |
Indica si la aplicación tiene permiso para acceder a los datos de ubicación. |
GeoshapeType |
Indica la forma de una región geográfica. |
PositionAccuracy |
Indica el nivel de precisión solicitado para los datos de ubicación que usa la aplicación. |
PositionSource |
Indica el origen utilizado para obtener una geocoordinada. |
PositionStatus |
Indica la capacidad del objeto Geolocator para proporcionar datos de ubicación. |
VisitMonitoringScope |
Contiene valores que describen el ámbito previsto de la supervisión de ubicación para su uso con la característica Visitas. |
VisitStateChange |
Contiene valores que describen un cambio de estado relacionado con Visit. |
Ejemplos
Las aplicaciones de ejemplo que usan clases de este espacio de nombres incluyen el ejemplo geolocalización y el ejemplo de Geotag.