LocationManager.AddProximityAlert Método

Referência

Definição

Namespace:: Android.Locations

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Define um alerta de proximidade para a localização dada pela posição (latitude, longitude) e o raio dado.

[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

Parâmetros

latitude: Double

a latitude do ponto central da região de alerta

longitude: Double

a longitude do ponto central da região de alerta

radius: Single

o raio do ponto central da região de alerta em metros

expiration: Int64

expiração em tempo real para esse alerta de proximidade em milissegundos ou -1 para indicar nenhuma expiração

pendingIntent: PendingIntent

a PendingIntent que será enviada quando a entrada ou saída da região de alerta for detectada

Atributos: RegisterAttribute

Exceções

SecurityException

se AccessFineLocation a permissão não estiver presente

Comentários

Define um alerta de proximidade para a localização dada pela posição (latitude, longitude) e o raio dado.

Quando o dispositivo detectar que entrou ou saiu da área ao redor do local, o PendingIntent fornecido será disparado.

A intenção de disparar terá um extra booleano adicionado com chave #KEY_PROXIMITY_ENTERING. Se o valor for true, o dispositivo está entrando na região de proximidade; se falso, está saindo.

Devido à natureza aproximada da estimativa de posição, se o dispositivo passar pela área dada brevemente, é possível que nenhuma intenção seja disparada. Da mesma forma, uma intenção pode ser disparada se o dispositivo passar muito perto da área dada, mas não entrar nela.

Antes da versão 17 da API, esse método podia ser usado com android.Manifest.permission#ACCESS_FINE_LOCATION ou android.Manifest.permission#ACCESS_COARSE_LOCATION. A partir da versão 17 da API, esse método requer android.Manifest.permission#ACCESS_FINE_LOCATION permissão.

Documentação Java para android.location.LocationManager.addProximityAlert(double, double, float, long, android.app.PendingIntent).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Aplica-se a

Compartilhar via