LocationManager.GetCurrentLocation 方法

参考

定义

命名空间:: Android.Locations

程序集:: Mono.Android.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer)	基于给定 `LocationRequest`的提供程序异步返回单个当前位置修复。
GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer)	从给定提供程序异步返回单个当前位置修复。

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

基于给定 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 调用的回调

属性: RegisterAttribute

注解

基于给定 LocationRequest的提供程序异步返回单个当前位置修复。这可能会激活传感器以计算新位置，这与不同 #getLastKnownLocation(String)，仅返回缓存的修补程序（如果可用）。如果提供程序无法生成有效位置，则将调用给定回调的一次和一次，或者具有 null 位置。

客户端可以提供可选的 CancellationSignal。如果用于取消操作，则取消后不应有回调。

此方法可能从最近的位置（按几秒钟的顺序返回位置），但永远不会返回较旧的位置（例如，几分钟旧或较旧）。客户端可能依赖于保证，如果此方法返回某个位置，它将表示当前设备位置的最佳估计值。

从后台调用此方法的客户端可能会注意到该方法无法确定有效位置修复的频率高于前台。后台应用程序可能会受到某种程度的位置访问限制。

给定的位置请求可用于提供有关如何在必要时计算新位置的提示。具体而言 LocationRequest#getDurationMillis() ，可用于提供在失败之前允许的最大持续时间。在请求失败之前，系统始终将请求请求的最大时间上限为一些合理的值（例如，小于一分钟）。

适用于 . 的 android.location.LocationManager.getCurrentLocation(java.lang.String, android.location.LocationRequest, android.os.CancellationSignal, java.util.concurrent.Executor, java.util.function.Consumer<android.location.Location>)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer)

从给定提供程序异步返回单个当前位置修复。

[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