Location 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
一個代表地理位置的資料類別。
[Android.Runtime.Register("android/location/Location", DoNotGenerateAcw=true)]
public class Location : Java.Lang.Object, Android.OS.IParcelable, IDisposable[<Android.Runtime.Register("android/location/Location", DoNotGenerateAcw=true)>]
type Location = class
inherit Object
interface IParcelable
interface IJavaObject
interface IDisposable
interface IJavaPeerable- 繼承
- 屬性
- 實作
備註
一個代表地理位置的資料類別。 一個位置包含緯度、經度、時間戳記、精確度，以及其他資訊，如方位、高度和速度。
所有透過 LocationManager 此產生的位置都保證具有有效的緯度、經度、時間戳記（包括 Unix 的紀元時間及自開機以來的經過時間）及準確度。 所有其他參數皆為選擇性使用。
請注意，Android 提供應用程式透過 提交「模擬」或偽造位置 LocationManager的功能，這些位置可透過 LocationManager 被應用程式接收以取得位置資訊。 這些位置可透過 #isMock() API 識別。 想要判斷某個位置是否代表裝置真實位置的最佳估計，而非來自其他應用程式的假位置的應用程式，或使用者應使用此 API。 請記住，使用者可能有充分理由去模擬他們的位置，因此應用程式通常只會在必須只接受真實位置時才會拒絕模擬位置。
Java 文件 android.location.Location。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| Location(IntPtr, JniHandleOwnership) |
用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。 |
| Location(Location) |
從指定地點複製一個新地點。 |
| Location(String) |
建立一個帶有命名提供者的新地點。 |
屬性
| 名稱 | Description |
|---|---|
| Accuracy |
回傳該位置在第68百分位置信水準下的估計水平準確半徑（公尺）。 -或- 將該位置的水平精度設定為公尺。 |
| Altitude |
此地點的高度（以公尺計）高於WGS84參考橢球體。 -或- 將此位置的高度設定為WGS84參考橢球體上方公尺。 |
| Bearing |
回傳該位置時的方位數（度數）。 -或- 將方位設定在此位置的位置，以度數為單位。 |
| BearingAccuracyDegrees |
回傳該位置在第68百分位信賴水準下以度數計算的估計方位精度。 -或- 將方位精度設定為該位置的度數。 |
| Class |
回傳此 |
| Creator | |
| ElapsedRealtimeAgeMillis |
一種方便的方法，會回傳該位置相對於當前經過的實時時間，以毫秒為單位的年齡。 |
| ElapsedRealtimeMillis |
回傳此修正的時間，單位是系統開機後經過的毫秒即時時間。 |
| ElapsedRealtimeNanos |
回傳此修正的時間，單位為系統開機後經過的奈秒即時時間。 -或- 將該位置的時間設定為系統啟動後經過的奈秒實時時間。 |
| ElapsedRealtimeUncertaintyNanos |
在第68百分位信心水準下，以奈秒 |
| Extras |
回傳與此地點相關的額外資訊包。 -或- 將與此固定相關的額外資訊設定到給定的 Bundle。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| HasAccuracy |
若該位置具有水平精度，則回傳真，否則為假。 |
| HasAltitude |
若該位置有高度，則回傳真，否則為假。 |
| HasBearing |
若該位置有方位，則為真;否則為假。 |
| HasBearingAccuracy |
如果該位置有方位精度，則返回真;否則為假。 |
| HasElapsedRealtimeUncertaintyNanos |
若該位置有經過的即時不確定性，則為真;否則為假。 |
| HasMslAltitude |
若該地點具有平均海平面高度，則回傳為真;若不高，則為假。 |
| HasMslAltitudeAccuracy |
如果該地點具有平均海平面高度的精度，則回傳為真;否則為假。 |
| HasSpeed |
如果該位置有速度，則為真;否則為假。 |
| HasSpeedAccuracy |
若該位置有速度精度，則回傳真，否則為假。 |
| HasVerticalAccuracy |
若該位置具有垂直精度，則回傳真;否則為假。 |
| IsComplete |
若該位置被視為完整，則回傳為真。 |
| IsFromMockProvider |
如果這是模擬位置，則回傳為真。 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
一個代表地理位置的資料類別。 (繼承來源 JavaObject) |
| JniPeerMembers |
一個代表地理位置的資料類別。 |
| Latitude |
以度數計算緯度。 -或者- 設定這個地點的緯度。 |
| Longitude |
以度數計算經度。 -或者- 設定這個位置的經度。 |
| Mock |
若該位置被標記為模擬位置，則回傳為 true。 -或- 設定此位置是否標記為模擬位置。 |
| MslAltitudeAccuracyMeters |
回傳該地點在第68百分位信賴水準下，估計的平均海平面高度精度（公尺）。 -或- 設定該地點的平均海平面高度精度，單位為公尺。 |
| MslAltitudeMeters |
回傳該地點的平均海平面高度（以公尺為單位）。 -或- 設定該地點的平均海平面高度（以公尺為單位）。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| Provider |
回傳與該地點關聯的服務提供者名稱。 -或- 設定與此地點相關的提供者名稱 |
| Speed |
回傳該地點當時的速度（以公尺每秒為單位）。 -或- 將該地點的頻率設定為公尺每秒。 |
| SpeedAccuracyMetersPerSecond |
回傳該位置在第68百分位信賴水準下的估計速度精度（公尺每秒）。 -或- 將此位置的速度精度設為公尺每秒。 |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| Time |
回傳此位置修正的 Unix 時代時間，以毫秒計，自 Unix 時代開始（1970 年 1 月 1 日 00：00：00 UTC）起計。 -或- 設定此位置定位的 Unix 歷元時間，以毫秒計，自 Unix 紀元開始（1970 年 1 月 1 日 00：00：00 UTC）起計。 |
| VerticalAccuracyMeters |
回傳該位置在第 68 百分位信賴水準下的估計高度精度（公尺）。 -或者- 將此地點的高度精度設定為公尺。 |
方法
| 名稱 | Description |
|---|---|
| BearingTo(Location) |
當沿著該位置與指定位置之間最短路徑行進時，回傳真北以東的近似初始方位。 |
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
一個代表地理位置的資料類別。 (繼承來源 JavaObject) |
| Convert(Double, Format) |
將緯度/經度座標轉換為字串表示。 |
| Convert(String) |
將以 、 |
| DescribeContents() |
描述此 Parcelable 的組建表示中包含的特殊物件種類。 |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
一個代表地理位置的資料類別。 (繼承來源 JavaObject) |
| DistanceBetween(Double, Double, Double, Double, Single[]) |
計算兩個地點間的近似距離（公尺），並可選擇性地計算兩者間最短路徑的初始與最終方位。 |
| DistanceTo(Location) |
回傳該位置與指定位置之間的近似公尺距離。 |
| Dump(IPrinter, String) |
將位置資訊傾倒給指定的印表機。 |
| Equals(Object) |
一個代表地理位置的資料類別。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| GetElapsedRealtimeAgeMillis(Int64) |
一種方便方法，能回傳該位置相對於給定參考的真實經過時間的年齡。 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| RemoveAccuracy() |
移除這個位置的水平精度。 |
| RemoveAltitude() |
移除了該位置的高度。 |
| RemoveBearing() |
把軸承從這個位置拆下來。 |
| RemoveBearingAccuracy() |
從這個位置移除方位精度。 |
| RemoveElapsedRealtimeUncertaintyNanos() |
這樣可以消除這個位置的經過即時不確定性。 |
| RemoveMslAltitude() |
移除該位置的平均海平面高度。 |
| RemoveMslAltitudeAccuracy() |
移除了該位置的平均海平面高度精度。 |
| RemoveSpeed() |
把這個位置的速球移除。 |
| RemoveSpeedAccuracy() |
移除這個位置的速度精度。 |
| RemoveVerticalAccuracy() |
移除這個位置的垂直精度。 |
| Reset() |
將提供者設為空，移除所有可選欄位，並將其他欄位的值設為零。 |
| Set(Location) |
將該地點變成該地點的複製品。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
一個代表地理位置的資料類別。 (繼承來源 JavaObject) |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| WriteToParcel(Parcel, ParcelableWriteFlags) |
把這個物體壓扁成一個包裹。 |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
一個代表地理位置的資料類別。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
一個代表地理位置的資料類別。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
一個代表地理位置的資料類別。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
一個代表地理位置的資料類別。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
一個代表地理位置的資料類別。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
一個代表地理位置的資料類別。 (繼承來源 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
一個代表地理位置的資料類別。 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
一個代表地理位置的資料類別。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |