Windows.Devices.Geolocation.Geofencing Espace de noms

Une limite géographique est une zone virtuelle autour d’un point géographique. Les API de géofencing permettent aux applications de fournir des expériences géographiquement contextuelles en temps opportun sans que l’application soit en cours d’exécution et consomme des ressources d’appareil en continu. Le géofencing permet des scénarios tels que l’affichage d’un rappel pour un utilisateur lorsqu’il quitte le travail ou la maison ou l’affichage de coupons lorsque l’utilisateur se trouve dans la plage d’un magasin.

Les applications définissent les zones d’intérêt (limites géographiques) et les conditions de déclencheur correspondantes, telles que le déclenchement lorsque l’utilisateur entre ou quitte la limite géographique. Enfin, l’application s’inscrit pour être avertie lorsque les conditions du déclencheur sont remplies. Windows et Windows Phone prennent en charge des centaines de limites géographiques par application. Le système d’exploitation gère efficacement le suivi des limites géographiques pour toutes les applications. Lorsque les conditions de déclenchement d’une ou plusieurs limites géographiques sont remplies, l’application associée est alertée même lorsqu’elle n’est pas en cours d’exécution active. Ce système de suivi de la géoréférence adaptative, à haute capacité, prenant en charge l’alimentation, vous permet d’ajouter rapidement et facilement des fonctionnalités déclenchées par l’emplacement à votre application.

Pour obtenir un guide complet sur l’utilisation de la géofencing, consultez Geofencing, start to finish.

Les API de géofencing permettent à votre application d’effectuer les opérations suivantes :

  • Créez une ou plusieurs limites géographiques, ou zones d’intérêt.
  • Demander à être averti lorsque l’appareil entre dans une limite géographique.
  • Demander à être averti lorsque l’appareil quitte une limite géographique.
  • Spécifiez une fenêtre de temps pendant laquelle la limite géographique est active.
  • Spécifiez une durée d’attente pour chaque limite géographique : la durée pendant laquelle l’appareil doit être dans ou hors de la limite géographique avant le déclenchement de la notification.
  • Ajoutez et supprimez dynamiquement des limites géographiques de la collection de limites géographiques surveillées de votre application.
  • Recevoir des événements de limite géographique pendant que l’application est active.
  • Inscrivez-vous auprès du système pour qu’une tâche en arrière-plan soit lancée lorsque l’état de l’une des limites géographiques de votre application change. Les applications doivent appeler RequestAccessAsync avant que les tâches en arrière-plan ne s’exécutent.
  • Utilisez le simulateur pour simuler le déplacement de l’appareil et tester les fonctionnalités de géofendage de votre application.

Si vous souhaitez que votre application soit lancée en arrière-plan lorsque la condition de déclencheur pour l’une de ses limites géographiques est remplie, vous devez utiliser une tâche en arrière-plan et configurer un LocationTrigger pour la lancer.

Important

À compter de Windows 10, appelez la méthode RequestAccessAsync de l’objet Geolocator avant d’accéder à l’emplacement de l’utilisateur. À ce stade, votre application doit être au premier plan et l’élément RequestAccessAsync doit être appelé à partir du thread d’interface utilisateur. Tant que l’utilisateur n’a pas accordé à votre application l’autorisation d’accéder à son emplacement, votre application ne peut pas accéder aux données de localisation.

Classes

Geofence

Contient la fonctionnalité permettant de définir une limite géographique (zone géographique d’intérêt) à surveiller.

GeofenceMonitor

Contient les informations sur les objets geofence surveillés.

GeofenceStateChangeReport

Contient les informations sur les modifications d’état d’une limite géographique.

Énumérations

GeofenceMonitorStatus

Indique l’état actuel d’un GeofenceMonitor.

GeofenceRemovalReason

Indique la raison pour laquelle une limite géographique a été supprimée.

GeofenceState

Indique l’état actuel d’une limite géographique.

MonitoredGeofenceStates

Indique l’état ou les états des limites géographiques actuellement surveillées par le système.

Remarques

Les services de localisation doivent être en cours d’exécution pour que le géofencing fonctionne. Si ce service est désactivé, les appels de géofencing échouent et lèvent une exception.

Votre application doit déclarer la fonctionnalité d’emplacement dans le manifeste de l’application afin d’utiliser le géofencing.