LocationManager.AddProximityAlert 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
为位置(纬度、经度)和给定半径提供的位置设置邻近感应警报。
[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_FINE_LOCATION
或 android.Manifest.permission#ACCESS_COARSE_LOCATION
. 从 API 版本 17 及更高版本开始,此方法需要 android.Manifest.permission#ACCESS_FINE_LOCATION
权限。
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。