com.nexusgeographics.cercalia.maps.location

Class LocationManager

java.lang.Object

com.nexusgeographics.cercalia.maps.location.LocationManager

All Implemented Interfaces:

android.location.LocationListener, LifeCycle

public class LocationManager
extends java.lang.Object
implements android.location.LocationListener, LifeCycle

LocationManager provides the user location. Usage example:

 
 LocationManager manager = LocationManager.getInstance(activity);
 manager.addMyLocationChangedListener(new LocationManager.MyLocationChangedListener() {
       @Override
      public void onMyLocationChanged(@NonNull LatLng latLng) {
         ...
      }
  });
 
 

Don't forget call LifeCycle methods: onCreate(), onResume(), onPause(), onDestroy(), onLowMemory()

Copyright (c) 2017 Nexusgeographics All rights reserved.

See Also:

LatLng, LifeCycle

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	LocationManager.MyLocationChangedListener

Field Summary

Fields

Modifier and Type	Field and Description
static int	AVAILABLE
static int	OUT_OF_SERVICE
static int	TEMPORARILY_UNAVAILABLE

Method Summary

Modifier and Type	Method and Description
void	addMyLocationChangedListener(LocationManager.MyLocationChangedListener listener)
static LocationManager	getInstance(android.app.Activity activity) Gets location manager instance
LatLng	getMyLocation() Gets the user location.
void	onCreate(android.os.Bundle savedInstanceState) On create.
void	onDestroy() On destroy.
void	onLocationChanged(android.location.Location location) Called when the location has changed.
void	onLowMemory() On low memory.
void	onPause() On pause.
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	onResume() On resume.
void	onStatusChanged(java.lang.String provider, int status, android.os.Bundle extras) Called when the provider status changes.
void	removeMyLocationChangedListener()

Methods inherited from class java.lang.Object

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

Field Detail

AVAILABLE

public static final int AVAILABLE

See Also:

Constant Field Values

OUT_OF_SERVICE

public static final int OUT_OF_SERVICE

See Also:

Constant Field Values

TEMPORARILY_UNAVAILABLE

public static final int TEMPORARILY_UNAVAILABLE

See Also:

Constant Field Values

Method Detail

getInstance

public static LocationManager getInstance(android.app.Activity activity)

Gets location manager instance

Parameters:

activity - The activity

Returns:

LocationManager instance

onCreate

public void onCreate(android.os.Bundle savedInstanceState)

Description copied from interface: LifeCycle

On create.

Specified by:

onCreate in interface LifeCycle

Parameters:

savedInstanceState - the saved instance state

onResume

public void onResume()

Description copied from interface: LifeCycle

On resume.

Specified by:

onResume in interface LifeCycle

onPause

public void onPause()

Description copied from interface: LifeCycle

On pause.

Specified by:

onPause in interface LifeCycle

onDestroy

public void onDestroy()

Description copied from interface: LifeCycle

On destroy.

Specified by:

onDestroy in interface LifeCycle

onLowMemory

public void onLowMemory()

Description copied from interface: LifeCycle

On low memory.

Specified by:

onLowMemory in interface LifeCycle

onStatusChanged

public void onStatusChanged(java.lang.String provider,
                            int status,
                            android.os.Bundle extras)

Called when the provider status changes. This method is called when a provider is unable to fetch a location or if the provider has recently become available after a period of unavailability.

Specified by:

onStatusChanged in interface android.location.LocationListener

Parameters:

provider - the name of the location provider associated with this update.

status - OUT_OF_SERVICE if the provider is out of service, and this is not expected to change in the near future; TEMPORARILY_UNAVAILABLE if the provider is temporarily unavailable but is expected to be available shortly; and AVAILABLE if the provider is currently available.

extras - an optional Bundle which will contain provider specific status variables.

onProviderEnabled

public void onProviderEnabled(java.lang.String provider)

Called when the provider is enabled by the user.

Specified by:

onProviderEnabled in interface android.location.LocationListener

Parameters:

provider - the name of the location provider associated with this update.

onProviderDisabled

public void onProviderDisabled(java.lang.String provider)

Called when the provider is disabled by the user. There are no restrictions on the use of the supplied Location object.

Specified by:

onProviderDisabled in interface android.location.LocationListener

Parameters:

provider - the name of the location provider associated with this update.

onLocationChanged

public final void onLocationChanged(android.location.Location location)

Called when the location has changed.

Specified by:

onLocationChanged in interface android.location.LocationListener

Parameters:

location - The new location, as a Location object.

getMyLocation

@Nullable
public LatLng getMyLocation()

Gets the user location.

Returns:

my location

addMyLocationChangedListener

public void addMyLocationChangedListener(@NonNull
                                         LocationManager.MyLocationChangedListener listener)

removeMyLocationChangedListener

public void removeMyLocationChangedListener()