com.mapzen.android.lost.internal

Class FusedLocationProviderApiImpl

java.lang.Object

com.mapzen.android.lost.internal.FusedLocationProviderApiImpl

All Implemented Interfaces:

android.content.ServiceConnection, FusedLocationProviderApi, FusedLocationServiceConnectionManager.EventCallbacks

public class FusedLocationProviderApiImpl
extends java.lang.Object
implements FusedLocationProviderApi, FusedLocationServiceConnectionManager.EventCallbacks, android.content.ServiceConnection

Implementation of the FusedLocationProviderApi.

Field Summary

Fields inherited from interface com.mapzen.android.lost.api.FusedLocationProviderApi

KEY_LOCATION_CHANGED

Constructor Summary

Constructors

Constructor and Description
FusedLocationProviderApiImpl(FusedLocationServiceConnectionManager connectionManager, FusedLocationServiceCallbackManager callbackManager, com.mapzen.android.lost.internal.RequestManager requestManager, ClientManager clientManager)

Method Summary

Modifier and Type	Method and Description
void	addConnectionCallbacks(LostApiClient.ConnectionCallbacks callbacks)
void	connect(android.content.Context context, LostApiClient.ConnectionCallbacks callbacks)
void	disconnect()
android.location.Location	getLastLocation(LostApiClient client) Returns the best most recent location currently available.
LocationAvailability	getLocationAvailability(LostApiClient client) Returns the availability of location data.
java.util.Map<LostApiClient,java.util.Set<LocationListener>>	getLocationListeners()
boolean	isConnected()
boolean	isConnecting()
void	onConnect(android.content.Context context)
void	onDisconnect()
void	onServiceConnected(android.content.ComponentName name, android.os.IBinder binder)
void	onServiceConnected(android.os.IBinder binder)
void	onServiceDisconnected(android.content.ComponentName name)
PendingResult<Status>	removeLocationUpdates(LostApiClient client, LocationCallback callback) Remove location updates for the LocationCallback
PendingResult<Status>	removeLocationUpdates(LostApiClient client, LocationListener listener) Removes location updates for the LocationListener
PendingResult<Status>	removeLocationUpdates(LostApiClient client, android.app.PendingIntent callbackIntent) Removes location updates for the PendingIntent
PendingResult<Status>	requestLocationUpdates(LostApiClient client, LocationRequest request, LocationCallback callback, android.os.Looper looper) Request location updates to be called on the LocationCallback on a given thread.
PendingResult<Status>	requestLocationUpdates(LostApiClient client, LocationRequest request, LocationListener listener) Request location updates to be called on the LocationListener.
PendingResult<Status>	requestLocationUpdates(LostApiClient client, LocationRequest request, LocationListener listener, android.os.Looper looper) Request location updates to be called on the LocationListener on a given thread.
PendingResult<Status>	requestLocationUpdates(LostApiClient client, LocationRequest request, android.app.PendingIntent callbackIntent) Requests location updates with a callback on the specified PendingIntent.
PendingResult<Status>	setMockLocation(LostApiClient client, android.location.Location mockLocation) Sets the mock location to be used for the location provider.
PendingResult<Status>	setMockMode(LostApiClient client, boolean isMockMode) Sets whether or not the location provider is in mock mode.
PendingResult<Status>	setMockTrace(LostApiClient client, java.lang.String path, java.lang.String filename) Sets a mock trace file to be used to report location for the location provider.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FusedLocationProviderApiImpl

public FusedLocationProviderApiImpl(FusedLocationServiceConnectionManager connectionManager,
                                    FusedLocationServiceCallbackManager callbackManager,
                                    com.mapzen.android.lost.internal.RequestManager requestManager,
                                    ClientManager clientManager)

Method Detail

onConnect

public void onConnect(android.content.Context context)

Specified by:

onConnect in interface FusedLocationServiceConnectionManager.EventCallbacks

onServiceConnected

public void onServiceConnected(android.os.IBinder binder)

Specified by:

onServiceConnected in interface FusedLocationServiceConnectionManager.EventCallbacks

onDisconnect

public void onDisconnect()

Specified by:

onDisconnect in interface FusedLocationServiceConnectionManager.EventCallbacks

onServiceConnected

