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:
- Google Play services provide a simple interface and a cleaner API surface.
- You specify a desired quality of service and the APIs manage the underlying technologies for you.
- The Google Play services APIs are optimized for performance and battery usage.
- 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:
- Set up Google Play services in your project.
- Use the location settings API to validate the current location settings.
- Use Google Play services for complex features like geofencing, activity recognition, and awareness.
- Replace usage of the framework location API with the fused location provider API.
- 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:
- Request location permissions in the app manifest.
- Set up a
LocationRequestobject, which specifies the desired QoS level.
- Use the location settings API to check the current settings.
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
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.