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_FINE_LOCATION
или android.Manifest.permission#ACCESS_COARSE_LOCATION
. Из API версии 17 и более поздних версий этот метод требует android.Manifest.permission#ACCESS_FINE_LOCATION
разрешения.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.