Migrate to Google Play services location and context APIs

Google recommends using the location and context APIs in Google Play services in apps that require location services. If your app uses the framework location APIs it’s important to migrate to Google Play services to take advantage of the latest Google-powered features.

Using Google Play services is the preferred option to get location services in your app for the following reasons:

  1. Google Play services provide a simple interface and a cleaner API surface.
  2. You specify a desired quality of service and the APIs manage the underlying technologies for you.
  3. The Google Play services APIs are optimized for performance and battery usage.
  4. The Google Play services APIs are actively maintained. Google is constantly improving the algorithms and adding more features.

Update your app

The following steps describe the process to update an app to use the location and context APIs:

  1. Set up Google Play services in your project.
  2. Use the location settings API to validate the current location settings.
  3. Use Google Play services for complex features like geofencing, activity recognition, and awareness.
  4. Replace usage of the framework location API with the fused location provider API.
  5. Remove references to the framework location API.

Set up Google Play services in your project

To make the location and context APIs available to your project you must add a reference to the Google maven repository and declare a dependency to the required APIs. For more information, see Set Up Google Play services.

Use the location settings API

By using the location settings API, apps provide the desired QoS level and the API requests the user for the appropriate changes to the system settings. Take the following steps to use the location settings API in your app:

  1. Request location permissions in the app manifest.
  2. Set up a LocationRequest object, which specifies the desired QoS level.
  3. Use the location settings API to check the current settings.

For more information, see Changing Location Settings or see the Google Play Location samples for example code.

Use Google Play services for complex features

Google Play services libraries help you implement novel user experiences around context and awareness of the user's surroundings. The various location and context libraries leverage additional sensors beyond just location, and do so in a power-efficient way, providing your app with more accurate data while reducing the impact on battery life.

Incorporate these libraries in your app instead of writing custom solutions of your own:

Replace the framework location API with the fused location provider API

You can use the fused location provider API to get location data, such as latitude and longitude. The fused location provider API uses a Location object—just like the location framework API—to represent geographic location. The API provides features to listen for location updates as well as to get the last known location. All these features make the fused location provider API a good candidate to replace the components that use the framework location API with minimal changes to the rest of the app.

Getting the last known location is a good starting point for many experiences because it's a fast operation that uses location data requested by any client on the device. To periodically track location, your app can subscribe to receive location updates, which provides up-to-date data and enables more complex experiences.

Remove references to the framework location API

Replace references to classes in the com.google.android.location package with classes from the com.google.android.gms.location package, except references to the Location class, which the fused location provider API uses. You can usually remove the components that manage the different providers, such as GPS and Wi-Fi, from your app. The location and context APIs automatically manage these providers.

Test your app

To run an app that uses the latest version of Google Play services, you need a device that has the Play Store app installed and a Google account must be signed in. For development purposes you can use the following options:

  • A physical device connected to your development environment using a USB cable.
  • An emulator with the Play Store app installed.

For more information about connecting a physical device to your development environment, see Run Apps on a Hardware Device. To create an emulator that includes the Play Store app, see Create and Manage Virtual Devices.