Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 380dde32 authored by Quddus Chong's avatar Quddus Chong
Browse files

docs: Modified the notice in the android.location package file to strongly

encourage developers to migrate to the Google Play Services Location API.

Change-Id: I9c2602daa7198eca38841582865c6a973f5acec8
parent 52a18161
Loading
Loading
Loading
Loading
+14 −16
Original line number Diff line number Diff line
<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>