diff --git a/location/java/android/location/package.html b/location/java/android/location/package.html index 81fcea46a281a..2355e725b6c50 100644 --- a/location/java/android/location/package.html +++ b/location/java/android/location/package.html @@ -1,22 +1,20 @@ -

Contains the framework API classes that define Android location-based and related services.

-

- Note: The Google Location Services API, part of Google Play - Services, provides a more powerful, high-level framework that automates tasks such as - location provider choice and power management. Location Services also provides new - features such as activity detection that aren't available in the framework API. Developers who - are using the framework API, as well as developers who are just now adding location-awareness - to their apps, should strongly consider using the Location Services API. -
- To learn more about the Location Services API, see - Location APIs. +

Contains the framework API classes that define Android location-based and + related services.

+

+This API is not the recommended method for accessing Android location.
+The +Google Location Services API, +part of Google Play services, is the preferred way to add location-awareness to +your app. It offers a simpler API, higher accuracy, low-power geofencing, and +more. If you are currently using the android.location API, you are strongly +encouraged to switch to the Google Location Services API as soon as +possible. +

+To learn more about the Google Location Services API, see the +Location API overview.

- -

For more information about the framework API, see the -Location and Maps guide.

-{@more} -