Compartir a través de


Windows.Devices.Geolocation Espacio de nombres

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.

Consulte también