Key used for the Bundle extra in Location object indicating whether this is a mock location.

Key used for the Bundle extra in Location object holding a float indicating the estimated vertical accuracy of the location, in meters.

Flushes any locations currently being batched and sends them to all registered LocationListeners, LocationCallbacks, and PendingIntents. This call is only useful when batching is specified using LocationRequest.setMaxWaitTime(long), otherwise locations are already delivered immediately when available.

When the returned Task is complete, then you can assume that any pending batched locations have already been delivered.

Returns a single location fix representing the best estimate of the current location of the device. This may return a cached location if a recent enough location fix exists, or may compute a fresh location. If unable to retrieve a current location fix, null will be returned.

Clients may supply an optional CancellationToken which may be used to cancel the request.

Returns a single location fix representing the best estimate of the current location of the device. This may return a historical location if a recent enough location fix exists, or may compute a fresh location. If unable to retrieve a current location fix, null will be returned.

Clients may supply an optional CancellationToken which may be used to cancel the request.

Returns the most recent historical location currently available according to the given request. Will return null if no matching historical location is available.

Returns the most recent historical location currently available. Will return null if no historical location is available. The historical location may be of an arbitrary age, so clients should check how old the location is to see if it suits their purposes.

Returns the estimated availability of location data. If LocationAvailability.isLocationAvailable() returns true then it is likely (but not guaranteed) that Fused Location Provider APIs will be able to derive and return fresh location updates. If LocationAvailability.isLocationAvailable() returns false, then it is likely (but not guaranteed) that Fused Location Provider APIs will be unable to derive and return fresh location updates, though there may be historical locations available.

Removes all location updates for the given listener.

Removes all location updates for the given callback.

Removes all location updates for the given pending intent.

Requests location updates with the given request and results delivered to the given listener on the specified Looper. A previous request for location updates for the same listener will be replaced by this request. If the location request has a priority higher than Priority.PRIORITY_PASSIVE, a wakelock may be held on the client's behalf while delivering locations.

Use removeLocationUpdates(LocationListener) to stop location updates once no longer needed.

Depending on the arguments passed in through the LocationRequest, locations from the past may be delivered when the listener is first registered. Clients should ensure they are checking location timestamps appropriately if necessary.

If the given Looper is null, the Looper associated with the calling thread will be used instead.

Requests location updates with the given request and results delivered to the given callback on the specified Executor. A previous request for location updates for the same callback will be replaced by this request. If the location request has a priority higher than Priority.PRIORITY_PASSIVE, a wakelock may be held on the client's behalf while delivering locations. A wakelock will not be held while delivering availability updates.

Use removeLocationUpdates(LocationCallback) to stop location updates once no longer needed.

Depending on the arguments passed in through the LocationRequest, locations from the past may be delivered when the callback is first registered. Clients should ensure they are checking location timestamps appropriately if necessary.

Requests location updates with the given request and results delivered to the given listener on the specified Executor.

Requests location updates with the given request and results delivered to the given callback on the specified Looper. A previous request for location updates for the same callback will be replaced by this request. If the location request has a priority higher than Priority.PRIORITY_PASSIVE, a wakelock may be held on the client's behalf while delivering locations. A wakelock will not be held while delivering availability updates.

Use removeLocationUpdates(LocationCallback) to stop location updates once no longer needed.

Depending on the arguments passed in through the LocationRequest, locations from the past may be delivered when the callback is first registered. Clients should ensure they are checking location timestamps appropriately if necessary.

If the given Looper is null, the Looper associated with the calling thread will be used instead.

Requests location updates with the given request and results delivered via the specified PendingIntent. A previous request for location updates for the same pending intent will be replaced by this request. If the location request has a priority higher than Priority.PRIORITY_PASSIVE, a wakelock may be held on the client's behalf while delivering locations. A wakelock will not be held while delivering availability updates.

Location updates should be extracted from the received Intent via LocationResult.hasResult(Intent) and LocationResult.extractResult(Intent). Availability updates should be extracted from the Intent via LocationAvailability.hasLocationAvailability(Intent) and LocationAvailability.extractLocationAvailability(Intent).

This method is suited for receiving location updates in the background, even when the receiving app may have been killed by the system. Using a PendingIntent allows the target component to be started and receive location updates. For foreground use cases prefer to listen for location updates via a listener or callback instead of a pending intent.

PendingIntent location requests are automatically removed when the client application is reset (for example, when the client application is upgraded, restarted, removed, or force-quit), or if the pending intent is canceled.

Use removeLocationUpdates(PendingIntent) to stop location updates once no longer needed.

Depending on the arguments passed in through the LocationRequest, locations from the past may be delivered when the callback is first registered. Clients should ensure they are checking location timestamps appropriately if necessary.

This API will not work for instant apps, since they are intended to run only in the foreground and will be disconnected otherwise. Instant apps should prefer to use any of the overloads that accept LocationListener or LocationCallback instead.

Sets the mock location of the Fused Location Provider.

Delivers the given location to the FLP as if it was coming from an underlying location source. Normal FLP logic around receiving and delivering location will generally apply. For this reason the timestamps of the location should be set appropriately, as the FLP may expect monotonically increasing timestamps. When this location is reported to FLP clients it will be marked as a mock location (see Location.isMock() or LocationCompat.isMock() from the compat libraries).

This API can only be successfully used while the FLP is in mock mode. Clients must fulfill the same security requirements as for setMockMode(boolean) as well.

Sets whether or not the Fused Location Provider is in mock mode.

Entering mock mode clears the FLP's cached locations, and ensures that the FLP will only report locations set through setMockLocation(Location). Exiting mock mode will clear any mock locations set from the FLP's cache as well. Mock mode affects all location clients using the FLP, including location clients in other processes and derivative APIs such as geofencing and so forth. Because this affects all FLP usage, clients should always ensure they properly set the mock mode to false when finished.

Successfully using this API on devices running Android M+ requires the client to request the android.permission.ACCESS_MOCK_LOCATION permission and to be selected as the mock location app within the device developer settings. Using this API on pre-M devices requires the Settings.Secure.ALLOW_MOCK_LOCATION setting to be enabled.