LocationManager.GetCurrentLocation メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer) |
指定されたプロバイダーから、特定の場所に基づいて 1 つの現在の場所の修正プログラムを非同期的に |
GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer) |
指定されたプロバイダーから 1 つの現在の場所の修正プログラムを非同期的に返します。 |
GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer)
指定されたプロバイダーから、特定の場所に基づいて 1 つの現在の場所の修正プログラムを非同期的に 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
パラメーター
- provider
- String
プロバイダーの一覧 #getAllProviders()
- locationRequest
- LocationRequest
場所パラメーターを含む場所要求
- cancellationSignal
- CancellationSignal
この呼び出しをキャンセルできるオプションのシグナル
- executor
- IExecutor
コールバックはこれに対して行われます Executor
- consumer
- IConsumer
a Location
または null で呼び出されたコールバック
- 属性
注釈
指定されたプロバイダーから、特定の場所に基づいて 1 つの現在の場所の修正プログラムを非同期的に LocationRequest
返します。 これにより、新しい場所を計算するためにセンサーがアクティブになる場合があります。これは、キャッシュされた修正プログラム (使用可能な場合のみ) を返す場合とは異なります #getLastKnownLocation(String)
。 指定されたコールバックは、有効な場所を使用するか、プロバイダーが有効な場所を生成できなかった場合は null の場所で、1 回だけ呼び出されます。
クライアントはオプション CancellationSignal
を指定できます。 これを使用して操作を取り消す場合は、取り消し後にコールバックを行う必要はありません。
このメソッドは、(数秒の順序で) 最新の過去の場所を返す場合がありますが、古い場所 (たとえば、数分前または古い場所) は返されません。 クライアントは、このメソッドが場所を返す場合、現在のデバイスの場所の最適な推定を表すという保証に依存する場合があります。
バックグラウンドからこのメソッドを呼び出しているクライアントは、メソッドがフォアグラウンドの間よりも頻繁に有効な場所の修正プログラムを決定できないことに気付く場合があります。 バックグラウンド アプリケーションは、ある程度の場所へのアクセスで調整される可能性があります。
指定された場所要求を使用して、必要に応じて新しい場所を計算する方法に関するヒントを提供できます。 特に LocationRequest#getDurationMillis()
、失敗するまでの最大期間を指定するために使用できます。 システムは、現在の場所に対する要求が実行される可能性のある最大時間を、要求が失敗するまでの妥当な値 (たとえば 1 分未満) に常に上限を設定します。
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。
適用対象
GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer)
指定されたプロバイダーから 1 つの現在の場所の修正プログラムを非同期的に返します。
[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
パラメーター
- provider
- String
プロバイダーの一覧 #getAllProviders()
- cancellationSignal
- CancellationSignal
この呼び出しをキャンセルできるオプションのシグナル
- executor
- IExecutor
コールバックはこれに対して行われます Executor
- consumer
- IConsumer
a Location
または null で呼び出されたコールバック
- 属性
注釈
指定されたプロバイダーから 1 つの現在の場所の修正プログラムを非同期的に返します。
詳細については、「 #getCurrentLocation(String, LocationRequest, CancellationSignal, Executor, Consumer)
」を参照してください。
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。