Location 类

定义

命名空间:

Android.Locations

程序集:

Mono.Android.dll

表示地理位置的数据类。

[Android.Runtime.Register("android/location/Location", DoNotGenerateAcw=true)]
public class Location : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/location/Location", DoNotGenerateAcw=true)>]
type Location = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

继承

Object

Object

Location

属性

RegisterAttribute

实现

IParcelable IJavaObject IJavaPeerable IDisposable

注解

表示地理位置的数据类。 位置由纬度、经度、时间戳、准确性和其他信息（如轴承、高度和速度）组成。

通过 LocationManager 生成的所有位置都保证具有有效的纬度、经度、时间戳 (Unix 纪元时间和自启动) 以来经过的实时时间以及准确性。 其他所有参数都是可选参数。

<p class=“note”注意“>请注意，Android 为应用程序提供了通过 LocationManager提交”模拟“或伪造位置的功能，然后应用程序可以使用 LocationManager 接收这些位置以获取位置信息。 可以通过 API 识别 #isMock() 这些位置。 希望确定给定位置是否表示设备真实位置的最佳估计值，而不是来自另一个应用程序或用户虚假位置的应用程序应使用此 API。 请记住，用户可能有充分的理由模拟其位置，因此应用通常应仅当仅接受真实位置的用例时才应拒绝模拟位置。

的 android.location.LocationJava 文档。

此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。

构造函数

Location(IntPtr, JniHandleOwnership)	创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。
Location(Location)	构造从给定位置复制的新位置。
Location(String)	使用命名提供程序构造新位置。

属性

Accuracy	在第 68 个百分位置信度级别返回此位置的估计水平精度半径（以米为单位）。 - 或 - 设置此位置的水平精度（以米为单位）。
Altitude	此位置的海拔高度（以 WGS84 参考椭圆体上方的米为单位）。 - 或 - 将此位置的海拔高度设置为 WGS84 参考椭圆体上方的米。
Bearing	以度为单位返回此位置时的轴承。 - 或 - 在此位置时设置轴承（以度为单位）。
BearingAccuracyDegrees	在第 68 个百分位置信度级别返回此位置的估计轴承精度（以度为单位）。 - 或 - 以此位置的度数设置轴承精度。
Class	返回此 Object的运行时类。 (继承自 Object)
Creator
ElapsedRealtimeAgeMillis	一种便捷方法，返回此位置相对于当前经过的实时时间的期限（以毫秒为单位）。
ElapsedRealtimeMillis	返回此修复的时间，以毫秒为单位的自系统启动以来的实时运行时间。
ElapsedRealtimeNanos	返回此修复的时间（以纳秒为单位）自系统启动以来的已用实时时间。 - 或 - 设置此位置的时间（自系统启动以来已用的实时时间纳秒）。
ElapsedRealtimeUncertaintyNanos	在第 68 个百分位置信度级别获取 的 #getElapsedRealtimeNanos() 精度的纳秒的不确定性。 - 或 - 以 68% 置信度设置经过的实时时间戳精度的不确定性（以纳秒为单位）。
Extras	返回与此位置关联的附加信息的可选捆绑包。 - 或 - 将与此修补程序关联的额外信息设置为给定捆绑包。
Handle	基础 Android 实例的句柄。 (继承自 Object)
HasAccuracy	如果此位置具有水平精度，则返回 true;否则返回 false。
HasAltitude	如果此位置具有海拔高度，则返回 true;否则返回 false。
HasBearing	如果此位置有轴承，则为 True;否则为 false。
HasBearingAccuracy	如果此位置具有轴承精度，则返回 true;否则返回 false。
HasElapsedRealtimeUncertaintyNanos	如果此位置具有经过的实时不确定性，则为 True;否则为 false。
HasMslAltitude	如果此位置具有平均海平面高度，则返回 true;否则返回 false。
HasMslAltitudeAccuracy	如果此位置具有平均海平面高度准确度，则返回 true;否则返回 false。
HasSpeed	如果此位置具有速度，则为 True;否则为 false。
HasSpeedAccuracy	如果此位置具有速度准确性，则返回 true;否则返回 false。
HasVerticalAccuracy	如果此位置具有垂直精度，则返回 true;否则返回 false。
IsComplete	如果此位置被视为已完成，则返回 true。
IsFromMockProvider	如果这是模拟位置，则返回 true。
JniIdentityHashCode	表示地理位置的数据类。 (继承自 Object)
JniPeerMembers	表示地理位置的数据类。
Latitude	获取纬度（以度为单位）。 - 或 - 设置此位置的纬度。
Longitude	获取经度（以度为单位）。 -或 - 设置此位置的经度。
Mock	如果此位置标记为模拟位置，则返回 true。 - 或 - 设置此位置是否标记为模拟位置。
MslAltitudeAccuracyMeters	在第 68 个百分位置信度级别返回此位置的估计平均海平面高度精度（以米为单位）。 - 或 - 设置此位置的平均海平面高度精度（以米为单位）。
MslAltitudeMeters	返回此位置的平均海平面高度（以米为单位）。 - 或 - 设置此位置的平均海平面高度（以米为单位）。
PeerReference	表示地理位置的数据类。 (继承自 Object)
Provider	返回与此位置关联的提供程序的名称。 - 或 - 设置与此位置关联的提供程序的名称
Speed	返回此位置时的速度（以米/秒为单位）。 - 或 - 设置此位置时的速度（以米/秒为单位）。
SpeedAccuracyMetersPerSecond	在第 68 个百分位置信度级别返回此位置的估计速度精度（以米/秒为单位）。 - 或 - 设置此位置的速度精度（以米/秒为单位）。
ThresholdClass	此 API 支持 Mono for Android 基础结构，不应直接从代码使用。
ThresholdType	此 API 支持 Mono for Android 基础结构，不应直接从代码使用。
Time	返回自 1970 年 1 月 1 日 UTC () 00：00：00 Unix 纪元开始以来此位置修复的 Unix 纪元时间（以毫秒为单位）。 - 或 - 设置此位置修复的 Unix 纪元时间，以毫秒为单位，自 Unix epoch (00：00：00 00 1970 年 1 月 1 日 UTC) 。
VerticalAccuracyMeters	在第 68 个百分位置信度级别返回此位置的估计高度精度（以米为单位）。 - 或 - 设置此位置的高度精度（以米为单位）。

