Summary: Methods | Inherited Methods

LocationManagerCompat

Kotlin |Java

public final class LocationManagerCompat
extends Object

java.lang.Object
↳	androidx.core.location.LocationManagerCompat

---

Helper for accessing features in LocationManager.

Summary

Public methods
static void	getCurrentLocation(LocationManager locationManager, String provider, CancellationSignal cancellationSignal, Executor executor, Consumer<Location> consumer) Asynchronously returns a single current location fix from the given provider.
static String	getGnssHardwareModelName(LocationManager locationManager) Returns the model name (including vendor and hardware/software version) of the GNSS hardware driver, or null if this information is not available.
static int	getGnssYearOfHardware(LocationManager locationManager) Returns the model year of the GNSS hardware and software build, or 0 if the model year is before 2016.
static boolean	hasProvider(LocationManager locationManager, String provider) Returns true if the given location provider exists on this device, irrespective of whether it is currently enabled or not.
static boolean	isLocationEnabled(LocationManager locationManager) Returns the current enabled/disabled state of location.
static boolean	registerGnssStatusCallback(LocationManager locationManager, GnssStatusCompat.Callback callback, Handler handler) Registers a platform agnostic GnssStatusCompat.Callback.
static boolean	registerGnssStatusCallback(LocationManager locationManager, Executor executor, GnssStatusCompat.Callback callback) Registers a platform agnostic GnssStatusCompat.Callback.
static void	removeUpdates(LocationManager locationManager, LocationListenerCompat listener) Removes all location updates for the specified LocationListener.
static void	requestLocationUpdates(LocationManager locationManager, String provider, LocationRequestCompat locationRequest, Executor executor, LocationListenerCompat listener) Register for location updates from the specified provider, using a LocationRequestCompat, and a callback on the specified Executor.
static void	requestLocationUpdates(LocationManager locationManager, String provider, LocationRequestCompat locationRequest, LocationListenerCompat listener, Looper looper) Register for location updates from the specified provider, using a LocationRequestCompat, and a callback on the specified Looper.
static void	unregisterGnssStatusCallback(LocationManager locationManager, GnssStatusCompat.Callback callback) Unregisters a platform agnostic GnssStatusCompat.Callback.

Inherited methods
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait(long arg0, int arg1) final void wait(long arg0) final void wait()

Public methods

getCurrentLocation

public static void getCurrentLocation (LocationManager locationManager, 
                String provider, 
                CancellationSignal cancellationSignal, 
                Executor executor, 
                Consumer<Location> consumer)

Asynchronously returns a single current location fix from the given provider. This may activate sensors in order to compute a new location. The given callback will be invoked once and only once, either with a valid location or with a null location if the provider was unable to generate a valid location.

A client may supply an optional CancellationSignal. If this is used to cancel the operation, no callback should be expected after the cancellation.

This method may return locations from the very recent past (on the order of several seconds), but will never return older locations (for example, several minutes old or older). Clients may rely upon the guarantee that if this method returns a location, it will represent the best estimation of the location of the device in the present moment.

Clients calling this method from the background may notice that the method fails to determine a valid location fix more often than while in the foreground. Background applications may be throttled in their location accesses to some degree.

Requires the ACCESS_COARSE_LOCATION or ACCESS_FINE_LOCATION permissions.

Parameters
locationManager	LocationManager
provider	String
cancellationSignal	CancellationSignal
executor	Executor
consumer	Consumer

getGnssHardwareModelName

public static String getGnssHardwareModelName (LocationManager locationManager)

Returns the model name (including vendor and hardware/software version) of the GNSS hardware driver, or null if this information is not available. No device-specific serial number or ID is returned from this API.

Parameters
locationManager	LocationManager

Returns
String

getGnssYearOfHardware

public static int getGnssYearOfHardware (LocationManager locationManager)

Returns the model year of the GNSS hardware and software build, or 0 if the model year is before 2016.

Parameters
locationManager	LocationManager

Returns
int

hasProvider