com.github.ignition.location.utils.locationupdaterequesters
Class IgnitedLegacyLocationUpdateRequester

java.lang.Object
  com.github.ignition.location.templates.IgnitedAbstractLocationUpdateRequester
      com.github.ignition.location.utils.locationupdaterequesters.IgnitedLegacyLocationUpdateRequester

Direct Known Subclasses:

IgnitedFroyoLocationUpdateRequester

public class IgnitedLegacyLocationUpdateRequester
extends IgnitedAbstractLocationUpdateRequester

Provides support for initiating active and passive location updates for all Android platforms from Android 1.6.

Uses broadcast Intents to notify the app of location changes.

Field Summary

protected android.app.AlarmManager

alarmManager

Fields inherited from class com.github.ignition.location.templates.IgnitedAbstractLocationUpdateRequester

locationManager, TAG

Constructor Summary

IgnitedLegacyLocationUpdateRequester(android.location.LocationManager locationManager)

IgnitedLegacyLocationUpdateRequester(android.location.LocationManager locationManager, android.app.AlarmManager alarmManager)

Method Summary

void	requestLocationUpdates(long minTime, long minDistance, android.location.Criteria criteria, android.app.PendingIntent pendingIntent) Request active location updates.
void	requestPassiveLocationUpdates(long minTime, long minDistance, android.app.PendingIntent pendingIntent) Request passive location updates.

Methods inherited from class com.github.ignition.location.templates.IgnitedAbstractLocationUpdateRequester

removeLocationUpdates

Methods inherited from class java.lang.Object

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

Field Detail

alarmManager

protected android.app.AlarmManager alarmManager

Constructor Detail

IgnitedLegacyLocationUpdateRequester

public IgnitedLegacyLocationUpdateRequester(android.location.LocationManager locationManager)

IgnitedLegacyLocationUpdateRequester

public IgnitedLegacyLocationUpdateRequester(android.location.LocationManager locationManager,
                                            android.app.AlarmManager alarmManager)

Method Detail

requestLocationUpdates

public void requestLocationUpdates(long minTime,
                                   long minDistance,
                                   android.location.Criteria criteria,
                                   android.app.PendingIntent pendingIntent)

Request active location updates. These updates will be triggered by a direct request from the Location Manager.

Overrides:

requestLocationUpdates in class IgnitedAbstractLocationUpdateRequester

Parameters:

minTime - Minimum time that should elapse between location update broadcasts.

minDistance - Minimum distance that should have been moved between location update broadcasts.

criteria - Criteria that define the Location Provider to use to detect the Location.

pendingIntent - The Pending Intent to broadcast to notify the app of active location changes.

requestPassiveLocationUpdates

public void requestPassiveLocationUpdates(long minTime,
                                          long minDistance,
                                          android.app.PendingIntent pendingIntent)

Request passive location updates. These updates will be triggered by locations received by 3rd party apps that have requested location updates. The miniumim time and distance for passive updates will typically be longer than for active updates. The trick is to balance the difference to minimize battery drain by maximize freshness.

Overrides:

requestPassiveLocationUpdates in class IgnitedAbstractLocationUpdateRequester

Parameters:

minTime - Minimum time that should elapse between location update broadcasts.

minDistance - Minimum distance that should have been moved between location update broadcasts.

pendingIntent - The Pending Intent to broadcast to notify the app of passive location changes.