LocationManager 类

定义

此类提供对系统位置服务的访问权限。

[Android.Runtime.Register("android/location/LocationManager", DoNotGenerateAcw=true)]
public class LocationManager : Java.Lang.Object
[<Android.Runtime.Register("android/location/LocationManager", DoNotGenerateAcw=true)>]
type LocationManager = class
    inherit Object
继承
LocationManager
属性

注解

此类提供对系统位置服务的访问权限。 这些服务允许应用程序获取设备的地理位置的定期更新,或者在设备进入给定地理位置附近时收到通知。

<p class=“note”>除非另有说明,否则所有 Location API 方法都需要 android.Manifest.permission#ACCESS_COARSE_LOCATIONandroid.Manifest.permission#ACCESS_FINE_LOCATION 权限。 如果应用程序只有粗略的权限,则提供程序仍会返回位置结果,但确切的位置将被模糊化为粗略的准确度级别。

适用于 . 的 android.location.LocationManagerJava 文档

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

构造函数

LocationManager(IntPtr, JniHandleOwnership)

创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。

字段

ActionGnssCapabilitiesChanged

当 GNSS 功能发生更改时广播意向操作。

ExtraGnssCapabilities

包含新的GnssCapabilities广播的额外#ACTION_GNSS_CAPABILITIES_CHANGED意向。

ExtraLocationEnabled

在广播中 #MODE_CHANGED_ACTION 额外包含意向,其中包含启用了布尔值的位置状态。

ExtraProviderEnabled

广播中额外包含的 #PROVIDERS_CHANGED_ACTION 意向,包含已更改的位置提供程序的布尔启用状态。

ExtraProviderName

包含广播的额外 #PROVIDERS_CHANGED_ACTION 意向,包含已更改的位置提供程序的名称。

FusedProvider

融合位置提供程序的标准名称。

GpsProvider

GNSS 位置提供程序的标准名称。

KeyFlushComplete

当使用 PendingIntent 发送位置刷新完成时,用于额外保存整数请求代码的键。

KeyLocationChanged

当使用 PendingIntent 发送位置更改时,用于额外保存 Location 值的键。

KeyLocations

当使用 PendingIntent 发送位置更改时,用于额外保存 s 数组 Location的键。

KeyProviderEnabled

当提供程序启用/禁用事件使用 PendingIntent 广播时,用于额外保存布尔启用/禁用状态值的密钥。

KeyProximityEntering

用于捆绑包额外保存布尔值(指示邻近感应警报是进入(true)还是退出(false)的键。

KeyStatusChanged

此密钥不再使用。

ModeChangedAction

启用设备位置状态更改时广播意向操作。

NetworkProvider

网络位置提供程序的标准名称。

PassiveProvider

用于接收位置的特殊位置提供程序,无需主动启动位置修复。

ProvidersChangedAction

启用的位置提供程序集更改时广播意向操作。

属性

AllProviders

返回所有可用位置提供程序的名称的列表。

Class

返回此 Object的运行时类。

(继承自 Object)
GnssAntennaInfos

返回当前 GNSS 天线信息列表;如果未知或不受支持,则返回 null。

GnssCapabilities

返回 GNSS 芯片集支持的功能。

GnssHardwareModelName

返回 GNSS 硬件驱动程序的模型名称(包括供应商和硬件/软件版本),如果此信息不可用,则返回 null。

GnssYearOfHardware

返回 GNSS 硬件和软件版本的模型年,如果模型年份在 2016 年之前,则返回 0。

Handle

基础 Android 实例的句柄。

(继承自 Object)
IsLocationEnabled

返回当前启用/禁用的位置状态。

JniIdentityHashCode

此类提供对系统位置服务的访问权限。

(继承自 Object)
JniPeerMembers

此类提供对系统位置服务的访问权限。

PeerReference

此类提供对系统位置服务的访问权限。

(继承自 Object)
ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

方法

AddGpsStatusListener(GpsStatus+IListener)

添加 GPS 状态侦听器。

AddNmeaListener(GpsStatus+INmeaListener)

用于保持向后兼容性的 No-op 方法。

AddNmeaListener(IExecutor, IOnNmeaMessageListener)

添加 NMEA 侦听器。

AddNmeaListener(IOnNmeaMessageListener)

添加 NMEA 侦听器。

AddNmeaListener(IOnNmeaMessageListener, Handler)

添加 NMEA 侦听器。

AddProximityAlert(Double, Double, Single, Int64, PendingIntent)

为位置(纬度、经度)和给定半径提供的位置设置邻近感应警报。

AddTestProvider(String, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Power, SensorStatus)

创建测试位置提供程序并将其添加到活动提供程序集。

AddTestProvider(String, ProviderProperties)

创建测试位置提供程序并将其添加到活动提供程序集。

AddTestProvider(String, ProviderProperties, ICollection<String>)

创建测试位置提供程序并将其添加到活动提供程序集。

ClearTestProviderEnabled(String)

等效于调用 #setTestProviderEnabled(String, boolean) 以禁用测试提供程序。

ClearTestProviderLocation(String)

不执行任何操作。

ClearTestProviderStatus(String)

此方法不起作用,因为提供程序状态已被弃用,不再受支持。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Dispose()

此类提供对系统位置服务的访问权限。

(继承自 Object)
Dispose(Boolean)

此类提供对系统位置服务的访问权限。

(继承自 Object)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
FromContext(Context)

此类提供对系统位置服务的访问权限。

GetBestProvider(Criteria, Boolean)

返回最符合给定条件的提供程序的名称。

GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer)

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

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