public void onServiceConnected(android.content.ComponentName name,
                               android.os.IBinder binder)

Specified by:

onServiceConnected in interface android.content.ServiceConnection

onServiceDisconnected

public void onServiceDisconnected(android.content.ComponentName name)

Specified by:

onServiceDisconnected in interface android.content.ServiceConnection

isConnecting

public boolean isConnecting()

addConnectionCallbacks

public void addConnectionCallbacks(LostApiClient.ConnectionCallbacks callbacks)

connect

public void connect(android.content.Context context,
                    LostApiClient.ConnectionCallbacks callbacks)

disconnect

public void disconnect()

isConnected

public boolean isConnected()

getLastLocation

public android.location.Location getLastLocation(LostApiClient client)

Description copied from interface: FusedLocationProviderApi

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.

Specified by:

getLastLocation in interface FusedLocationProviderApi

Parameters:

client - The client to return location for.

Returns:

The best, most recent location available.

getLocationAvailability

public LocationAvailability getLocationAvailability(LostApiClient client)

Description copied from interface: FusedLocationProviderApi

Returns the availability of location data. Location is considered available if one of the following conditions is met: GPS is enabled and the LocationManager has a last known GPS location or Network location is enabled and the LocationManager has a last known Network location This method can return null if there is a problem getting the availability.

Specified by:

getLocationAvailability in interface FusedLocationProviderApi

Parameters:

client - The client to return availability for.

Returns:

The availability of location data.

requestLocationUpdates

public PendingResult<Status> requestLocationUpdates(LostApiClient client,
                                                    LocationRequest request,
                                                    LocationListener listener)

Description copied from interface: FusedLocationProviderApi

Request location updates to be called on the LocationListener. This method is suited for foreground use cases and callbacks for the LocationListener will be made on the calling thread, which must already be a prepared looper thread. For handling on a background thread it is recommended that you use the PendingIntent version of this method FusedLocationProviderApi.requestLocationUpdates(LostApiClient, LocationRequest, PendingIntent).

Specified by:

requestLocationUpdates in interface FusedLocationProviderApi

Parameters:

client - Client to request updates for, must be connected when making this call.

request - Specifies desired location accuracy, update interval, etc.

listener - Listener to make calls on when location becomes available.

Returns:

a PendingResult for the call to check whether call was successful.

requestLocationUpdates

public PendingResult<Status> requestLocationUpdates(LostApiClient client,
                                                    LocationRequest request,
                                                    LocationListener listener,
                                                    android.os.Looper looper)

Description copied from interface: FusedLocationProviderApi

Request location updates to be called on the LocationListener on a given thread. This method is suited for foreground use cases and callbacks for the LocationListener will be made on the given thread, which must already be a prepared looper thread. For handling on a background thread it is recommended that you use the PendingIntent version of this method FusedLocationProviderApi.requestLocationUpdates(LostApiClient, LocationRequest, PendingIntent).

Specified by:

requestLocationUpdates in interface FusedLocationProviderApi

Parameters:

client - Client to request updates for, must be connected when making this call.

request - Specifies desired location accuracy, update interval, etc.

listener - Listener to make calls on when location becomes available.

looper - Looper to implement the listener callbacks on.

Returns:

a PendingResult for the call to check whether call was successful.

requestLocationUpdates

public PendingResult<Status> requestLocationUpdates(LostApiClient client,
                                                    LocationRequest request,
                                                    LocationCallback callback,
                                                    android.os.Looper looper)

Description copied from interface: FusedLocationProviderApi

Request location updates to be called on the LocationCallback on a given thread. This method is suited for foreground use cases and callbacks for the LocationCallback will be made on the given thread, which must already be a prepared looper thread. For handling on a background thread it is recommended that you use the PendingIntent version of this method FusedLocationProviderApi.requestLocationUpdates(LostApiClient, LocationRequest, PendingIntent).

Specified by:

requestLocationUpdates in interface FusedLocationProviderApi

Parameters:

client - Client to request updates for, must be connected when making this call.

request - Specifies desired location accuracy, update interval, etc.

callback - Callback to make calls on when location becomes available.

looper - Looper to implement the listener callbacks on.

Returns:

a PendingResult for the call to check whether call was successful.

requestLocationUpdates

