LocationManager.RequestSingleUpdate Method

Definition

Namespace:

Android.Locations

Assembly:

Mono.Android.dll

Overloads

RequestSingleUpdate(String, PendingIntent)	Register for a single location update using a named provider and pending intent.
RequestSingleUpdate(String, ILocationListener, Looper)	Register for a single location update using the named provider and a callback.
RequestSingleUpdate(Criteria, PendingIntent)	Register for a single location update using a Criteria and pending intent.
RequestSingleUpdate(Criteria, ILocationListener, Looper)	Register for a single location update using a Criteria and a callback.

RequestSingleUpdate(String, PendingIntent)

Register for a single location update using a named provider and pending intent.

[Android.Runtime.Register("requestSingleUpdate", "(Ljava/lang/String;Landroid/app/PendingIntent;)V", "GetRequestSingleUpdate_Ljava_lang_String_Landroid_app_PendingIntent_Handler")]
public virtual void RequestSingleUpdate (string provider, Android.App.PendingIntent pendingIntent);

[<Android.Runtime.Register("requestSingleUpdate", "(Ljava/lang/String;Landroid/app/PendingIntent;)V", "GetRequestSingleUpdate_Ljava_lang_String_Landroid_app_PendingIntent_Handler")>]
abstract member RequestSingleUpdate : string * Android.App.PendingIntent -> unit
override this.RequestSingleUpdate : string * Android.App.PendingIntent -> unit

Parameters

provider

String

a provider listed by #getAllProviders()

pendingIntent

PendingIntent

the pending intent to send location updates

Attributes

RegisterAttribute

Exceptions

IllegalArgumentException

if provider is null or doesn't exist

IllegalArgumentException

if intent is null

SecurityException

if no suitable permission is present

Remarks

Register for a single location update using a named provider and pending intent.

See #requestLocationUpdates(long, float, Criteria, PendingIntent) for more detail on how to use this method.

This member is deprecated. Use #getCurrentLocation(String, CancellationSignal, Executor, Consumer) instead as it does not carry a risk of extreme battery drain.

Java documentation for android.location.LocationManager.requestSingleUpdate(java.lang.String, android.app.PendingIntent).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

RequestSingleUpdate(String, ILocationListener, Looper)

Register for a single location update using the named provider and a callback.

[Android.Runtime.Register("requestSingleUpdate", "(Ljava/lang/String;Landroid/location/LocationListener;Landroid/os/Looper;)V", "GetRequestSingleUpdate_Ljava_lang_String_Landroid_location_LocationListener_Landroid_os_Looper_Handler")]
public virtual void RequestSingleUpdate (string provider, Android.Locations.ILocationListener listener, Android.OS.Looper? looper);

[<Android.Runtime.Register("requestSingleUpdate", "(Ljava/lang/String;Landroid/location/LocationListener;Landroid/os/Looper;)V", "GetRequestSingleUpdate_Ljava_lang_String_Landroid_location_LocationListener_Landroid_os_Looper_Handler")>]
abstract member RequestSingleUpdate : string * Android.Locations.ILocationListener * Android.OS.Looper -> unit
override this.RequestSingleUpdate : string * Android.Locations.ILocationListener * Android.OS.Looper -> unit

Parameters

provider

String

a provider listed by #getAllProviders()

listener

ILocationListener

the listener to receive location updates

looper

Looper

the looper handling listener callbacks, or null to use the looper of the calling thread

Attributes

RegisterAttribute

Exceptions

IllegalArgumentException

if provider is null or doesn't exist

IllegalArgumentException

if listener is null

SecurityException

if no suitable permission is present

Remarks

Register for a single location update using the named provider and a callback.

See #requestLocationUpdates(String, long, float, LocationListener, Looper) for more detail on how to use this method.

This member is deprecated. Use #getCurrentLocation(String, CancellationSignal, Executor, Consumer) instead as it does not carry a risk of extreme battery drain.

Java documentation for android.location.LocationManager.requestSingleUpdate(java.lang.String, android.location.LocationListener, android.os.Looper).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

