public class AndroidLocationEngine extends LocationEngine implements android.location.LocationListener
LocationEngine.TypefastestInterval, interval, locationListeners, priority, smallestDisplacement| Constructor and Description |
|---|
AndroidLocationEngine(android.content.Context context) |
| Modifier and Type | Method and Description |
|---|---|
void |
activate()
Activate the location engine which will connect whichever location provider you are using.
|
void |
deactivate()
Disconnect the location engine, useful when you no longer need location updates or requesting the users
LocationEngine.getLastLocation(). |
android.location.Location |
getLastLocation()
When first initializing the location engine the location updates oftentimes aren't immediate and your user
experience might diminish since they are forced to wait till a more accurate update arrives.
|
static LocationEngine |
getLocationEngine(android.content.Context context) |
boolean |
isConnected()
Check if your location provider has been activated/connected.
|
LocationEngine.Type |
obtainType()
Get the current
LocationEngine LocationEngine.Type being used. |
void |
onLocationChanged(android.location.Location location)
Called when the location has changed.
|
void |
onProviderDisabled(java.lang.String provider)
Called when the provider is disabled by the user.
|
void |
onProviderEnabled(java.lang.String provider)
Called when the provider is enabled by the user.
|
void |
onStatusChanged(java.lang.String provider,
int status,
android.os.Bundle extras)
Called when the provider status changes.
|
void |
removeLocationUpdates()
When you no longer wish to receive location updates, you should call this method to prevent the devices battery
from draining.
|
void |
requestLocationUpdates()
if a
LocationEngineListener is setup, registering for location updates will tell the provider to begin
sending updates. |
void |
setPriority(int priority)
This method sets the priority of the request, providing this will help the location provide know which location
sources to use.
|
addLocationEngineListener, getFastestInterval, getInterval, getPriority, getSmallestDisplacement, isBetterLocation, removeLocationEngineListener, setFastestInterval, setInterval, setSmallestDisplacementpublic AndroidLocationEngine(android.content.Context context)
public static LocationEngine getLocationEngine(android.content.Context context)
public void activate()
LocationEngineLocationEngine.requestLocationUpdates().activate in class LocationEnginepublic void deactivate()
LocationEngineLocationEngine.getLastLocation(). Before deactivating you'll need to stop request user location updates
using LocationEngine.removeLocationUpdates().deactivate in class LocationEnginepublic boolean isConnected()
LocationEngineisConnected in class LocationEnginepublic android.location.Location getLastLocation()
LocationEngineLocation
object is simply stored in cache.getLastLocation in class LocationEngineLocation object.public void requestLocationUpdates()
LocationEngineLocationEngineListener is setup, registering for location updates will tell the provider to begin
sending updates.requestLocationUpdates in class LocationEnginepublic void setPriority(int priority)
LocationEngineLocationEnginePriority file.setPriority in class LocationEnginepriority - One of the LocationEnginePrioritys listed.public void removeLocationUpdates()
LocationEngineLocationEngine.removeLocationEngineListener(LocationEngineListener).removeLocationUpdates in class LocationEnginepublic LocationEngine.Type obtainType()
LocationEngineLocationEngine LocationEngine.Type being used.obtainType in class LocationEngineLocationEngine.Type enum.public void onLocationChanged(android.location.Location location)
onLocationChanged in interface android.location.LocationListenerpublic void onStatusChanged(java.lang.String provider,
int status,
android.os.Bundle extras)
onStatusChanged in interface android.location.LocationListenerpublic void onProviderEnabled(java.lang.String provider)
onProviderEnabled in interface android.location.LocationListenerpublic void onProviderDisabled(java.lang.String provider)
onProviderDisabled in interface android.location.LocationListener