LocationManager.GetCurrentLocation メソッド

[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

パラメーター

属性

RegisterAttribute

注釈

指定した LocationRequestに基づいて、特定のプロバイダーから 1 つの現在の場所の修正プログラムを非同期的に返します。 これにより、 #getLastKnownLocation(String)とは異なり、新しい場所を計算するためにセンサーがアクティブになる場合があります。これは、キャッシュされた修正プログラムが使用可能な場合にのみ返されます。 指定されたコールバックは、有効な場所を使用するか、プロバイダーが有効な場所を生成できなかった場合は null の場所で、1 回だけ呼び出されます。

クライアントはオプションの CancellationSignalを提供できます。 これを使用して操作を取り消す場合は、取り消し後にコールバックは必要ありません。

このメソッドは、(数秒の順序で) 最新の過去の場所を返す場合がありますが、古い場所 (たとえば、数分前または古い場所) は返されません。 クライアントは、このメソッドが場所を返す場合、現在のデバイスの場所の最適な推定を表すという保証に依存する場合があります。

バックグラウンドからこのメソッドを呼び出しているクライアントは、メソッドがフォアグラウンドの間よりも頻繁に有効な場所の修正プログラムを決定できないことに気付く場合があります。 バックグラウンド アプリケーションは、ある程度の場所へのアクセスで調整される可能性があります。

指定された場所要求を使用して、必要に応じて新しい場所を計算する方法に関するヒントを提供できます。 特に、 LocationRequest#getDurationMillis() を使用して、障害が発生する前に許可される最大期間を指定できます。 システムは、現在の場所に対する要求が実行される可能性のある最大時間を、要求が失敗するまでの妥当な値 (たとえば 1 分未満) に常に上限を設定します。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

[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

パラメーター

属性

RegisterAttribute

注釈

指定されたプロバイダーから 1 つの現在の場所の修正プログラムを非同期的に返します。

詳細については、#getCurrentLocation(String, LocationRequest, CancellationSignal, Executor, Consumer) を参照してください。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。