LocationManager.AddProximityAlert Metodo

Riferimento

Definizione

Spazio dei nomi:: Android.Locations

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Imposta un avviso di prossimità per la posizione specificata dalla posizione (latitudine, longitudine) e dal raggio specificato.

[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

Parametri

latitude: Double

latitudine del punto centrale dell'area di avviso

longitude: Double

longitudine del punto centrale dell'area di avviso

radius: Single

raggio del punto centrale dell'area di avviso in metri

expiration: Int64

scadenza in tempo reale per questo avviso di prossimità in millisecondi o -1 per indicare che non è prevista alcuna scadenza

pendingIntent: PendingIntent

che PendingIntent verrà inviato quando viene rilevata l'ingresso o l'uscita dall'area di avviso

Attributi: RegisterAttribute

Eccezioni

SecurityException

se AccessFineLocation l'autorizzazione non è presente

Commenti

Imposta un avviso di prossimità per la posizione specificata dalla posizione (latitudine, longitudine) e dal raggio specificato.

Quando il dispositivo rileva che è entrato o esce dall'area circostante la posizione, verrà attivato il valore PendingIntent specificato.

La finalità attivata avrà un valore booleano aggiuntivo aggiunto con la chiave #KEY_PROXIMITY_ENTERING. Se il valore è true, il dispositivo sta immettendo l'area di prossimità; se false, sta per uscire.

A causa della natura approssimativa della stima della posizione, se il dispositivo passa brevemente attraverso l'area specificata, è possibile che non venga generato alcun intento. Analogamente, una finalità potrebbe essere attivata se il dispositivo passa molto vicino all'area specificata, ma non lo immette effettivamente.

Prima dell'API versione 17, questo metodo può essere usato con android.Manifest.permission#ACCESS_FINE_LOCATION o android.Manifest.permission#ACCESS_COARSE_LOCATION. A partire dalla versione 17 dell'API e successive, questo metodo richiede android.Manifest.permission#ACCESS_FINE_LOCATION l'autorizzazione.

Documentazione java per android.location.LocationManager.addProximityAlert(double, double, float, long, android.app.PendingIntent).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Si applica a

Condividi tramite