基于给定 LocationRequest的提供程序异步返回单个当前位置修复。

GetGpsStatus(GpsStatus)

检索有关 GPS 引擎的当前状态的信息。

GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
GetLastKnownLocation(String)

从给定提供程序获取最后一个已知位置,如果没有最后一个已知位置,则为 null。

GetProvider(String)

返回有关具有给定名称的位置提供程序的信息,如果该名称不存在提供程序,则返回 null。

GetProviderProperties(String)

返回给定提供程序的属性;如果属性当前未知,则返回 null。

GetProviders(Boolean)

返回可用位置提供程序的名称的列表。

GetProviders(Criteria, Boolean)

返回满足给定条件的可用位置提供程序的名称的列表。

HasProvider(String)

如果此设备上存在给定的位置提供程序,则返回 true,而不考虑它当前是否已启用。

IsProviderEnabled(String)

返回给定提供程序的当前启用/禁用状态。

JavaFinalize()

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
RegisterAntennaInfoListener(IExecutor, GnssAntennaInfo+IListener)

注册 GNSS 天线信息侦听器,它将接收天线信息的所有更改。

RegisterGnssMeasurementsCallback(GnssMeasurementRequest, IExecutor, GnssMeasurementsEvent+Callback)

注册将在绑定器线程上运行的 GNSS 度量回调。

RegisterGnssMeasurementsCallback(GnssMeasurementsEvent+Callback)

注册将在绑定器线程上运行的 GNSS 度量回调。

RegisterGnssMeasurementsCallback(GnssMeasurementsEvent+Callback, Handler)

注册将在绑定器线程上运行的 GNSS 度量回调。

RegisterGnssMeasurementsCallback(IExecutor, GnssMeasurementsEvent+Callback)

注册将在绑定器线程上运行的 GNSS 度量回调。

RegisterGnssNavigationMessageCallback(GnssNavigationMessage+Callback)

注册将在绑定器线程上运行的 GNSS 导航消息回调。

RegisterGnssNavigationMessageCallback(GnssNavigationMessage+Callback, Handler)

注册将在绑定器线程上运行的 GNSS 导航消息回调。

RegisterGnssNavigationMessageCallback(IExecutor, GnssNavigationMessage+Callback)

注册将在绑定器线程上运行的 GNSS 导航消息回调。

RegisterGnssStatusCallback(GnssStatus+Callback)

注册 GNSS 状态回调。

RegisterGnssStatusCallback(GnssStatus+Callback, Handler)

注册 GNSS 状态回调。

RegisterGnssStatusCallback(IExecutor, GnssStatus+Callback)

注册 GNSS 状态回调。

RemoveGpsStatusListener(GpsStatus+IListener)

删除 GPS 状态侦听器。

RemoveNmeaListener(GpsStatus+INmeaListener)

用于保持向后兼容性的 No-op 方法。

RemoveNmeaListener(IOnNmeaMessageListener)

删除 NMEA 侦听器。

RemoveProximityAlert(PendingIntent)

删除具有给定 PendingIntent 的邻近感应警报。

RemoveTestProvider(String)

删除具有给定名称的测试位置提供程序,如果没有此类测试位置提供程序,则不执行任何操作。

RemoveUpdates(ILocationListener)

