LocationManager.GetCurrentLocation Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer) |
Gibt asynchron einen einzelnen aktuellen Speicherort fix vom angegebenen Anbieter basierend auf dem angegebenen . |
GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer) |
Gibt asynchron einen einzelnen aktuellen Speicherort fix vom angegebenen Anbieter zurück. |
GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer)
Gibt asynchron einen einzelnen aktuellen Speicherort fix vom angegebenen Anbieter basierend auf dem angegebenen .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
Parameter
- provider
- String
ein anbieter aufgeführt nach #getAllProviders()
- locationRequest
- LocationRequest
die Standortanforderung, die Standortparameter enthält
- cancellationSignal
- CancellationSignal
ein optionales Signal, mit dem dieser Anruf abgebrochen werden kann
- executor
- IExecutor
der Rückruf erfolgt auf dieser Seite. Executor
- consumer
- IConsumer
der Rückruf, der mit einer Location
oder null aufgerufen wurde
- Attribute
Hinweise
Gibt asynchron einen einzelnen aktuellen Speicherort fix vom angegebenen Anbieter basierend auf dem angegebenen .LocationRequest
Dies kann Sensoren aktivieren, um einen neuen Speicherort zu berechnen, im Gegensatz dazu #getLastKnownLocation(String)
, dass nur ein zwischengespeicherter Fix zurückgegeben wird, falls verfügbar. Der angegebene Rückruf wird einmal und nur einmal aufgerufen, entweder mit einem gültigen Speicherort oder mit einem NULL-Speicherort, wenn der Anbieter keinen gültigen Speicherort generieren konnte.
Ein Kunde kann einen optionalen CancellationSignal
. Wenn dies zum Abbrechen des Vorgangs verwendet wird, sollte kein Rückruf nach dem Abbruch erwartet werden.
Diese Methode kann Speicherorte aus der letzten Vergangenheit (in der Reihenfolge von mehreren Sekunden) zurückgeben, aber niemals ältere Speicherorte zurückgeben (z. B. mehrere Minuten alt oder älter). Clients können sich auf die Garantie verlassen, dass diese Methode, wenn diese Methode einen Standort zurückgibt, die beste Schätzung des Standorts des Geräts im aktuellen Moment darstellt.
Clients, die diese Methode aus dem Hintergrund aufrufen, stellen möglicherweise fest, dass die Methode eine gültige Positionskorrektur nicht häufiger als im Vordergrund ermittelt. Hintergrundanwendungen können an ihrem Standortzugriff eingeschränkt werden.
Die angegebene Standortanforderung kann verwendet werden, um Hinweise darauf bereitzustellen, wie ein neuer Standort bei Bedarf berechnet wird. Insbesondere LocationRequest#getDurationMillis()
kann verwendet werden, um die maximale Dauer vor einem Fehlschlagen zu ermöglichen. Das System begrenzt immer die maximale Zeit, die eine Anforderung für den aktuellen Standort bis zu einem angemessenen Wert (z. B. weniger als eine Minute) ausgeführt wird, bevor die Anforderung fehlgeschlagen ist.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Gilt für:
GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer)
Gibt asynchron einen einzelnen aktuellen Speicherort fix vom angegebenen Anbieter zurück.
[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
Parameter
- provider
- String
ein anbieter aufgeführt nach #getAllProviders()
- cancellationSignal
- CancellationSignal
ein optionales Signal, mit dem dieser Anruf abgebrochen werden kann
- executor
- IExecutor
der Rückruf erfolgt auf dieser Seite. Executor
- consumer
- IConsumer
der Rückruf, der mit einer Location
oder null aufgerufen wurde
- Attribute
Hinweise
Gibt asynchron einen einzelnen aktuellen Speicherort fix vom angegebenen Anbieter zurück.
Weitere Informationen finden Sie unter #getCurrentLocation(String, LocationRequest, CancellationSignal, Executor, Consumer)
.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.