LocationManager.GetCurrentLocation Método

Definição

Namespace:

Android.Locations

Assembly:

Mono.Android.dll

Sobrecargas

GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer)	Retorna de forma assíncrona uma única correção de local atual do provedor fornecido com base no .LocationRequest
GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer)	Retorna de forma assíncrona uma única correção de local atual do provedor especificado.

GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer)

Retorna de forma assíncrona uma única correção de local atual do provedor fornecido com base no .LocationRequest

[Android.Runtime.Register("getCurrentLocation", "(Ljava/lang/String;Landroid/location/LocationRequest;Landroid/os/CancellationSignal;Ljava/util/concurrent/Executor;Ljava/util/function/Consumer;)V", "GetGetCurrentLocation_Ljava_lang_String_Landroid_location_LocationRequest_Landroid_os_CancellationSignal_Ljava_util_concurrent_Executor_Ljava_util_function_Consumer_Handler", ApiSince=31)]
public virtual void GetCurrentLocation (string provider, Android.Locations.LocationRequest locationRequest, Android.OS.CancellationSignal? cancellationSignal, Java.Util.Concurrent.IExecutor executor, Java.Util.Functions.IConsumer consumer);

[<Android.Runtime.Register("getCurrentLocation", "(Ljava/lang/String;Landroid/location/LocationRequest;Landroid/os/CancellationSignal;Ljava/util/concurrent/Executor;Ljava/util/function/Consumer;)V", "GetGetCurrentLocation_Ljava_lang_String_Landroid_location_LocationRequest_Landroid_os_CancellationSignal_Ljava_util_concurrent_Executor_Ljava_util_function_Consumer_Handler", ApiSince=31)>]
abstract member GetCurrentLocation : string * Android.Locations.LocationRequest * Android.OS.CancellationSignal * Java.Util.Concurrent.IExecutor * Java.Util.Functions.IConsumer -> unit
override this.GetCurrentLocation : string * Android.Locations.LocationRequest * Android.OS.CancellationSignal * Java.Util.Concurrent.IExecutor * Java.Util.Functions.IConsumer -> unit

Parâmetros

provider

String

um provedor listado por #getAllProviders()

locationRequest

LocationRequest

A solicitação de localização que contém parâmetros de localização

cancellationSignal

CancellationSignal

um sinal opcional que permite cancelar esta chamada

executor

IExecutor

O retorno ocorrerá neste Executor

consumer

IConsumer

O retorno de chamada invocado com A Location ou null

Atributos

RegisterAttribute

Comentários

Retorna de forma assíncrona uma única correção de local atual do provedor fornecido com base no .LocationRequest Isso pode ativar sensores para calcular um novo local, ao contrário #getLastKnownLocation(String)do , que só retornará uma correção em cache se disponível. O retorno de chamada fornecido será chamado uma vez e somente uma vez, com um local válido ou com um local nulo se o provedor não conseguir gerar um local válido.

Um cliente pode fornecer um CancellationSignalarquivo opcional. Se isso for usado para cancelar a operação, nenhum retorno de chamada deve ser esperado após o cancelamento.

Esse método pode retornar locais do passado muito recente (na ordem de vários segundos), mas nunca retornará locais mais antigos (por exemplo, vários minutos antigos ou mais antigos). Os clientes podem contar com a garantia de que, se esse método retornar uma localização, ele representará a melhor estimativa da localização do dispositivo no momento presente.

Os clientes que chamam esse método do plano de fundo podem notar que o método não consegue determinar uma correção de local válida com mais frequência do que enquanto em primeiro plano. Os aplicativos em segundo plano podem ser limitados em seus acessos de localização em algum grau.

A solicitação de local fornecida pode ser usada para fornecer dicas sobre como um novo local é calculado, se necessário. Em particular, LocationRequest#getDurationMillis() pode ser usado para fornecer a duração máxima permitida antes de falhar. O sistema sempre limitará a quantidade máxima de tempo que uma solicitação para o local atual pode ser executada a algum valor razoável (menos de um minuto, por exemplo) antes que a solicitação seja prejudicada.

Documentação Java para android.location.LocationManager.getCurrentLocation(java.lang.String, android.location.LocationRequest, android.os.CancellationSignal, java.util.concurrent.Executor, java.util.function.Consumer<android.location.Location>).

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.

GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer)

Retorna de forma assíncrona uma única correção de local atual do provedor especificado.

[Android.Runtime.Register("getCurrentLocation", "(Ljava/lang/String;Landroid/os/CancellationSignal;Ljava/util/concurrent/Executor;Ljava/util/function/Consumer;)V", "GetGetCurrentLocation_Ljava_lang_String_Landroid_os_CancellationSignal_Ljava_util_concurrent_Executor_Ljava_util_function_Consumer_Handler", ApiSince=30)]
public virtual void GetCurrentLocation (string provider, Android.OS.CancellationSignal? cancellationSignal, Java.Util.Concurrent.IExecutor executor, Java.Util.Functions.IConsumer consumer);

[<Android.Runtime.Register("getCurrentLocation", "(Ljava/lang/String;Landroid/os/CancellationSignal;Ljava/util/concurrent/Executor;Ljava/util/function/Consumer;)V", "GetGetCurrentLocation_Ljava_lang_String_Landroid_os_CancellationSignal_Ljava_util_concurrent_Executor_Ljava_util_function_Consumer_Handler", ApiSince=30)>]
abstract member GetCurrentLocation : string * Android.OS.CancellationSignal * Java.Util.Concurrent.IExecutor * Java.Util.Functions.IConsumer -> unit
override this.GetCurrentLocation : string * Android.OS.CancellationSignal * Java.Util.Concurrent.IExecutor * Java.Util.Functions.IConsumer -> unit

Parâmetros

provider

String

um provedor listado por #getAllProviders()

cancellationSignal

CancellationSignal

um sinal opcional que permite cancelar esta chamada

executor

IExecutor

O retorno ocorrerá neste Executor

consumer

IConsumer

O retorno de chamada invocado com A Location ou null

Atributos

RegisterAttribute

Comentários

Retorna de forma assíncrona uma única correção de local atual do provedor especificado.

Consulte #getCurrentLocation(String, LocationRequest, CancellationSignal, Executor, Consumer) para obter mais informações.

Documentação Java para android.location.LocationManager.getCurrentLocation(java.lang.String, android.os.CancellationSignal, java.util.concurrent.Executor, java.util.function.Consumer<android.location.Location>).

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.