The new APIs do not require your app to manually manage a connection to Google Play services through a GoogleApiClient
. This reduces boilerplate and common pitfalls in your app.
A better developer experience
The new LocationServices
APIs are much simpler and will make your code less error prone. The connection logic is handled automatically, and you only need to attach a single completion listener:
public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); FusedLocationProviderClient client = LocationServices.getFusedLocationProviderClient(this); client.requestLocationUpdates(LocationRequest.create(), pendingIntent) .addOnCompleteListener(new OnCompleteListener() { @Override public void onComplete(@NonNull Task task) { Log.d("MainActivity", "Result: " + task.getResult()); } }); } }
The new API immediately improves the code in a few ways:
- The API calls automatically wait for the service connection to be established, which removes the need to wait for
onConnected
before making requests. - It uses the Task API which makes it easier to compose asynchronous operations.
- The code is self-contained and could easily be moved into a shared utility class or similar.
- You don’t need to understand the underlying connection process to start coding.
What happened to all of the callbacks?
The new API will automatically resolve certain connection failures for you, so you don’t need to write code that for things like prompting the user to update Google Play services. Rather than exposing connection failures globally in the onConnectionFailed method, connection problems will fail the Task with an ApiException:
client.requestLocationUpdates(LocationRequest.create(), pendingIntent) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { if (e instanceof ApiException) { Log.w(TAG, ((ApiException) e).getStatusMessage()); } else { Log.w(TAG, e.getMessage()); } } });
Read more , or head straight to https://github.com/googlesamples/android-play-location