am 6ec5a256: am 4be6fdeb: 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 '6ec5a256d78579057e82691e4cc21ca6222e2b1f':
  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-07 22:32:52 +00:00
committed by Android Git Automerger

View File

@@ -1,22 +1,20 @@
<html>
<body>
<p>Contains the framework API classes that define Android location-based and related services.</p>
<p class="note">
<strong>Note:</strong> 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.
<br/>
To learn more about the Location Services API, see
<a href="{@docRoot}google/play-services/location.html">Location APIs</a>.
<p>Contains the framework API classes that define Android location-based and
related services.</p>
<p class="warning">
<strong>This API is not the recommended method for accessing Android location.</strong><br>
The
<a href="{@docRoot}reference/com/google/android/gms/location/package-summary.html">Google Location Services API</a>,
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.
<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>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>
</html>