public PendingResult<Status> requestLocationUpdates(LostApiClient client,
                                                    LocationRequest request,
                                                    android.app.PendingIntent callbackIntent)

Description copied from interface: FusedLocationProviderApi

Requests location updates with a callback on the specified PendingIntent. This method is suited for background use cases such as 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 use the other (LocationListener & LocationCallback) versions of this method. Both LocationResult and LocationAvailability are sent with the PendingIntent. You can extract them using LocationResult.hasResult(android.content.Intent), LocationResult.extractResult(android.content.Intent), LocationAvailability.hasLocationAvailability(android.content.Intent), and LocationAvailability.extractLocationAvailability(android.content.Intent).

Specified by:

requestLocationUpdates in interface FusedLocationProviderApi

Parameters:

client - Client to request updates for, must be connected when making this call.

request - Specifies desired location accuracy, update interval, etc.

callbackIntent - Intent to be sent for each location update.

Returns:

a PendingResult for the call to check whether call was successful.

removeLocationUpdates

public PendingResult<Status> removeLocationUpdates(LostApiClient client,
                                                   LocationListener listener)

Description copied from interface: FusedLocationProviderApi

Removes location updates for the LocationListener

Specified by:

removeLocationUpdates in interface FusedLocationProviderApi

Parameters:

client - Client which registered the listener. The client must be connected at the time of this call.

listener - Listener to remove updates for.

Returns:

a PendingResult for the call to check whether call was successful.

removeLocationUpdates

public PendingResult<Status> removeLocationUpdates(LostApiClient client,
                                                   android.app.PendingIntent callbackIntent)

Description copied from interface: FusedLocationProviderApi

Removes location updates for the PendingIntent

Specified by:

removeLocationUpdates in interface FusedLocationProviderApi

Parameters:

client - Client which registered the pending intent. The client must be connected at the time of this call.

callbackIntent - Intent to remove updates for.

Returns:

a PendingResult for the call to check whether call was successful.

removeLocationUpdates

public PendingResult<Status> removeLocationUpdates(LostApiClient client,
                                                   LocationCallback callback)

Description copied from interface: FusedLocationProviderApi

Remove location updates for the LocationCallback

Specified by:

removeLocationUpdates in interface FusedLocationProviderApi

Parameters:

client - Client which registered the location callback. The client must be connected at the time of this call.

callback - Callback to remove updates for.

Returns:

a PendingResult for the call to check whether call was successful.

setMockMode

public PendingResult<Status> setMockMode(LostApiClient client,
                                         boolean isMockMode)

Description copied from interface: FusedLocationProviderApi

Sets whether or not the location provider is in mock mode. This effects all LostApiClients connected to the FusedLocationProviderApi. Mock mode must be enabled before clients are able to call FusedLocationProviderApi.setMockLocation(LostApiClient, Location) and FusedLocationProviderApi.setMockTrace(LostApiClient, String, String)

Specified by:

setMockMode in interface FusedLocationProviderApi

Parameters:

client - Connected client.

isMockMode - Whether mock mode should be enabled or not.

Returns:

a PendingResult for the call to check whether call was successful.

setMockLocation

public PendingResult<Status> setMockLocation(LostApiClient client,
                                             android.location.Location mockLocation)

Description copied from interface: FusedLocationProviderApi

Sets the mock location to be used for the location provider. Mock mode must be enabled before calling this method.

Specified by:

setMockLocation in interface FusedLocationProviderApi

Parameters:

client - Connected client.

mockLocation - Location to be set for the location provider.

Returns:

a PendingResult for the call to check whether call was successful.

setMockTrace

public PendingResult<Status> setMockTrace(LostApiClient client,
                                          java.lang.String path,
                                          java.lang.String filename)

Description copied from interface: FusedLocationProviderApi

Sets a mock trace file to be used to report location for the location provider. Mock mode must be enabled before calling this method.

Specified by:

setMockTrace in interface FusedLocationProviderApi

Parameters:

client - Connected client.

path - storage directory containing GPX trace to be used to report location.

filename - filename of GPX trace to be used to report location.

Returns:

a PendingResult for the call to check whether call was successful.

getLocationListeners

public java.util.Map<LostApiClient,java.util.Set<LocationListener>> getLocationListeners()