net.donky.location

Class DonkyLocationController

java.lang.Object

AbstractLastLocation

net.donky.location.DonkyLocationController

public class DonkyLocationController
extends AbstractLastLocation

Created by Marcin Swierczek 19/05/2015. Copyright (C) Donky Networks Ltd. All rights reserved.

Method Summary

Modifier and Type	Method and Description
void	appStopped() Handle if developer forgot to unregister locationUpdateListeners of location
static boolean	checkGooglePlayServices(android.app.Activity activity)
protected LocationRequest	createLocationRequest()
static DonkyLocationController	getInstance()
android.location.Location	getLastLocation() Get last user location
void	init(android.content.Context context)
boolean	isShouldAutomaticallySendLocation()
void	onConnected(android.os.Bundle bundle)
void	onConnectionFailed(ConnectionResult connectionResult)
void	onConnectionSuspended(int i)
void	onLocationChanged(android.location.Location location) Update observer about new data of location
void	registerLocationListener(LocationUpdatesCallback callback) Register location with default Location request
void	registerLocationListener(LocationUpdatesCallback callback, LocationRequest locationRequest) Register with specific Location request
void	requestUserLocation(TargetUser targetUser, DonkyListener donkyListener) Request location details from another user device.
void	sendLocationUpdate(DonkyListener donkyListener) Update device location on the Donky Network
void	sendLocationUpdateToUser(TargetUser targetUser, DonkyListener donkyListener) Send your current location to another user on the Donky Network
void	setPollingProfile(int interval, int fastestInterval, int priority, int distanceTo)
void	setShouldAutomaticallySendLocation(boolean shouldAutomaticallySendLocation)
void	unregisterLocationListener(LocationUpdatesCallback callback) Unregister from tracking location

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static DonkyLocationController getInstance()

Returns:

Instance of Network Controller singleton.

init

public void init(android.content.Context context)

setPollingProfile

public void setPollingProfile(int interval,
                              int fastestInterval,
                              int priority,
                              int distanceTo)

createLocationRequest

protected LocationRequest createLocationRequest()

getLastLocation

public android.location.Location getLastLocation()

Get last user location

Returns:

Location object what contain all location data

registerLocationListener

public void registerLocationListener(LocationUpdatesCallback callback)

Register location with default Location request

Parameters:

callback - to receive onLocationChange data

registerLocationListener

public void registerLocationListener(LocationUpdatesCallback callback,
                                     LocationRequest locationRequest)

Register with specific Location request

Parameters:

locationRequest - Location request to start tracking position

callback - to receive onLocationChange data

unregisterLocationListener

public void unregisterLocationListener(LocationUpdatesCallback callback)

Unregister from tracking location

Parameters:

callback - to remove from observers

onConnected

public void onConnected(android.os.Bundle bundle)

onConnectionSuspended

public void onConnectionSuspended(int i)

onConnectionFailed

public void onConnectionFailed(ConnectionResult connectionResult)

onLocationChanged

public void onLocationChanged(android.location.Location location)

Update observer about new data of location

Parameters:

location - updated user's location

requestUserLocation

public void requestUserLocation(TargetUser targetUser,
                                DonkyListener donkyListener)

Request location details from another user device. To construct valid Target user object use one of below methods: TargetUser.getTargetUserByExternalId(String) TargetUser.getTargetUserByExternalId(String, String) TargetUser.getTargetUserByProfileId(String, String) TargetUser.getTargetUserByProfileId(String)

Parameters:

targetUser - Which user on the App Space should be asked to send you his location

donkyListener - Callback for completing synchronisation

sendLocationUpdate

public void sendLocationUpdate(DonkyListener donkyListener)

Update device location on the Donky Network

Parameters:

donkyListener - Callback for completing synchronisation

sendLocationUpdateToUser

public void sendLocationUpdateToUser(TargetUser targetUser,
                                     DonkyListener donkyListener)

Send your current location to another user on the Donky Network

Parameters:

targetUser - Which user on the App Space should be notified about your current location

donkyListener - Callback for completing synchronisation

checkGooglePlayServices

public static boolean checkGooglePlayServices(android.app.Activity activity)

appStopped

public void appStopped()

Handle if developer forgot to unregister locationUpdateListeners of location

isShouldAutomaticallySendLocation

public boolean isShouldAutomaticallySendLocation()

setShouldAutomaticallySendLocation

public void setShouldAutomaticallySendLocation(boolean shouldAutomaticallySendLocation)