FusedLocationProviderApi | Android Developers

Quicknav Quicknav
Links

- Google Play Developer Console
- Android Developers Blog
- About Android

Android Sites

- Android.com
- Android Developers
- Android Open Source Project

Language
close

- - About
  - Wear
  - TV
  - Auto
- - Get Started
  - Devices
  - Style
  - Patterns
  - Building Blocks
  - Downloads
  - Videos
- - Training
  - API Guides
  - Reference
  - Tools
  - Google Services
  - Samples
- - Google Play
  - Essentials
  - Get Users
  - Engage & Retain
  - Monetize
  - Tools & Reference
  - Developer Stories

## Results

Loading...
public interface

# FusedLocationProviderApi

com.google.android.gms.location.FusedLocationProviderApi

## Class Overview

The main entry point for interacting with the fused location provider.

The methods must be used in conjunction with a `GoogleApiClient`. E.g.

         new GoogleApiClient.Builder(context)
                 .addApi(LocationServices.API)
                 .addConnectionCallbacks(this)
                 .addOnConnectionFailedListener(this)
                 .build()

## Summary

Constants
String | KEY_LOCATION_CHANGED | Key used for a Bundle extra holding a Location value when a location change is broadcast using a PendingIntent.
String | KEY_MOCK_LOCATION | Key used for the Bundle extra in Location object holding a boolean indicating whether the location was set using `setMockLocation(GoogleApiClient, Location)`.

Public Methods
abstract Location | getLastLocation(GoogleApiClient client) Returns the best most recent location currently available.
abstract PendingResult<Status> | removeLocationUpdates(GoogleApiClient client, LocationListener listener) Removes all location updates for the given location listener.
abstract PendingResult<Status> | removeLocationUpdates(GoogleApiClient client, PendingIntent callbackIntent) Removes all location updates for the given pending intent.
abstract PendingResult<Status> | requestLocationUpdates(GoogleApiClient client, LocationRequest request, LocationListener listener, Looper looper) Requests location updates with a callback on the specified Looper thread.
abstract PendingResult<Status> | requestLocationUpdates(GoogleApiClient client, LocationRequest request, LocationListener listener) Requests location updates.
abstract PendingResult<Status> | requestLocationUpdates(GoogleApiClient client, LocationRequest request, PendingIntent callbackIntent) Requests location updates with a callback on the specified PendingIntent.
abstract PendingResult<Status> | setMockLocation(GoogleApiClient client, Location mockLocation) Sets the mock location to be used for the location provider.
abstract PendingResult<Status> | setMockMode(GoogleApiClient client, boolean isMockMode) Sets whether or not the location provider is in mock mode.

## Constants

#### public static final String KEY_LOCATION_CHANGED

Key used for a Bundle extra holding a Location value when a location change is broadcast using a PendingIntent.

Constant Value: "com.google.android.location.LOCATION"

#### public static final String KEY_MOCK_LOCATION

Key used for the Bundle extra in Location object holding a boolean indicating whether the location was set using `setMockLocation(GoogleApiClient, Location)`. If the value is false this extra is not set.

Constant Value: "mockLocation"

## Public Methods

#### public abstract Location getLastLocation (GoogleApiClient client)

Returns the best most recent location currently available.

If a location is not available, which should happen very rarely, null will be returned. The best accuracy available while respecting the location permissions will be returned.

This method provides a simplified way to get location. It is particularly well suited for applications that do not require an accurate location and that do not want to maintain extra logic for location updates.

##### Parameters

client | An existing GoogleApiClient. If not connected null will be returned.

#### public abstract PendingResult<Status> removeLocationUpdates (GoogleApiClient client, LocationListener listener)

Removes all location updates for the given location listener.

##### Parameters

client | An existing GoogleApiClient. It must be connected at the time of this call, which is normally achieved by calling `connect()` and waiting for `onConnected(Bundle)` to be called.
listener | The listener to remove.

##### Returns

- a PendingResult for the call, check `isSuccess()` to determine if it was successful.

#### public abstract PendingResult<Status> removeLocationUpdates (GoogleApiClient client, PendingIntent callbackIntent)

Removes all location updates for the given pending intent.

It is possible for this call to cancel the PendingIntent under some circumstances.

##### Parameters

client | An existing GoogleApiClient. It must be connected at the time of this call, which is normally achieved by calling `connect()` and waiting for `onConnected(Bundle)` to be called.
callbackIntent | The callback intent to remove.

##### Returns

- a PendingResult for the call, check `isSuccess()` to determine if it was successful.

#### public abstract PendingResult<Status> requestLocationUpdates (GoogleApiClient client, LocationRequest request, LocationListener listener, Looper looper)

Requests location updates with a callback on the specified Looper thread.

This method is suited for the foreground use cases,more specifically for requesting locations while being connected to `GoogleApiClient`. For background use cases, the `PendingIntent` version of the method is recommended, see `requestLocationUpdates(GoogleApiClient, LocationRequest, PendingIntent)`.

