LocationManager.GetCurrentLocation Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer) |
Restituisce in modo asincrono una singola correzione della posizione corrente dal provider specificato in base all'oggetto specificato |
GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer) |
Restituisce in modo asincrono una singola correzione della posizione corrente dal provider specificato. |
GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer)
Restituisce in modo asincrono una singola correzione della posizione corrente dal provider specificato in base all'oggetto specificato 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
Parametri
- provider
- String
un provider elencato da #getAllProviders()
- locationRequest
- LocationRequest
richiesta di posizione contenente i parametri location
- cancellationSignal
- CancellationSignal
un segnale facoltativo che consente di annullare questa chiamata
- executor
- IExecutor
il callback avrà luogo su questo Executor
- consumer
- IConsumer
callback richiamato con o Location
null
- Attributi
Commenti
Restituisce in modo asincrono una singola correzione della posizione corrente dal provider specificato in base all'oggetto specificato LocationRequest
. Ciò può attivare i sensori per calcolare una nuova posizione, a differenza #getLastKnownLocation(String)
di , che restituirà solo una correzione memorizzata nella cache, se disponibile. Il callback specificato verrà richiamato una volta e una sola volta, con una posizione valida o con una posizione Null se il provider non è riuscito a generare una posizione valida.
Un client può fornire un oggetto facoltativo CancellationSignal
. Se questa operazione viene utilizzata per annullare l'operazione, non dovrebbe essere previsto alcun callback dopo l'annullamento.
Questo metodo può restituire posizioni dal passato molto recente (in base all'ordine di alcuni secondi), ma non restituirà mai posizioni meno recenti (ad esempio, alcuni minuti precedenti o meno recenti). I client possono basarsi sulla garanzia che, se questo metodo restituisce una posizione, rappresenterà la stima migliore della posizione del dispositivo nel momento attuale.
I client che chiamano questo metodo dallo sfondo possono notare che il metodo non riesce a determinare una correzione della posizione valida più spesso rispetto a quella in primo piano. Le applicazioni in background possono essere limitate in qualche modo nei relativi accessi alla posizione.
La richiesta di posizione specificata può essere usata per fornire suggerimenti su come viene calcolata una nuova posizione, se necessario. In particolare LocationRequest#getDurationMillis()
, è possibile usare per fornire la durata massima consentita prima dell'esito negativo. Il sistema limiterà sempre la quantità massima di tempo per cui una richiesta per la posizione corrente può essere eseguita su un valore ragionevole (ad esempio inferiore a un minuto) prima che la richiesta non sia riuscita.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.
Si applica a
GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer)
Restituisce in modo asincrono una singola correzione della posizione corrente dal provider specificato.
[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
Parametri
- provider
- String
un provider elencato da #getAllProviders()
- cancellationSignal
- CancellationSignal
un segnale facoltativo che consente di annullare questa chiamata
- executor
- IExecutor
il callback avrà luogo su questo Executor
- consumer
- IConsumer
callback richiamato con o Location
null
- Attributi
Commenti
Restituisce in modo asincrono una singola correzione della posizione corrente dal provider specificato.
Per altre informazioni, vedere #getCurrentLocation(String, LocationRequest, CancellationSignal, Executor, Consumer)
.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.