LocationManager.AddProximityAlert Méthode

Référence

Définition

Espace de noms:: Android.Locations

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Définit une alerte de proximité pour l’emplacement donné par la position (latitude, longitude) et le rayon donné.

[Android.Runtime.Register("addProximityAlert", "(DDFJLandroid/app/PendingIntent;)V", "GetAddProximityAlert_DDFJLandroid_app_PendingIntent_Handler")]
public virtual void AddProximityAlert (double latitude, double longitude, float radius, long expiration, Android.App.PendingIntent pendingIntent);

[<Android.Runtime.Register("addProximityAlert", "(DDFJLandroid/app/PendingIntent;)V", "GetAddProximityAlert_DDFJLandroid_app_PendingIntent_Handler")>]
abstract member AddProximityAlert : double * double * single * int64 * Android.App.PendingIntent -> unit
override this.AddProximityAlert : double * double * single * int64 * Android.App.PendingIntent -> unit

Paramètres

latitude: Double

latitude du point central de la région d’alerte

longitude: Double

longitude du point central de la région d’alerte

radius: Single

rayon du point central de la région d’alerte en mètres

expiration: Int64

expiration en temps réel de cette alerte de proximité en millisecondes, ou -1 pour indiquer qu’aucune expiration n’est spécifiée

pendingIntent: PendingIntent

qui PendingIntent sera envoyé lorsque l’entrée vers ou la sortie de la région d’alerte est détectée

Attributs: RegisterAttribute

Exceptions

SecurityException

si AccessFineLocation l’autorisation n’est pas présente

Remarques

Définit une alerte de proximité pour l’emplacement donné par la position (latitude, longitude) et le rayon donné.

Lorsque l’appareil détecte qu’il a entré ou quitté la zone entourant l’emplacement, l’appareil En attente donné est déclenché.

L’intention déclenchée aura un extra booléen ajouté avec la clé #KEY_PROXIMITY_ENTERING. Si la valeur est true, l’appareil entre dans la région de proximité ; si la valeur est false, elle quitte.

En raison de la nature approximative de l’estimation de position, si l’appareil traverse brièvement la zone donnée, il est possible qu’aucune intention ne soit déclenchée. De même, une intention peut être déclenchée si l’appareil passe très près de la zone donnée, mais ne l’entre pas réellement.

Avant l’API version 17, cette méthode peut être utilisée avec android.Manifest.permission#ACCESS_FINE_LOCATION ou android.Manifest.permission#ACCESS_COARSE_LOCATION. À partir de l’API version 17 et ultérieure, cette méthode nécessite android.Manifest.permission#ACCESS_FINE_LOCATION une autorisation.

Documentation Java pour android.location.LocationManager.addProximityAlert(double, double, float, long, android.app.PendingIntent).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à

Partager via