LocationManager.RequestSingleUpdate Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 -> unitParameters
- provider
- String
a provider listed by #getAllProviders()
- pendingIntent
- PendingIntent
the pending intent to send location updates
- Attributes
Exceptions
if provider is null or doesn't exist
if intent is null
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.
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.
Applies to
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 -> unitParameters
- 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
Exceptions
if provider is null or doesn't exist
if listener is null
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.
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.
Applies to
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 -> unitParameters
- criteria
- Criteria
contains parameters to choose the appropriate provider for location updates
- pendingIntent
- PendingIntent
the pending intent to send location updates
- Attributes
Exceptions
if provider is null or doesn't exist
if intent is null
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.
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.
Applies to
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 -> unitParameters
- 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
Exceptions
if criteria is null
if listener is null
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.
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.