am ba2199fa: Merge "docs: Modified the notice in the android.location package file to strongly encourage developers to migrate to the Google Play Services Location API." into klp-modular-docs

* commit 'ba2199fa8c369d9627a216a4c3ea19497bf9e9c7':
  docs: Modified the notice in the android.location package file to strongly encourage developers to migrate to the Google Play Services Location API.
This commit is contained in:
Quddus Chong
2014-10-04 01:30:43 +00:00
committed by Android Git Automerger

View File

@@ -1,22 +1,20 @@
<html> <html>
<body> <body>
<p>Contains the framework API classes that define Android location-based and related services.</p> <p>Contains the framework API classes that define Android location-based and
<p class="note"> related services.</p>
<strong>Note:</strong> The Google Location Services API, part of Google Play <p class="warning">
Services, provides a more powerful, high-level framework that automates tasks such as <strong>This API is not the recommended method for accessing Android location.</strong><br>
location provider choice and power management. Location Services also provides new The
features such as activity detection that aren't available in the framework API. Developers who <a href="{@docRoot}reference/com/google/android/gms/location/package-summary.html">Google Location Services API</a>,
are using the framework API, as well as developers who are just now adding location-awareness part of Google Play services, is the preferred way to add location-awareness to
to their apps, should strongly consider using the Location Services API. your app. It offers a simpler API, higher accuracy, low-power geofencing, and
<br/> more. If you are currently using the android.location API, you are strongly
To learn more about the Location Services API, see encouraged to switch to the Google Location Services API as soon as
<a href="{@docRoot}google/play-services/location.html">Location APIs</a>. possible.
<br><br>
To learn more about the Google Location Services API, see the
<a href="{@docRoot}google/play-services/location.html">Location API overview</a>.
</p> </p>
<p>For more information about the framework API, see the
<a href="{@docRoot}guide/topics/location/index.html">Location and Maps</a> guide.</p>
{@more}
</body> </body>
</html> </html>