RequestSingleUpdate(Criteria, PendingIntent)

Register for a single location update using a Criteria and pending intent.

[Android.Runtime.Register("requestSingleUpdate", "(Landroid/location/Criteria;Landroid/app/PendingIntent;)V", "GetRequestSingleUpdate_Landroid_location_Criteria_Landroid_app_PendingIntent_Handler")]
public virtual void RequestSingleUpdate (Android.Locations.Criteria criteria, Android.App.PendingIntent pendingIntent);

[<Android.Runtime.Register("requestSingleUpdate", "(Landroid/location/Criteria;Landroid/app/PendingIntent;)V", "GetRequestSingleUpdate_Landroid_location_Criteria_Landroid_app_PendingIntent_Handler")>]
abstract member RequestSingleUpdate : Android.Locations.Criteria * Android.App.PendingIntent -> unit
override this.RequestSingleUpdate : Android.Locations.Criteria * Android.App.PendingIntent -> unit

Parameters

criteria

Criteria

contains parameters to choose the appropriate provider for location updates

pendingIntent

PendingIntent

the pending intent to send location updates

Attributes

RegisterAttribute

Exceptions

IllegalArgumentException

if provider is null or doesn't exist

IllegalArgumentException

if intent is null

SecurityException

if no suitable permission is present

Remarks

Register for a single location update using a Criteria and pending intent.

Note: Since Android KitKat, Criteria requests will always result in using the #FUSED_PROVIDER.

See #requestLocationUpdates(long, float, Criteria, PendingIntent) for more detail on how to use this method.

This member is deprecated. Use #getCurrentLocation(String, CancellationSignal, Executor, Consumer) instead as it does not carry a risk of extreme battery drain.

Java documentation for android.location.LocationManager.requestSingleUpdate(android.location.Criteria, android.app.PendingIntent).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

RequestSingleUpdate(Criteria, ILocationListener, Looper)

Register for a single location update using a Criteria and a callback.

[Android.Runtime.Register("requestSingleUpdate", "(Landroid/location/Criteria;Landroid/location/LocationListener;Landroid/os/Looper;)V", "GetRequestSingleUpdate_Landroid_location_Criteria_Landroid_location_LocationListener_Landroid_os_Looper_Handler")]
public virtual void RequestSingleUpdate (Android.Locations.Criteria criteria, Android.Locations.ILocationListener listener, Android.OS.Looper? looper);

[<Android.Runtime.Register("requestSingleUpdate", "(Landroid/location/Criteria;Landroid/location/LocationListener;Landroid/os/Looper;)V", "GetRequestSingleUpdate_Landroid_location_Criteria_Landroid_location_LocationListener_Landroid_os_Looper_Handler")>]
abstract member RequestSingleUpdate : Android.Locations.Criteria * Android.Locations.ILocationListener * Android.OS.Looper -> unit
override this.RequestSingleUpdate : Android.Locations.Criteria * Android.Locations.ILocationListener * Android.OS.Looper -> unit

Parameters

criteria

Criteria

contains parameters to choose the appropriate provider for location updates

listener

ILocationListener

the listener to receive location updates

looper

Looper

the looper handling listener callbacks, or null to use the looper of the calling thread

Attributes

RegisterAttribute

Exceptions

IllegalArgumentException

if criteria is null

IllegalArgumentException

if listener is null

SecurityException

if no suitable permission is present

Remarks

Register for a single location update using a Criteria and a callback.

Note: Since Android KitKat, Criteria requests will always result in using the #FUSED_PROVIDER.

See #requestLocationUpdates(long, float, Criteria, PendingIntent) for more detail on how to use this method.

This member is deprecated. Use #getCurrentLocation(String, CancellationSignal, Executor, Consumer) instead as it does not carry a risk of extreme battery drain.

Java documentation for android.location.LocationManager.requestSingleUpdate(android.location.Criteria, android.location.LocationListener, android.os.Looper).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.