LocationCallback

AI-generated Key Takeaways

• LocationCallback is a callback for receiving locations from the FusedLocationProviderClient.

• Unlike LocationListener, LocationCallback can receive batches of locations and provides callbacks for changes in LocationAvailability.

• LocationCallback includes methods to handle new location results (onLocationResult) and changes in location availability (onLocationAvailability).

• While slightly more complex to implement than LocationListener, LocationCallback is suitable for handling batched location updates and availability changes.

public abstract class LocationCallback extends Object

A callback for receiving locations from the FusedLocationProviderClient.

This differs from LocationListener in that this callback is slightly more work to implement and use, but will receive batches of location (in the event that a LocationRequest allows for batched locations) as a single callback to onLocationResult(LocationResult), and will receive callbacks for changes to LocationAvailability in onLocationAvailability(LocationAvailability). For most simple location use cases clients will often find LocationListener easier to use.

Public Constructor Summary

LocationCallback()

Public Method Summary

void	onLocationAvailability(LocationAvailability availability) Invoked when there is a change in the availability of location data.
void	onLocationResult(LocationResult result) Invoked when a new set of locations is available.

Inherited Method Summary

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 Constructors

public LocationCallback ()

Public Methods

public void onLocationAvailability (LocationAvailability availability)

Invoked when there is a change in the availability of location data.

When LocationAvailability.isLocationAvailable() returns false it generally indicates that further invocations of onLocationResult(LocationResult) are unlikely until something changes with the device's settings or environment. When LocationAvailability.isLocationAvailable() returns true it generally indicates that further invocations of onLocationResult(LocationResult) are likely, and fresh locations can be expected.

Clients should treat LocationAvailability as a best guess that is not necessarily accurate and should not be relied upon.

public void onLocationResult (LocationResult result)

Invoked when a new set of locations is available. The LocationResult may contain one or more locations, but will never be empty. The locations within the location result will generally be as fresh as possible given the parameters of the associated LocationRequest and the state of the device, but this does not imply that they will always represent the current location. Clients should always check the timestamps associated with the locations if necessary for their needs.