Windows.Devices.Geolocation.Geofencing Espacio de nombres

Una geovalla es un área virtual alrededor de un punto geográfico. Las API de geovalla permiten a las aplicaciones proporcionar experiencias contextuales geográficamente de forma oportuna sin necesidad de que la aplicación se ejecute continuamente y consuma recursos de dispositivo. La geovalla permite escenarios como mostrar un recordatorio para un usuario cuando abandonan el trabajo o casa o muestran cupones cuando el usuario se encuentra dentro de un intervalo de una tienda.

Las aplicaciones definen áreas de interés (geovallas) y las condiciones de desencadenador correspondientes, como el desencadenador cuando el usuario entra o sale de la geovalla. Por último, la aplicación se registra para recibir una notificación cuando se cumplen las condiciones del desencadenador. Windows y Windows Phone admiten cientos de geovallas por aplicación. El sistema operativo administra eficazmente el seguimiento de geovalla para todas las aplicaciones. Cuando se cumplen las condiciones del desencadenador para una o varias geovallas, se alerta a la aplicación asociada incluso cuando no se está ejecutando activamente. Este sistema de seguimiento de geovalla adaptable, compatible con la potencia y alta capacidad le permite agregar rápidamente y fácilmente la funcionalidad desencadenada por la ubicación a la aplicación.

Para obtener una guía completa sobre el uso de geovallas, consulte Geovalla, empezar a finalizar.

Las API de geovalla permiten que la aplicación haga lo siguiente:

• Cree una o varias geovallas o áreas de interés.
• Solicite recibir una notificación cuando el dispositivo entre en una geovalla.
• Solicite recibir una notificación cuando el dispositivo salga de una geovalla.
• Especifique un período de tiempo durante el que la geovalla está activa.
• Especifique un tiempo de permanencia para cada geovalla: la cantidad de tiempo que el dispositivo debe estar dentro o fuera de la geovalla antes de que se desencadene la notificación.
• Agregue y quite dinámicamente una geovalla de la colección de geovallas supervisadas de la aplicación.
• Recibir eventos de geovalla mientras la aplicación está activa.
• Regístrese con el sistema para que se inicie una tarea en segundo plano cuando cambie el estado de una de las geovallas de la aplicación. Las aplicaciones deben llamar a RequestAccessAsync antes de que se ejecuten las tareas en segundo plano.
• Use el simulador para simular el movimiento de dispositivos y probar las características de geovalla de la aplicación.

Si quieres que la aplicación se inicie en segundo plano cuando se cumpla la condición de desencadenador para una de sus geovallas, debes usar una tarea en segundo plano y configurar un LocationTrigger para iniciarla.

Importante

A partir de Windows 10, llame al método RequestAccessAsync del objeto Geolocator 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. Hasta que el usuario conceda permiso a la aplicación para acceder a su ubicación, la aplicación no puede acceder a los datos de ubicación.

Clases

Geofence	Contiene la funcionalidad para definir una geovalla (un área geográfica de interés) que se va a supervisar.
GeofenceMonitor	Contiene la información sobre los objetos geovalla supervisados.
GeofenceStateChangeReport	Contiene la información sobre los cambios de estado de una geovalla.

Enumeraciones

GeofenceMonitorStatus	Indica el estado actual de un GeofenceMonitor.
GeofenceRemovalReason	Indica el motivo por el que se quitó una geovalla .
GeofenceState	Indica el estado actual de una geovalla.
MonitoredGeofenceStates	Indica el estado o los estados de las geovallas que está supervisando actualmente el sistema.

Comentarios

Los servicios de ubicación deben ejecutarse para que funcione la geovalla. Si este servicio está deshabilitado, se producirá un error en las llamadas de geovalla y se producirá una excepción.

La aplicación debe declarar la funcionalidad de ubicación en el manifiesto de la aplicación para usar la geovalla.