drgreen/android_frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

am 67b0ac71: Merge "docs: Clarifies the difference between the Android framework location APIs and the Google Play services location APIs. Fixes 80-character line length." into lmp-docs

Browse Source 
* commit '67b0ac719a87ba52c849a6cf055ef235f230dd6e':
  docs: Clarifies the difference between the Android framework location APIs and the Google Play services location APIs. Fixes 80-character line length.
This commit is contained in:
Sarah Maddox
2014-11-14 00:02:38 +00:00
committed by Android Git Automerger
parent 30aee7fccb 67b0ac719a
commit aa3a93ede7
1 changed files with 66 additions and 58 deletions
Download Patch File Download Diff File Expand all files Collapse all files

124
docs/html/training/location/index.jd
View File

@ -21,7 +21,8 @@ startpage=true
<h2>You should also read</h2> <h2>You should also read</h2>
<ul> <ul>
<li> <li>
<a href="{@docRoot}google/play-services/setup.html">Setup Google Play Services SDK</a> <a href="{@docRoot}google/play-services/setup.html">Set Up Google Play
Services SDK</a>
</li> </li>
</ul> </ul>
@ -29,68 +30,75 @@ startpage=true
</div> </div>
<p> <p>
One of the unique features of mobile applications is location awareness. Mobile users bring One of the unique features of mobile applications is location awareness.
their devices with them everywhere, and adding location awareness to your app offers users a Mobile users take their devices with them everywhere, and adding location
more contextual experience. The new Location Services API available in Google Play services awareness to your app offers users a more contextual experience. The location
facilitates adding location awareness to your app with automated location tracking, APIs available in Google Play services facilitate adding location awareness to
geofencing, and activity recognition. This API adds significant advantages over the plaform's your app with automated location tracking, geofencing, and activity
location API. recognition.
</p> </p>
<p>The
<a href="{@docRoot}reference/com/google/android/gms/location/package-summary.html">Google
Play services location APIs</a> are preferred over the Android framework
location APIs
(<a href="{@docRoot}reference/android/location/package-summary.html">android.location</a>)
as a way of adding location awareness to your app. If you are currently using
the Android framework location APIs, you are strongly encouraged to switch to
the Google Play services location APIs as soon as possible.
</p>
<p> <p>
This class shows you how to use Location Services in your app to get the current location, This class shows you how to use the Google Play services location APIs in your
get periodic location updates, look up addresses, create and monitor geofences, and app to get the current location, get periodic location updates, look up
detect user activities. The class includes sample apps and code snippets that you can use as a addresses, create and monitor geofences, and detect user activities. The class
starting point for adding location awareness to your own app. includes sample apps and code snippets that you can use as a starting point
for adding location awareness to your app.
</p> </p>
<p class="note"> <p class="note">
<strong>Note:</strong> Since this class is based on the Google Play services client library, <strong>Note:</strong> Since this class is based on the Google Play services
make sure you install the latest version before using the sample apps or code snippets. To learn client library, make sure you install the latest version before using the
how to set up the client library with the latest version, see sample apps or code snippets. To learn how to set up the client library with
<a href="{@docRoot}google/play-services/setup.html">Setup</a> in the Google Play services guide. the latest version, see
<a href="{@docRoot}google/play-services/setup.html">Setup</a> in the Google
Play services guide.
</p> </p>
<h2>Lessons</h2> <h2>Lessons</h2>
<dl> <dl>
<dt> <dt>
<b><a href="retrieve-current.html">Retrieving the Current Location</a></b> <b><a href="retrieve-current.html">Retrieving the Current Location</a></b>
</dt> </dt> <dd>
<dd> Learn how to retrieve the user's current location.
Learn how to retrieve the user's current location. </dd> <dt>
</dd> <b><a href="receive-location-updates.html">Receiving Location
<dt> Updates</a></b>
<b><a href="receive-location-updates.html">Receiving Location Updates</a></b> </dt> <dd>
</dt> Learn how to request and receive periodic location updates.
<dd> </dd> <dt>
Learn how to request and receive periodic location updates. <b><a href="display-address.html">Displaying a Location Address</a></b>
</dd> </dt> <dd>
<dt> Learn how to convert a location's latitude and longitude into an address
<b><a href="display-address.html">Displaying a Location Address</a></b> (reverse geocoding).
</dt> </dd> <dt>
<dd> <b>
Learn how to convert a location's latitude and longitude into an address (reverse <a href="geofencing.html">Creating and Monitoring Geofences</a>
geocoding). </b>
</dd> </dt> <dd>
<dt> Learn how to define one or more geographic areas as locations of interest,
<b> called geofences, and detect when the user is close to or inside a geofence.
<a href="geofencing.html">Creating and Monitoring Geofences</a> </dd> <dt>
</b> <b><a href="activity-recognition.html">Recognizing the User's Current
</dt> Activity</a></b>
<dd> </dt> <dd>
Learn how to define one or more geographic areas as locations of interest, called geofences, Learn how to recognize the user's current activity, such as walking,
and detect when the user is close to or inside a geofence. bicycling, or driving a car, and how to use this information to modify your
</dd> app's location strategy.
<dt> </dd> <dt>
<b><a href="activity-recognition.html">Recognizing the User's Current Activity</a></b> <b><a href="location-testing.html">Testing Using Mock Locations</a></b>
</dt> </dt> <dd>
<dd> Learn how to test a location-aware app by injecting mock locations into
Learn how to recognize the user's current activity, such as walking, bicycling, Location Services. In mock mode, Location Services sends out mock locations
or driving a car, and how to use this information to modify your app's location strategy. that you inject instead of sensor-based locations.
</dd> </dd>
<dt>
<b><a href="location-testing.html">Testing Using Mock Locations</a></b>
</dt>
<dd>
Learn how to test a location-aware app by injecting mock locations into Location
Services. In mock mode, Location Services sends out mock locations that you inject instead
of sensor-based locations.
</dd>
</dl> </dl>