LocationManager.GetCurrentLocation Méthode

Définition

Espace de noms:

Android.Locations

Assembly:

Mono.Android.dll

Surcharges

GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer)	Retourne de façon asynchrone un correctif d’emplacement actuel unique du fournisseur donné en fonction de l’emplacement donné LocationRequest.
GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer)	Retourne de façon asynchrone un correctif d’emplacement actuel unique à partir du fournisseur donné.

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

Retourne de façon asynchrone un correctif d’emplacement actuel unique du fournisseur donné en fonction de l’emplacement donné 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

Paramètres

provider

String

un fournisseur répertorié par #getAllProviders()

locationRequest

LocationRequest

demande d’emplacement contenant les paramètres d’emplacement

cancellationSignal

CancellationSignal

signal facultatif qui autorise l’annulation de cet appel

executor

IExecutor

le rappel aura lieu sur ce Executor

consumer

IConsumer

le rappel appelé avec une Location ou une valeur Null

Attributs

RegisterAttribute

Remarques

Retourne de façon asynchrone un correctif d’emplacement actuel unique du fournisseur donné en fonction de l’emplacement donné LocationRequest. Cela peut activer les capteurs pour calculer un nouvel emplacement, contrairement #getLastKnownLocation(String)à ce qui renvoie uniquement un correctif mis en cache si disponible. Le rappel donné est appelé une seule fois, soit avec un emplacement valide, soit avec un emplacement null si le fournisseur n’a pas pu générer un emplacement valide.

Un client peut fournir une option facultative CancellationSignal. S’il est utilisé pour annuler l’opération, aucun rappel ne doit être attendu après l’annulation.

Cette méthode peut retourner des emplacements à partir du passé très récent (dans l’ordre de plusieurs secondes), mais ne retournera jamais d’emplacements plus anciens (par exemple, plusieurs minutes anciennes ou plus anciennes). Les clients peuvent s’appuyer sur la garantie que si cette méthode retourne un emplacement, elle représente la meilleure estimation de l’emplacement de l’appareil dans le moment présent.

Les clients appelant cette méthode à partir de l’arrière-plan peuvent remarquer que la méthode ne parvient pas à déterminer un correctif d’emplacement valide plus souvent que lors du premier plan. Les applications en arrière-plan peuvent être limitées dans leur emplacement d’accès à un certain degré.

La demande d’emplacement donnée peut être utilisée pour fournir des conseils sur la façon dont un nouvel emplacement est calculé si nécessaire. En particulier LocationRequest#getDurationMillis() , vous pouvez utiliser pour fournir une durée maximale autorisée avant l’échec. Le système limite toujours la durée maximale pendant laquelle une demande d’emplacement actuel peut s’exécuter sur une valeur raisonnable (moins d’une minute par exemple) avant l’échec de la requête.

Documentation Java pour android.location.LocationManager.getCurrentLocation(java.lang.String, android.location.LocationRequest, android.os.CancellationSignal, java.util.concurrent.Executor, java.util.function.Consumer<android.location.Location>).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer)

Retourne de façon asynchrone un correctif d’emplacement actuel unique à partir du fournisseur donné.

[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

Paramètres

provider

String

un fournisseur répertorié par #getAllProviders()

cancellationSignal

CancellationSignal

signal facultatif qui autorise l’annulation de cet appel

executor

IExecutor

le rappel aura lieu sur ce Executor

consumer

IConsumer

le rappel appelé avec une Location ou une valeur Null

Attributs

RegisterAttribute

Remarques

Retourne de façon asynchrone un correctif d’emplacement actuel unique à partir du fournisseur donné.

Consultez la rubrique #getCurrentLocation(String, LocationRequest, CancellationSignal, Executor, Consumer) (éventuellement en anglais) pour plus d’informations.

Documentation Java pour android.location.LocationManager.getCurrentLocation(java.lang.String, android.os.CancellationSignal, java.util.concurrent.Executor, java.util.function.Consumer<android.location.Location>).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.