Any previous LocationRequests registered on this LocationListener will be replaced.

Callbacks for LocationListener will be made on the specified thread, which must already be a prepared looper thread. For cases where the callback can happen on the calling thread, the variant of this method without a `Looper` can be used. See `requestLocationUpdates(GoogleApiClient, LocationRequest, LocationListener, Looper)`.

##### Parameters

client | An existing GoogleApiClient. It must be connected at the time of this call, which is normally achieved by calling `connect()` and waiting for `onConnected(Bundle)` to be called.
request | The location request for the updates.
listener | The listener for the location updates.
looper | The Looper object whose message queue will be used to implement the callback mechanism, or null to make callbacks on the calling thread.

##### Returns

- a PendingResult for the call, check `isSuccess()` to determine if it was successful.

#### public abstract PendingResult<Status> requestLocationUpdates (GoogleApiClient client, LocationRequest request, LocationListener listener)

Requests location updates.

This method is suited for the foreground use cases, more specifically for requesting locations while being connected to `GoogleApiClient`. For background use cases, the `PendingIntent` version of the method is recommended, see `requestLocationUpdates(GoogleApiClient, LocationRequest, PendingIntent)`.

Any previous LocationRequests registered on this LocationListener will be replaced.

Callbacks for LocationListener will be made on the calling thread, which must already be a prepared looper thread, such as the main thread of the calling Activity. The variant of this method with a `Looper` is recommended for cases where the callback needs to happen on a specific thread.mResult = See `requestLocationUpdates(GoogleApiClient, LocationRequest, LocationListener, Looper)`.

##### Parameters

client | An existing GoogleApiClient. It must be connected at the time of this call, which is normally achieved by calling `connect()` and waiting for `onConnected(Bundle)` to be called.
request | The location request for the updates.
listener | The listener for the location updates.

##### Returns

- a PendingResult for the call, check `isSuccess()` to determine if it was successful.

#### public abstract PendingResult<Status> requestLocationUpdates (GoogleApiClient client, LocationRequest request, PendingIntent callbackIntent)

Requests location updates with a callback on the specified PendingIntent.

This method is suited for the background use cases, more specifically for receiving location updates, even when the app has been killed by the system. In order to do so, use a `PendingIntent` for a started service. For foreground use cases, the `LocationListener` version of the method is recommended, see `requestLocationUpdates(GoogleApiClient, LocationRequest, LocationListener)`.

Any previous LocationRequests registered on this PendingIntent will be replaced.

Location updates are sent with a key of `KEY_LOCATION_CHANGED` and a `Location` value on the intent.

##### Parameters

client | An existing GoogleApiClient. It must be connected at the time of this call, which is normally achieved by calling `connect()` and waiting for `onConnected(Bundle)` to be called.
request | The location request for the updates.
callbackIntent | A pending intent to be sent for each location update.

##### Returns

- a PendingResult for the call, check `isSuccess()` to determine if it was successful.

#### public abstract PendingResult<Status> setMockLocation (GoogleApiClient client, Location mockLocation)

Sets the mock location to be used for the location provider. This location will be used in place of any actual locations from the underlying providers (network or gps).

`setMockMode(GoogleApiClient, boolean)` must be called and set to true prior to calling this method.

Care should be taken in specifying the timestamps as many applications require them to be monotonically increasing.

##### Parameters

client | An existing GoogleApiClient. It must be connected at the time of this call, which is normally achieved by calling `connect()` and waiting for `onConnected(Bundle)` to be called.
mockLocation | The mock location. Must have a minimum number of fields set to be considered a valild location, as per documentation in the `Location` class.

##### Returns

- a PendingResult for the call, check `isSuccess()` to determine if it was successful.

##### Throws

SecurityException | if the ACCESS_MOCK_LOCATION permission is not present or the `Settings.Secure.ALLOW_MOCK_LOCATION` system setting is not enabled.

#### public abstract PendingResult<Status> setMockMode (GoogleApiClient client, boolean isMockMode)

Sets whether or not the location provider is in mock mode.

The underlying providers (network and gps) will be stopped (except by direct `LocationManager` access), and only locations specified in `setMockLocation(GoogleApiClient, Location)` will be reported. This will effect all location clients connected using the `LocationClient`, including geofencer clients (i.e. geofences can be triggered based on mock locations).

The client must remain connected in order for mock mode to remain active. If the client dies the system will return to its normal state.

Calls are not nested, and mock mode will be set directly regardless of previous calls.

##### Parameters

client | An existing GoogleApiClient. It must be connected at the time of this call, which is normally achieved by calling `connect()` and waiting for `onConnected(Bundle)` to be called.
isMockMode | If true the location provider will be set to mock mode. If false it will be returned to its normal state.

##### Returns

- a PendingResult for the call, check `isSuccess()` to determine if it was successful.

##### Throws

SecurityException | if the ACCESS_MOCK_LOCATION permission is not present or the `Settings.Secure.ALLOW_MOCK_LOCATION` system setting is not enabled.