LocationManager.AddProximityAlert Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Establece una alerta de proximidad para la ubicación dada por la posición (latitud, longitud) y el radio especificado.
[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 -> unitParámetros
- latitude
- Double
latitud del punto central de la región de alerta
- longitude
- Double
longitud del punto central de la región de alerta
- radius
- Single
radio del punto central de la región de alerta en metros
- expiration
- Int64
expiración en tiempo real para esta alerta de proximidad en milisegundos, o -1 para indicar que no hay expiración
- pendingIntent
- PendingIntent
que PendingIntent se enviará cuando se detecte la entrada o salida de la región de alerta.
- Atributos
Excepciones
si AccessFineLocation el permiso no está presente
Comentarios
Establece una alerta de proximidad para la ubicación dada por la posición (latitud, longitud) y el radio especificado.
Cuando el dispositivo detecta que ha entrado o salido del área que rodea la ubicación, se activará el elemento PendingIntent especificado.
La intención desencadenada tendrá un extra booleano agregado con la clave #KEY_PROXIMITY_ENTERING. Si el valor es true, el dispositivo entra en la región de proximidad; si es false, sale.
Debido a la naturaleza aproximada de la estimación de posición, si el dispositivo pasa por el área dada brevemente, es posible que no se desencadene ninguna intención. De forma similar, se podría desencadenar una intención si el dispositivo pasa muy cerca del área especificada, pero no lo introduce realmente.
Antes de la versión 17 de la API, este método podría usarse con android.Manifest.permission#ACCESS_FINE_LOCATION o android.Manifest.permission#ACCESS_COARSE_LOCATION. A partir de la versión 17 y posteriores de la API, este método requiere android.Manifest.permission#ACCESS_FINE_LOCATION permiso.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.