LocationManager.RequestLocationUpdates Método

[Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;Landroid/location/LocationRequest;Landroid/app/PendingIntent;)V", "GetRequestLocationUpdates_Ljava_lang_String_Landroid_location_LocationRequest_Landroid_app_PendingIntent_Handler", ApiSince=31)]
public virtual void RequestLocationUpdates(string provider, Android.Locations.LocationRequest locationRequest, Android.App.PendingIntent pendingIntent);

[<Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;Landroid/location/LocationRequest;Landroid/app/PendingIntent;)V", "GetRequestLocationUpdates_Ljava_lang_String_Landroid_location_LocationRequest_Landroid_app_PendingIntent_Handler", ApiSince=31)>]
abstract member RequestLocationUpdates : string * Android.Locations.LocationRequest * Android.App.PendingIntent -> unit
override this.RequestLocationUpdates : string * Android.Locations.LocationRequest * Android.App.PendingIntent -> unit

Parâmetros

Atributos

RegisterAttribute

Comentários

Registre-se para atualizações de localização do provedor especificado, usando um LocationRequeste retornos de chamada entregues por meio do fornecido PendingIntent.

As intenções pendentes entregues conterão extras com as informações de retorno de chamada. As chaves usadas para os extras são #KEY_LOCATION_CHANGED e #KEY_PROVIDER_ENABLED. Consulte a documentação de cada chave extra respectiva para obter informações sobre os valores.

Para cancelar o registro de atualizações de localização, use #removeUpdates(PendingIntent).

Java documentação para android.location.LocationManager.requestLocationUpdates(java.lang.String, android.location.LocationRequest, android.app.PendingIntent).

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

[Android.Runtime.Register("requestLocationUpdates", "(JFLandroid/location/Criteria;Landroid/app/PendingIntent;)V", "GetRequestLocationUpdates_JFLandroid_location_Criteria_Landroid_app_PendingIntent_Handler")]
public virtual void RequestLocationUpdates(long minTimeMs, float minDistanceM, Android.Locations.Criteria criteria, Android.App.PendingIntent pendingIntent);

[<Android.Runtime.Register("requestLocationUpdates", "(JFLandroid/location/Criteria;Landroid/app/PendingIntent;)V", "GetRequestLocationUpdates_JFLandroid_location_Criteria_Landroid_app_PendingIntent_Handler")>]
abstract member RequestLocationUpdates : int64 * single * Android.Locations.Criteria * Android.App.PendingIntent -> unit
override this.RequestLocationUpdates : int64 * single * Android.Locations.Criteria * Android.App.PendingIntent -> unit

Parâmetros

Atributos

RegisterAttribute

Exceções

Comentários

Registre-se para atualizações de localização usando um provedor selecionado por meio dos critérios fornecidos e retornos de chamada entregues por meio do fornecido PendingIntent.

Observação: como o Android KitKat, as solicitações de critérios sempre resultarão no uso do #FUSED_PROVIDER.

Confira #requestLocationUpdates(String, long, float, PendingIntent) mais detalhes sobre como esse método funciona.

Este membro foi preterido. Em vez disso, use #requestLocationUpdates(String, long, float, PendingIntent) para selecionar explicitamente um provedor.

Java documentação para android.location.LocationManager.requestLocationUpdates(long, float, android.location.Criteria, android.app.PendingIntent).

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

[Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;Landroid/location/LocationRequest;Ljava/util/concurrent/Executor;Landroid/location/LocationListener;)V", "GetRequestLocationUpdates_Ljava_lang_String_Landroid_location_LocationRequest_Ljava_util_concurrent_Executor_Landroid_location_LocationListener_Handler", ApiSince=31)]
public virtual void RequestLocationUpdates(string provider, Android.Locations.LocationRequest locationRequest, Java.Util.Concurrent.IExecutor executor, Android.Locations.ILocationListener listener);

