共用方式為


LocationManager.AddProximityAlert 方法

定義

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

[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 會在偵測到警示區域進入或結束時傳送的 。

屬性

例外狀況

如果許可權不存在,則 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 屬性授權中所述的詞彙使用。

適用於