Location 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
代表地理位置的資料類別。
[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
- 繼承
- 屬性
- 實作
備註
代表地理位置的資料類別。 位置是由緯度、經度、時間戳記、精確度和其他資訊所組成,例如承載、高度和速度。
透過 產生的 LocationManager
所有位置都保證具有有效的緯度、經度、時間戳記 (Unix epoch 時間和自開機) 和精確度以來經過的即時時間。 所有其他參數都是選擇性的。
<p class=「note」 > 請注意,Android 可讓應用程式透過 提交「模擬」或假的位置 LocationManager
,然後使用 LocationManager 來取得位置資訊的應用程式即可接收這些位置。 這些位置可以透過 #isMock()
API 來識別。 想要判斷指定位置是否代表裝置實際位置的最佳估計值,而不是來自另一個應用程式或使用者應該使用此 API 的假位置。 請記住,使用者可能會有模擬其位置的好理由,因此應用程式通常只有在接受實際位置時才應該拒絕模擬位置。
的 android.location.Location
JAVA 檔。
此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改,並根據中所述的詞彙使用。
建構函式
Location(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。 |
Location(Location) |
建構從指定位置複製的新位置。 |
Location(String) |
使用具名提供者建構新的位置。 |
屬性
Accuracy |
傳回此位置計量中,第 68 個百分位數信賴等級的估計水準精確度半徑。 -或- 以這個位置的公尺設定水準精確度。 |
Altitude |
此位置的高度,以公尺為單位高於 WGS84 參考橢圓體。 -或- 將這個位置的高度設定為 WGS84 參考橢圓形上方的公尺。 |
Bearing |
傳回此位置時以度為單位的承載。 -或- 以度為單位,在此位置時設定承載。 |
BearingAccuracyDegrees |
傳回此位置第 68 個百分位數信賴等級的估計承載精確度。 -或- 以這個位置的程度設定承載精確度。 |
Class |
傳回這個 |
Creator | |
ElapsedRealtimeAgeMillis |
根據目前經過的即時時間,以毫秒為單位傳回此位置的存留期的便利方法。 |
ElapsedRealtimeMillis |
從系統開機後,以毫秒為單位傳回此修正程式的時間。 |
ElapsedRealtimeNanos |
從系統開機後,以奈秒為單位傳回此修正程式的時間。 -或- 在系統開機後,以奈秒為單位設定此位置的時間。 |
ElapsedRealtimeUncertaintyNanos |
在第 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 |
傳回這個位置修正的 Unix epoch 時間,以毫秒為單位,自 Unix epoch (00:00:00:00 1970 UTC) 起。 -或- 設定此位置修正的 Unix epoch 時間,以毫秒為單位,自 Unix epoch (00:00:00 1970 UTC) 起。 |
VerticalAccuracyMeters |
傳回此位置計量中,第 68 個百分位數信賴等級的估計高度精確度。 -或- 以公尺設定此位置的高度精確度。 |
方法
BearingTo(Location) |
當沿著這個位置與指定位置之間的最短路徑移動時,傳回以 true 北 的度為單位的近似初始承載。 |
Clone() |
建立並傳回這個 物件的複本。 (繼承來源 Object) |
Convert(Double, Format) |
將緯度/經度座標轉換成字串表示。 |
Convert(String) |
將 、 |
DescribeContents() |
描述這個可封送處理標記法中包含的特殊物件種類。 |
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 > notified < /em > 或 < em > interrupted < /em > 來喚醒。 (繼承來源 Object) |
Wait(Int64) |
讓目前的執行緒等到喚醒為止,通常是 < 透過 em > notified < /em 或 em > interrupted < /em >> ,或 < 直到經過一定數量的即時為止。 (繼承來源 Object) |
Wait(Int64, Int32) |
讓目前的執行緒等到喚醒為止,通常是 < 透過 em > notified < /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) |
代表地理位置的資料類別。 |