LocationManager.GetCurrentLocation 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í.
Sobrecargas
| GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer) |
Devuelve de forma asincrónica una única corrección de ubicación actual del proveedor especificado en función de la especificada |
| GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer) |
Devuelve de forma asincrónica una única corrección de ubicación actual del proveedor especificado. |
GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer)
Devuelve de forma asincrónica una única corrección de ubicación actual del proveedor especificado en función de la especificada 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 -> unitParámetros
- provider
- String
un proveedor enumerado por #getAllProviders()
- locationRequest
- LocationRequest
la solicitud de ubicación que contiene parámetros de ubicación
- cancellationSignal
- CancellationSignal
una señal opcional que permite cancelar esta llamada
- executor
- IExecutor
la devolución de llamada tendrá lugar en este Executor
- consumer
- IConsumer
devolución de llamada invocada con o Location null
- Atributos
Comentarios
Devuelve de forma asincrónica una única corrección de ubicación actual del proveedor especificado en función de la especificada LocationRequest. Esto puede activar sensores para calcular una nueva ubicación, a diferencia #getLastKnownLocation(String)de , que solo devolverá una corrección almacenada en caché si está disponible. La devolución de llamada especificada se invocará una vez y solo una vez, ya sea con una ubicación válida o con una ubicación nula si el proveedor no pudo generar una ubicación válida.
Un cliente puede proporcionar un opcional CancellationSignal. Si se usa para cancelar la operación, no se debe esperar ninguna devolución de llamada después de la cancelación.
Este método puede devolver ubicaciones del pasado muy reciente (en el orden de varios segundos), pero nunca devolverá ubicaciones anteriores (por ejemplo, varios minutos de antigüedad o anteriores). Los clientes pueden confiar en la garantía de que si este método devuelve una ubicación, representará la mejor estimación de la ubicación del dispositivo en el momento actual.
Los clientes que llaman a este método desde segundo plano pueden observar que el método no puede determinar una corrección de ubicación válida con más frecuencia que en primer plano. Las aplicaciones en segundo plano se pueden limitar en sus accesos de ubicación hasta cierto punto.
La solicitud de ubicación especificada se puede usar para proporcionar sugerencias sobre cómo se calcula una ubicación nueva si es necesario. En concreto LocationRequest#getDurationMillis() , se puede usar para proporcionar la duración máxima permitida antes de que se produzca un error. El sistema siempre limitará la cantidad máxima de tiempo que una solicitud de ubicación actual puede ejecutarse en un valor razonable (menos de un minuto por ejemplo) antes de que se produzca un error en la solicitud.
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.
Se aplica a
GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer)
Devuelve de forma asincrónica una única corrección de ubicación actual del proveedor 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 -> unitParámetros
- provider
- String
un proveedor enumerado por #getAllProviders()
- cancellationSignal
- CancellationSignal
una señal opcional que permite cancelar esta llamada
- executor
- IExecutor
la devolución de llamada tendrá lugar en este Executor
- consumer
- IConsumer
devolución de llamada invocada con o Location null
- Atributos
Comentarios
Devuelve de forma asincrónica una única corrección de ubicación actual del proveedor especificado.
Vea #getCurrentLocation(String, LocationRequest, CancellationSignal, Executor, Consumer) para obtener más información.
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.