LocationManager.AddProximityAlert 方法

定義

命名空間:

Android.Locations

組件:

Mono.Android.dll

設定位置 （緯度、經度） 和指定半徑所指定位置的鄰近警示。

[Android.Runtime.Register("addProximityAlert", "(DDFJLandroid/app/PendingIntent;)V", "GetAddProximityAlert_DDFJLandroid_app_PendingIntent_Handler")]
public virtual void AddProximityAlert(double latitude, double longitude, float radius, long expiration, Android.App.PendingIntent pendingIntent);

[<Android.Runtime.Register("addProximityAlert", "(DDFJLandroid/app/PendingIntent;)V", "GetAddProximityAlert_DDFJLandroid_app_PendingIntent_Handler")>]
abstract member AddProximityAlert : double * double * single * int64 * Android.App.PendingIntent -> unit
override this.AddProximityAlert : double * double * single * int64 * Android.App.PendingIntent -> unit

參數

latitude

Double

警示區域中心點的緯度

longitude

Double

警示區域中央點的經度

radius

Single

以公尺為單位之警示區域中央點的半徑

expiration

Int64

此鄰近警示的到期即時以毫秒為單位，或 -1 表示沒有到期

pendingIntent

PendingIntent

， PendingIntent 會在偵測到警示區域進入或結束時傳送的 。

屬性

RegisterAttribute

例外狀況

SecurityException

如果許可權不存在，則 AccessFineLocation 為

備註

設定位置 （緯度、經度） 和指定半徑所指定位置的鄰近警示。

當裝置偵測到它已進入或結束位置周圍的區域時，將會引發指定的PendingIntent。

引發的意圖會新增具有索引鍵 #KEY_PROXIMITY_ENTERING的額外布爾值。 如果值為 true，裝置會進入鄰近區域;如果為 false，則會結束。

由於位置估計的近似本質，如果裝置短暫通過指定的區域，則不可能引發任何意圖。 同樣地，如果裝置非常接近指定的區域，但實際上不會輸入意圖，可能會引發意圖。

在 API 第 17 版之前，此方法可以搭配 或android.Manifest.permission#ACCESS_COARSE_LOCATION使用android.Manifest.permission#ACCESS_FINE_LOCATION。 從 API 17 版和更新版本開始，此方法需要 android.Manifest.permission#ACCESS_FINE_LOCATION 許可權。

的 android.location.LocationManager.addProximityAlert(double, double, float, long, android.app.PendingIntent)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。