LocationManager.GetCurrentLocation Método

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.

Sobrecargas

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

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

Retorna de forma assíncrona uma única correção de local atual do provedor determinado com base no determinado 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 local que contém parâmetros de local

cancellationSignal: CancellationSignal

um sinal opcional que permite cancelar essa chamada

executor: IExecutor

o retorno de chamada ocorrerá neste Executor

consumer: IConsumer

o retorno de chamada invocado com um Location ou nulo

Atributos: RegisterAttribute

Comentários

Retorna de forma assíncrona uma única correção de local atual do provedor determinado com base no determinado LocationRequest. Isso pode ativar sensores para computar um novo local, diferentemente #getLastKnownLocation(String)de, que só retornará uma correção armazenada em cache se disponível. O retorno de chamada determinado será invocado uma vez e apenas uma vez, com um local válido ou com um local nulo se o provedor não puder gerar um local válido.

Um cliente pode fornecer um opcional CancellationSignal. Se isso for usado para cancelar a operação, nenhum retorno de chamada deverá 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 de idade ou mais antigos). Os clientes podem depender da garantia de que, se esse método retornar um local, ele representará a melhor estimativa do local do dispositivo no momento presente.

Os clientes que chamam esse método em segundo plano podem notar que o método falha ao determinar uma correção de local válida com mais frequência do que em primeiro plano. Os aplicativos em segundo plano podem ser limitados em seus acessos de localização até certo ponto.

A solicitação de local fornecida pode ser usada para fornecer dicas sobre como um novo local é computado, 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á o tempo máximo que uma solicitação para o local atual pode ser executada para algum valor razoável (menos de um minuto, por exemplo) antes que a solicitação seja reprovada.

Java documentação 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 Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a

GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer)

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

[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