[<Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;Landroid/location/LocationRequest;Ljava/util/concurrent/Executor;Landroid/location/LocationListener;)V", "GetRequestLocationUpdates_Ljava_lang_String_Landroid_location_LocationRequest_Ljava_util_concurrent_Executor_Landroid_location_LocationListener_Handler", ApiSince=31)>]
abstract member RequestLocationUpdates : string * Android.Locations.LocationRequest * Java.Util.Concurrent.IExecutor * Android.Locations.ILocationListener -> unit
override this.RequestLocationUpdates : string * Android.Locations.LocationRequest * Java.Util.Concurrent.IExecutor * Android.Locations.ILocationListener -> unit

Parâmetros

Atributos

RegisterAttribute

Comentários

Registre-se para atualizações de localização do provedor especificado, usando um LocationRequeste um retorno de chamada no especificado Executor.

Somente uma solicitação pode ser registrada para cada par de ouvinte/provedor exclusivo, portanto, todas as solicitações subsequentes com o mesmo provedor e ouvinte substituirão todos os argumentos associados. O mesmo ouvinte pode ser usado em vários provedores com solicitações diferentes para cada provedor.

Pode levar algum tempo para receber a primeira atualização de local, dependendo das condições em que o dispositivo se encontra. Para aproveitar os locais armazenados em cache, o aplicativo pode considerar o uso #getLastKnownLocation(String) ou #getCurrentLocation(String, LocationRequest, CancellationSignal, Executor, Consumer) o uso.

Consulte LocationRequest a documentação para obter uma explicação de vários parâmetros de solicitação e como eles podem afetar os locais recebidos.

Se o aplicativo quiser observar passivamente as atualizações de localização de todos os provedores, use o #PASSIVE_PROVIDER. Esse provedor não ativa nem modifica provedores de localização ativos, portanto, você não precisa ter o mesmo cuidado com os parâmetros mínimos de tempo e distância mínima. No entanto, se o aplicativo executar um trabalho pesado em uma atualização de local (como atividade de rede), você deverá definir um intervalo mais rápido explícito na solicitação de localização caso outro aplicativo habilite um provedor de localização com atualizações extremamente rápidas.

Caso o provedor selecionado esteja desabilitado, as atualizações de localização serão interrompidas e uma atualização de disponibilidade do provedor será enviada. Assim que o provedor estiver habilitado novamente, outra atualização de disponibilidade do provedor será enviada e as atualizações de localização serão retomadas.

Os locais retornados #GPS_PROVIDER são em relação à posição da antena GNSS primária dentro do dispositivo. #getGnssAntennaInfos() pode ser usado para determinar a posição da antena GNSS em relação ao Sistema de Coordenadas do Android e converter entre elas, se necessário. Isso geralmente só é necessário para aplicativos de alta precisão.

Quando os retornos de chamada de localização forem invocados, o sistema manterá um wakelock em nome do aplicativo por algum período de tempo, mas não indefinidamente. Se o aplicativo exigir um wakelock de execução prolongada dentro do retorno de chamada de local, você deverá adquiri-lo por conta própria.

Solicitações de localização de spam são um dreno de recursos do sistema e o sistema tem medidas preventivas em vigor para garantir que esse comportamento nunca resulte em mais locais do que poderia ser alcançado com uma única solicitação de local com um intervalo equivalente que é deixado em vigor o tempo todo. Como parte dessa amelioração, os aplicativos direcionados ao Android S e acima podem receber locais em cache ou históricos por meio de seu ouvinte. Esses locais nunca serão mais antigos do que o intervalo da solicitação de localização.

Para cancelar o registro de atualizações de localização, use #removeUpdates(LocationListener).

Java documentação para android.location.LocationManager.requestLocationUpdates(java.lang.String, android.location.LocationRequest, java.util.concurrent.Executor, android.location.LocationListener).

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

[Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLandroid/app/PendingIntent;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLandroid_app_PendingIntent_Handler")]
public virtual void RequestLocationUpdates(string provider, long minTimeMs, float minDistanceM, Android.App.PendingIntent pendingIntent);

[<Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLandroid/app/PendingIntent;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLandroid_app_PendingIntent_Handler")>]
abstract member RequestLocationUpdates : string * int64 * single * Android.App.PendingIntent -> unit
override this.RequestLocationUpdates : string * int64 * single * Android.App.PendingIntent -> unit

Parâmetros

Atributos

RegisterAttribute

Exceções

Comentários

Registre-se para atualizações de localização usando o provedor nomeado e retornos de chamada entregues por meio do fornecido PendingIntent.

Confira #requestLocationUpdates(String, LocationRequest, PendingIntent) mais detalhes sobre como esse método funciona.

Java documentação para android.location.LocationManager.requestLocationUpdates(java.lang.String, long, float, android.app.PendingIntent).

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

[Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLandroid/location/LocationListener;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLandroid_location_LocationListener_Handler")]
public virtual void RequestLocationUpdates(string provider, long minTimeMs, float minDistanceM, Android.Locations.ILocationListener listener);

[<Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLandroid/location/LocationListener;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLandroid_location_LocationListener_Handler")>]
abstract member RequestLocationUpdates : string * int64 * single * Android.Locations.ILocationListener -> unit
override this.RequestLocationUpdates : string * int64 * single * Android.Locations.ILocationListener -> unit

Parâmetros

Atributos

RegisterAttribute

Exceções

Comentários

Registre-se para atualizações de localização do provedor fornecido com os argumentos fornecidos e um retorno de chamada no Looper thread de chamada.

Confira #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) mais detalhes sobre como esse método funciona.

Antes do Jellybean, o parâmetro minTime era apenas uma dica e algumas implementações do provedor de localização o ignoravam. No entanto, para Jellybean e em diante, é obrigatório que dispositivos compatíveis com Android observem os parâmetros minTime e minDistance.

Java documentação para android.location.LocationManager.requestLocationUpdates(java.lang.String, long, float, android.location.LocationListener).

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

[Android.Runtime.Register("requestLocationUpdates", "(JFLandroid/location/Criteria;Landroid/location/LocationListener;Landroid/os/Looper;)V", "GetRequestLocationUpdates_JFLandroid_location_Criteria_Landroid_location_LocationListener_Landroid_os_Looper_Handler")]
public virtual void RequestLocationUpdates(long minTimeMs, float minDistanceM, Android.Locations.Criteria criteria, Android.Locations.ILocationListener listener, Android.OS.Looper? looper);

[<Android.Runtime.Register("requestLocationUpdates", "(JFLandroid/location/Criteria;Landroid/location/LocationListener;Landroid/os/Looper;)V", "GetRequestLocationUpdates_JFLandroid_location_Criteria_Landroid_location_LocationListener_Landroid_os_Looper_Handler")>]
abstract member RequestLocationUpdates : int64 * single * Android.Locations.Criteria * Android.Locations.ILocationListener * Android.OS.Looper -> unit
override this.RequestLocationUpdates : int64 * single * Android.Locations.Criteria * Android.Locations.ILocationListener * Android.OS.Looper -> unit

Parâmetros

Atributos

RegisterAttribute

Exceções

Comentários

Registre-se para atualizações de localização usando um provedor selecionado por meio dos critérios especificados e um retorno de chamada no especificado Looper.

Observação: como o Android KitKat, as solicitações de critérios sempre resultarão no uso do #FUSED_PROVIDER.

Confira #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) mais detalhes sobre como esse método funciona.

Este membro foi preterido. Em vez disso, use #requestLocationUpdates(String, long, float, LocationListener, Looper) para selecionar explicitamente um provedor.

Java documentação para android.location.LocationManager.requestLocationUpdates(long, float, android.location.Criteria, android.location.LocationListener, android.os.Looper).

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

[Android.Runtime.Register("requestLocationUpdates", "(JFLandroid/location/Criteria;Ljava/util/concurrent/Executor;Landroid/location/LocationListener;)V", "GetRequestLocationUpdates_JFLandroid_location_Criteria_Ljava_util_concurrent_Executor_Landroid_location_LocationListener_Handler", ApiSince=30)]
public virtual void RequestLocationUpdates(long minTimeMs, float minDistanceM, Android.Locations.Criteria criteria, Java.Util.Concurrent.IExecutor executor, Android.Locations.ILocationListener listener);

[<Android.Runtime.Register("requestLocationUpdates", "(JFLandroid/location/Criteria;Ljava/util/concurrent/Executor;Landroid/location/LocationListener;)V", "GetRequestLocationUpdates_JFLandroid_location_Criteria_Ljava_util_concurrent_Executor_Landroid_location_LocationListener_Handler", ApiSince=30)>]
abstract member RequestLocationUpdates : int64 * single * Android.Locations.Criteria * Java.Util.Concurrent.IExecutor * Android.Locations.ILocationListener -> unit
override this.RequestLocationUpdates : int64 * single * Android.Locations.Criteria * Java.Util.Concurrent.IExecutor * Android.Locations.ILocationListener -> unit

Parâmetros

Atributos

RegisterAttribute

Comentários

Registre-se para atualizações de localização usando um provedor selecionado por meio dos critérios especificados e um retorno de chamada no especificado Executor.

Observação: como o Android KitKat, as solicitações de critérios sempre resultarão no uso do #FUSED_PROVIDER.

Confira #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) mais detalhes sobre como esse método funciona.

Este membro foi preterido. Em vez disso, use #requestLocationUpdates(String, long, float, Executor, LocationListener) para selecionar explicitamente um provedor.

Java documentação para android.location.LocationManager.requestLocationUpdates(long, float, android.location.Criteria, java.util.concurrent.Executor, android.location.LocationListener).

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

[Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLandroid/location/LocationListener;Landroid/os/Looper;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLandroid_location_LocationListener_Landroid_os_Looper_Handler")]
public virtual void RequestLocationUpdates(string provider, long minTimeMs, float minDistanceM, Android.Locations.ILocationListener listener, Android.OS.Looper? looper);

[<Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLandroid/location/LocationListener;Landroid/os/Looper;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLandroid_location_LocationListener_Landroid_os_Looper_Handler")>]
abstract member RequestLocationUpdates : string * int64 * single * Android.Locations.ILocationListener * Android.OS.Looper -> unit
override this.RequestLocationUpdates : string * int64 * single * Android.Locations.ILocationListener * Android.OS.Looper -> unit

Parâmetros

Atributos

RegisterAttribute

Exceções

Comentários

Registre-se para atualizações de localização do provedor fornecido com os argumentos fornecidos e um retorno de chamada no especificado Looper.

Confira #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) mais detalhes sobre como esse método funciona.

Antes do Jellybean, o parâmetro minTime era apenas uma dica e algumas implementações do provedor de localização o ignoravam. No entanto, para Jellybean e em diante, é obrigatório que dispositivos compatíveis com Android observem os parâmetros minTime e minDistance.

Java documentação para android.location.LocationManager.requestLocationUpdates(java.lang.String, long, float, android.location.LocationListener, android.os.Looper).

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

[Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLjava/util/concurrent/Executor;Landroid/location/LocationListener;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLjava_util_concurrent_Executor_Landroid_location_LocationListener_Handler", ApiSince=30)]
public virtual void RequestLocationUpdates(string provider, long minTimeMs, float minDistanceM, Java.Util.Concurrent.IExecutor executor, Android.Locations.ILocationListener listener);

[<Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLjava/util/concurrent/Executor;Landroid/location/LocationListener;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLjava_util_concurrent_Executor_Landroid_location_LocationListener_Handler", ApiSince=30)>]
abstract member RequestLocationUpdates : string * int64 * single * Java.Util.Concurrent.IExecutor * Android.Locations.ILocationListener -> unit
override this.RequestLocationUpdates : string * int64 * single * Java.Util.Concurrent.IExecutor * Android.Locations.ILocationListener -> unit

Parâmetros

Atributos

RegisterAttribute

Comentários

Registre-se para atualizações de localização usando o provedor nomeado e um retorno de chamada no especificado Executor.

Confira #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) mais detalhes sobre como esse método funciona.

Antes do Jellybean, o parâmetro minTime era apenas uma dica e algumas implementações do provedor de localização o ignoravam. No entanto, para Jellybean e em diante, é obrigatório que dispositivos compatíveis com Android observem os parâmetros minTime e minDistance.

Java documentação para android.location.LocationManager.requestLocationUpdates(java.lang.String, long, float, java.util.concurrent.Executor, android.location.LocationListener).

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