删除指定 LocationListener的所有位置更新。

RemoveUpdates(PendingIntent)

删除指定 PendingIntent的位置更新。

RequestFlush(String, ILocationListener, Int32)

请求给定提供程序将任何批处理位置刷新到侦听器。

RequestFlush(String, PendingIntent, Int32)

请求给定提供程序将任何批处理位置刷新到侦听器。

RequestLocationUpdates(Int64, Single, Criteria, IExecutor, ILocationListener)

使用通过给定条件选择的提供程序和指定 Executor回调注册位置更新。

RequestLocationUpdates(Int64, Single, Criteria, ILocationListener, Looper)

使用通过给定条件选择的提供程序和指定 Looper回调注册位置更新。

RequestLocationUpdates(Int64, Single, Criteria, PendingIntent)

使用通过给定条件选择的提供程序和通过提供的 PendingIntent回调注册位置更新。

RequestLocationUpdates(String, Int64, Single, IExecutor, ILocationListener)

使用命名提供程序注册位置更新,并在指定的 Executor提供程序上注册回调。

RequestLocationUpdates(String, Int64, Single, ILocationListener)

使用给定参数注册给定提供程序的位置更新,并在调用线程上 Looper 注册回调。

RequestLocationUpdates(String, Int64, Single, ILocationListener, Looper)

使用给定参数注册给定提供程序的位置更新,以及指定 Looper参数的回调。

RequestLocationUpdates(String, Int64, Single, PendingIntent)

使用命名提供程序注册位置更新,并通过提供的 PendingIntent回调进行传递。

RequestLocationUpdates(String, LocationRequest, IExecutor, ILocationListener)

使用 LocationRequest指定提供程序和指定 Executor回调注册位置更新。

RequestLocationUpdates(String, LocationRequest, PendingIntent)

使用 LocationRequest提供的 PendingIntent和回调从指定的提供程序注册位置更新。

RequestSingleUpdate(Criteria, ILocationListener, Looper)

使用条件和回调注册单个位置更新。

RequestSingleUpdate(Criteria, PendingIntent)

使用 Criteria 和挂起意向注册单个位置更新。

RequestSingleUpdate(String, ILocationListener, Looper)

使用命名提供程序和回调注册单个位置更新。

RequestSingleUpdate(String, PendingIntent)

使用命名提供程序和挂起的意向注册单个位置更新。

SendExtraCommand(String, String, Bundle)

将其他命令发送到位置提供程序。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetTestProviderEnabled(String, Boolean)

设置要启用或禁用的给定测试提供程序。

SetTestProviderLocation(String, Location)

设置给定测试提供程序的新位置。

SetTestProviderStatus(String, Availability, Bundle, Int64)

此方法不起作用,因为提供程序状态已被弃用,不再受支持。

ToArray<T>()

此类提供对系统位置服务的访问权限。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterAntennaInfoListener(GnssAntennaInfo+IListener)

取消注册 GNSS 天线信息侦听器。

UnregisterFromRuntime()

此类提供对系统位置服务的访问权限。

(继承自 Object)
UnregisterGnssMeasurementsCallback(GnssMeasurementsEvent+Callback)

取消注册 GPS 度量回调。

UnregisterGnssNavigationMessageCallback(GnssNavigationMessage+Callback)

取消注册 GNSS 导航消息回调。

UnregisterGnssStatusCallback(GnssStatus+Callback)

删除 GNSS 状态回调。

Wait()

使当前线程等待,直到唤醒它,通常是通过 em 通知/em> 或 <em>interrupted</em>。<><

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted</em>>,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted</em>>,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

IJavaPeerable.Disposed()

此类提供对系统位置服务的访问权限。

(继承自 Object)
IJavaPeerable.DisposeUnlessReferenced()

此类提供对系统位置服务的访问权限。

(继承自 Object)
IJavaPeerable.Finalized()

此类提供对系统位置服务的访问权限。

(继承自 Object)
IJavaPeerable.JniManagedPeerState

此类提供对系统位置服务的访问权限。

(继承自 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

此类提供对系统位置服务的访问权限。

(继承自 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

此类提供对系统位置服务的访问权限。

(继承自 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

此类提供对系统位置服务的访问权限。

(继承自 Object)

扩展方法

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

此类提供对系统位置服务的访问权限。

GetJniTypeName(IJavaPeerable)

此类提供对系统位置服务的访问权限。

适用于