1.2 (Nov 2, 2018)
Oct 15, 2018
Nov 2, 2018 (Retired)
David Serrano (david-serrano)
David Serrano (david-serrano)
Source code



LocationProvider is a tiny, lifecycle aware library that abstracts away a lot of the pain of getting a users location from the phone (without having to call location APIs), provides a fully configurable standard Builder pattern and a set of callbacks.

With the most basic usage, you give it a context and a callback and you're good to go!

DISCLAIMER: This library needs the ACCESS_FINE_LOCATION permission, but it assumes it has been given beforehand, see sample app for more details

For details on how to hook into an activity lifecycle, see the sample app. The library hooks on to onResume and onPause to start and stop the location requests. If you need further hooks, please open up an issue :)

Install instructions

  1. add the jitpack dependency:
 allprojects {
  repositories {
   maven { url 'https://jitpack.io' }
  1. add a dependency to your app/build.gradle:
dependencies {
           implementation 'com.github.david-serrano:locationprovider:1.2'

Example usage:

//create a callback
LocationProvider.LocationCallback callback = new LocationProvider.LocationCallback() {
          public void locationRequestStopped(float lat, float lon) {
              //location updates stopped

          public void onNewLocationAvailable(float lat, float lon) {
              //location update

          public void locationServicesNotEnabled() {
            //failed finding a location

          public void updateLocationInBackground(float lat, float lon) {
              //if a listener returns after the main locationAvailable callback, it will go here

          public void networkListenerInitialised() {
            //when the library switched from GPS only to GPS & network
  //initialise an instance with the two required parameters
  LocationProvider locationProvider = new LocationProvider.Builder()
  //start getting location

How it works:

The library provides a standard Builder pattern with a few configurable options but uses default values if none are set. In the most standard use case it will:

  1. Look for last known locations in order the following order passive, gps, network. If those return a value onNewLocationAvailable will be called.
  2. Initialise a GPS listener or network listener depending on availability of service (high accuracy vs battery saving for example)
  3. Return location based on available providers:
  • If GPS initialised but taking too long, start a network listener after X (configurable) seconds.
  • If only network initialised, some phones fail to update the listener but update the passive values correctly, so after Y (configurable) seconds, try the last known locations again.
  1. Return values for GPS/network when available and shut down self, call back to listener.


MIT License