LocationManager.AddProximityAlert Methode

Referenz

Definition

Namespace:: Android.Locations

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Legt eine Näherungswarnung für die Position fest, die durch die Position (Breitengrad, Längengrad) und den angegebenen Radius angegeben wird.

[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

Parameter

latitude: Double

den Breitengrad des zentralen Punkts der Warnungsregion

longitude: Double

Längengrad des zentralen Punkts der Warnungsregion

radius: Single

der Radius des zentralen Punkts der Warnungsregion in Metern

expiration: Int64

Ablauf in Echtzeit für diese Näherungswarnung in Millisekunden oder -1, um keinen Ablauf anzuzeigen

pendingIntent: PendingIntent

ein PendingIntent , der gesendet wird, wenn der Ein- oder Ausstieg aus der Warnungsregion erkannt wird

Attribute: RegisterAttribute

Ausnahmen

SecurityException

wenn AccessFineLocation die Berechtigung nicht vorhanden ist

Hinweise

Legt eine Näherungswarnung für die Position fest, die durch die Position (Breitengrad, Längengrad) und den angegebenen Radius angegeben wird.

Wenn das Gerät erkennt, dass es in die Umgebung des Standorts gelangt oder beendet wurde, wird der angegebene PendingIntent ausgelöst.

Die ausgelöste Absicht hat einen booleschen extra mit Schlüssel #KEY_PROXIMITY_ENTERINGhinzugefügt. Wenn der Wert "true" ist, wechselt das Gerät in den Näherungsbereich. wenn falsch, wird es beendet.

Aufgrund der ungefähren Art der Positionsschätzung ist es möglich, dass keine Absicht ausgelöst wird, wenn das Gerät kurz durch den angegebenen Bereich durchläuft. Ebenso könnte eine Absicht ausgelöst werden, wenn das Gerät sehr nah an den angegebenen Bereich übergeht, aber nicht tatsächlich eingeht.

Vor API Version 17 kann diese Methode mit android.Manifest.permission#ACCESS_FINE_LOCATION oder android.Manifest.permission#ACCESS_COARSE_LOCATIONverwendet werden. Ab API Version 17 erfordert android.Manifest.permission#ACCESS_FINE_LOCATION diese Methode die Berechtigung.

Java-Dokumentation für android.location.LocationManager.addProximityAlert(double, double, float, long, android.app.PendingIntent).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

Freigeben über