LocationManager 類別

定義

命名空間:: Android.Locations

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

此類別提供系統定位服務的存取權限。

[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

繼承: Object

JavaObject

Object
LocationManager

屬性: RegisterAttribute

備註

此類別提供系統定位服務的存取權限。這些服務允許應用程式定期更新裝置的地理位置，或在裝置進入特定地理位置附近時收到通知。

除非另有說明，所有 Location API 方法都需要 android.Manifest.permission#ACCESS_COARSE_LOCATION OR android.Manifest.permission#ACCESS_FINE_LOCATION 權限。如果你的應用程式只有粗略權限，服務提供者仍會回傳位置結果，但確切位置會被模糊到粗略的準確度。

Java 文件 android.location.LocationManager。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
LocationManager(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

欄位

名稱	Description
ActionGnssCapabilitiesChanged	當 GNSS 能力變更時，廣播意圖行動。
ExtraGnssCapabilities	隨廣播附贈`#ACTION_GNSS_CAPABILITIES_CHANGED`的意圖額外內容，包含新的`GnssCapabilities`
ExtraLocationEnabled	意向額外內容隨 `#MODE_CHANGED_ACTION` 廣播一併包含，包含布林值啟用的定位狀態。
ExtraProviderEnabled	Intent extra 隨 `#PROVIDERS_CHANGED_ACTION` 廣播包含，包含位置提供者已變更的布林值啟用狀態。
ExtraProviderName	Intent Extra 隨 `#PROVIDERS_CHANGED_ACTION` 廣播附贈，包含變更的地點供應商名稱。
FusedProvider	融合位置供應商的標準名稱。
GpsProvider	GNSS 定位供應商的標準名稱。
KeyFlushComplete	當位置清空完成時，使用 PendingIntent 傳送時，額外鍵值儲存整數請求碼。
KeyLocationChanged	用於額外金鑰，當位置變更時，透過 `Location` PendingIntent 傳送該值。
KeyLocations	當位置變更透過 PendingIntent 傳送時，額外用於儲存 s 陣列 `Location`的鍵。
KeyProviderEnabled	當使用 PendingIntent 廣播提供者啟用/停用事件時，額外金鑰會顯示布林值啟用/停用狀態值。
KeyProximityEntering	用於 Bundle 額外鍵，該附加元件包含一個布林值，表示接近警報是進入（true）或退出（false）。
KeyStatusChanged	此鑰匙已不再使用。
ModeChangedAction	當裝置位置啟用狀態變更時，廣播意圖動作。
NetworkProvider	網路位置供應商的標準名稱。
PassiveProvider	一個特殊的位置提供者，可在不主動啟動定位修正的情況下接收位置資訊。
ProvidersChangedAction	當啟用的定位提供者集合變更時，廣播意圖行動。

屬性

名稱	Description
AllProviders	回傳所有可用地點供應商的名稱清單。
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
GnssAntennaInfos	回傳目前的 GNSS 天線資訊清單，若未知或不支援則為 null。
GnssCapabilities	回傳 GNSS 晶片組所支援的功能。
GnssHardwareModelName	回傳 GNSS 硬體驅動程式的型號名稱（含廠商及硬體/軟體版本），若無法取得則為空。
GnssYearOfHardware	回傳 GNSS 硬體與軟體組裝的車款年份，若車型年份在 2016 年前則為 0。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
IsLocationEnabled	會回傳目前啟用/停用的位置狀態。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	此類別提供系統定位服務的存取權限。 (繼承來源 JavaObject)
JniPeerMembers	此類別提供系統定位服務的存取權限。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
AddGpsStatusListener(GpsStatus+IListener)	已淘汰. 新增 GPS 狀態監聽器。
AddNmeaListener(GpsStatus+INmeaListener)	已淘汰. 無需操作的方法來維持向下相容性。
AddNmeaListener(IExecutor, IOnNmeaMessageListener)	新增一個 NMEA 監聽器。
AddNmeaListener(IOnNmeaMessageListener, Handler)	新增一個 NMEA 監聽器。
AddNmeaListener(IOnNmeaMessageListener)	新增一個 NMEA 監聽器。
AddProximityAlert(Double, Double, Single, Int64, PendingIntent)	針對位置（緯度、經度）及給定半徑設定接近警報。
AddTestProvider(String, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Power, SensorStatus)	建立一個測試位置提供者，並將其加入活躍提供者集合。
AddTestProvider(String, ProviderProperties, ICollection<String>)	建立一個測試位置提供者，並將其加入活躍提供者集合。
AddTestProvider(String, ProviderProperties)	建立一個測試位置提供者，並將其加入活躍提供者集合。
ClearTestProviderEnabled(String)	相當於呼叫 `#setTestProviderEnabled(String, boolean)` 以停用測試提供者。
ClearTestProviderLocation(String)	沒有任何動作。
ClearTestProviderStatus(String)	此方法無效，因為提供者身份已被棄用且不再支援。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	此類別提供系統定位服務的存取權限。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	此類別提供系統定位服務的存取權限。 (繼承來源 JavaObject)
Equals(Object)	此類別提供系統定位服務的存取權限。 (繼承來源 JavaObject)
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)	從給定提供者取得最後已知位置，若沒有最後已知位置則為空。
GetProvider(String)	回傳帶有該名稱的地點提供者資訊，若無該名稱提供者則為空。
GetProviderProperties(String)	回傳給定提供者的屬性，若屬性目前未知則為 null。
GetProviders(Boolean)	回傳可用位置供應商名稱列表。
GetProviders(Criteria, Boolean)	回傳符合條件的可用位置供應商名稱清單。
HasProvider(String)	如果該裝置上存在該位置提供者，無論該服務是否啟用，都會回傳為真。
IsProviderEnabled(String)	回傳該提供者目前的啟用/停用狀態。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
RegisterAntennaInfoListener(IExecutor, GnssAntennaInfo+IListener)	註冊一個 GNSS 天線資訊監聽器，該接收器會接收所有天線資訊的變更。
RegisterGnssMeasurementsCallback(GnssMeasurementRequest, IExecutor, GnssMeasurementsEvent+Callback)	註冊一個 GNSS 測量回撥，該回撥會在綁定執行緒上執行。
RegisterGnssMeasurementsCallback(GnssMeasurementsEvent+Callback, Handler)	註冊一個 GNSS 測量回撥，該回撥會在綁定執行緒上執行。
RegisterGnssMeasurementsCallback(GnssMeasurementsEvent+Callback)	註冊一個 GNSS 測量回撥，該回撥會在綁定執行緒上執行。
RegisterGnssMeasurementsCallback(IExecutor, GnssMeasurementsEvent+Callback)	註冊一個 GNSS 測量回撥，該回撥會在綁定執行緒上執行。
RegisterGnssNavigationMessageCallback(GnssNavigationMessage+Callback, Handler)	註冊一個 GNSS 導航訊息回撥，該回調會在綁定執行緒上執行。
RegisterGnssNavigationMessageCallback(GnssNavigationMessage+Callback)	註冊一個 GNSS 導航訊息回撥，該回調會在綁定執行緒上執行。
RegisterGnssNavigationMessageCallback(IExecutor, GnssNavigationMessage+Callback)	註冊一個 GNSS 導航訊息回撥，該回調會在綁定執行緒上執行。
RegisterGnssStatusCallback(GnssStatus+Callback, Handler)	註冊一個 GNSS 狀態回撥。
RegisterGnssStatusCallback(GnssStatus+Callback)	註冊一個 GNSS 狀態回撥。
RegisterGnssStatusCallback(IExecutor, GnssStatus+Callback)	註冊一個 GNSS 狀態回撥。
RemoveGpsStatusListener(GpsStatus+IListener)	已淘汰. 移除 GPS 狀態監聽器。
RemoveNmeaListener(GpsStatus+INmeaListener)	已淘汰. 無需操作的方法來維持向下相容性。
RemoveNmeaListener(IOnNmeaMessageListener)	移除一個 NMEA 聽眾。
RemoveProximityAlert(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)	用指定參數註冊來自給定提供者的位置更新，並回調指定的 `Looper`參數。
RequestLocationUpdates(String, Int64, Single, ILocationListener)	註冊來自指定提供者的位置更新，並以指定參數註冊，並對呼叫執行緒的回調 `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)	使用標準註冊單一地點更新，並處於待定意圖狀態。
RequestSingleUpdate(String, ILocationListener, Looper)	使用指定的提供者和回撥，註冊一次位置更新。
RequestSingleUpdate(String, PendingIntent)	請使用指定提供者註冊一次位置更新，並使用待處理的意圖。
SendExtraCommand(String, String, Bundle)	向位置提供者發送額外指令。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	此類別提供系統定位服務的存取權限。 (繼承來源 JavaObject)
SetTestProviderEnabled(String, Boolean)	設定給定的測試提供者啟用或停用。
SetTestProviderLocation(String, Location)	為指定的測試提供者設定一個新的地點。
SetTestProviderStatus(String, Availability, Bundle, Int64)	此方法無效，因為提供者身份已被棄用且不再支援。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterAntennaInfoListener(GnssAntennaInfo+IListener)	取消註冊 GNSS 天線資訊監聽器。
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
UnregisterGnssMeasurementsCallback(GnssMeasurementsEvent+Callback)	取消註冊 GPS 測量回撥。
UnregisterGnssNavigationMessageCallback(GnssNavigationMessage+Callback)	取消註冊 GNSS 導航訊息回撥。
UnregisterGnssStatusCallback(GnssStatus+Callback)	移除 GNSS 狀態回撥。
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	此類別提供系統定位服務的存取權限。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	此類別提供系統定位服務的存取權限。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	此類別提供系統定位服務的存取權限。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	此類別提供系統定位服務的存取權限。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	此類別提供系統定位服務的存取權限。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	此類別提供系統定位服務的存取權限。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	此類別提供系統定位服務的存取權限。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於