Package com.arubanetworks.meridian.location

Class MeridianLocationManager

java.lang.Object

com.arubanetworks.meridian.location.MeridianLocationManager

public class MeridianLocationManager
extends Object

A helper class to make management of the bound location services provided by the Meridian SDK simple.

This class provides a listener for receiving new locations and events requesting the user be prompted to turn on certain services depending on the location information available.

Below is a sample use in which enabling requests are shown to the user with toast messages and a the current locations string representation is displayed on the screen:

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	MeridianLocationManager.LocationUpdateListener	A listener for receiving notifications about updated locations, service requests or errors from the MeridianLocationManager.

Constructor Summary

Constructors

Constructor	Description
MeridianLocationManager(Context context, EditorKey appKey)	Constructs a LocationServiceHelper using the given Context and EditorKey.
MeridianLocationManager(Context context, EditorKey appKey, MeridianLocationManager.LocationUpdateListener listener)	Constructs a LocationServiceHelper using the given Context, EditorKey and LocationUpdateListener.

Method Summary

Modifier and Type	Method	Description
MeridianLocation	getLastLocation()	Gets the last known location.
void	resetLocationManager()	Resets the location manager.
void	setListener(MeridianLocationManager.LocationUpdateListener listener)	Sets the listener to receive location events.
boolean	startListeningForLocation()	Binds to the location service and starts listening for new location updates.
void	stopListeningForLocation()	Stops listening for locations and unbinds from the location service allowing it to clean itself up.

Methods inherited from class java.lang.Object

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

Constructor Details

MeridianLocationManager

public MeridianLocationManager(Context context,
 EditorKey appKey)

Constructs a LocationServiceHelper using the given Context and EditorKey.

MeridianLocationManager

public MeridianLocationManager(Context context,
 EditorKey appKey,
 MeridianLocationManager.LocationUpdateListener listener)

Constructs a LocationServiceHelper using the given Context, EditorKey and LocationUpdateListener.

Method Details

startListeningForLocation

public boolean startListeningForLocation()

Binds to the location service and starts listening for new location updates.

This method should be called in your Activity’s onStart method.

stopListeningForLocation

public void stopListeningForLocation()

Stops listening for locations and unbinds from the location service allowing it to clean itself up.

This method should be called in your Activity’s onStop Method.

resetLocationManager

public void resetLocationManager()

Resets the location manager.

In general this should not be called. Only use it if system conditions have changed since starting the location manager. For example, if the user accepted location permission while location manager is running.

setListener

public void setListener(MeridianLocationManager.LocationUpdateListener listener)

Sets the listener to receive location events.

getLastLocation

public MeridianLocation getLastLocation()

Gets the last known location.