方法

BearingTo(Location)	沿此位置与给定位置之间的最短路径行进时，返回以真正北向以东度为单位的近似初始轴承。
Clone()	创建并返回此对象的副本。 (继承自 Object)
Convert(Double, Format)	将纬度/经度坐标转换为字符串表示形式。
Convert(String)	以 、 #FORMAT_MINUTES或 #FORMAT_SECONDS 描述#FORMAT_DEGREES的格式之一将字符串转换为双精度值。
DescribeContents()	描述此 Parcelable 封送表示形式中包含的特殊对象类型。
Dispose()	表示地理位置的数据类。 (继承自 Object)
Dispose(Boolean)	表示地理位置的数据类。 (继承自 Object)
DistanceBetween(Double, Double, Double, Double, Single[])	计算两个位置之间的近似距离（以米为单位），并根据需要计算它们之间最短路径的初始和最终轴承。
DistanceTo(Location)	返回此位置与给定位置之间的近似距离（以米为单位）。
Dump(IPrinter, String)	将位置信息转储到给定的打印机。
Equals(Object)	指示其他某个对象是否“等于”此对象。 (继承自 Object)
GetElapsedRealtimeAgeMillis(Int64)	一种便捷方法，用于返回相对于给定引用的实时使用时间的此位置的期限。
GetHashCode()	返回对象的哈希代码值。 (继承自 Object)
JavaFinalize()	当垃圾回收确定不再引用对象时，由对象上的垃圾回收器调用。 (继承自 Object)
Notify()	唤醒正在等待此对象的监视器的单个线程。 (继承自 Object)
NotifyAll()	唤醒正在等待此对象的监视器的所有线程。 (继承自 Object)
RemoveAccuracy()	从此位置删除水平精度。
RemoveAltitude()	从此位置删除海拔高度。
RemoveBearing()	从此位置移除轴承。
RemoveBearingAccuracy()	从此位置删除轴承精度。
RemoveElapsedRealtimeUncertaintyNanos()	从此位置删除经过的实时不确定性。
RemoveMslAltitude()	从此位置删除平均海平面高度。
RemoveMslAltitudeAccuracy()	从此位置删除平均海平面高度准确度。
RemoveSpeed()	从此位置删除速度。
RemoveSpeedAccuracy()	从此位置删除速度准确性。
RemoveVerticalAccuracy()	从此位置删除垂直精度。
Reset()	将提供程序设置为 null，删除所有可选字段，并将所有其他字段的值设置为零。
Set(Location)	将此位置转换为给定位置的副本。
SetHandle(IntPtr, JniHandleOwnership)	设置 Handle 属性。 (继承自 Object)
ToArray<T>()	表示地理位置的数据类。 (继承自 Object)
ToString()	返回对象的字符串表示形式。 (继承自 Object)
UnregisterFromRuntime()	表示地理位置的数据类。 (继承自 Object)
Wait()	导致当前线程等待，直到它被唤醒，通常是通过 em <通知/em> 或 <em>interrupted</em>。<> (继承自 Object)
Wait(Int64)	导致当前线程等待，直到它被唤醒，通常是通过 em <通知/em> 或 <em>interrupted</em>，或直到经过一定数量的实时。<> (继承自 Object)
Wait(Int64, Int32)	导致当前线程等待，直到它被唤醒，通常是通过 em <通知/em> 或 <em>interrupted</em>，或直到经过一定数量的实时。<> (继承自 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	将此对象平展为包裹。

显式接口实现

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)	表示地理位置的数据类。