commit 195c32f774d024483894935ec363415fcf2688fc
author Joe Malin <jmalin@google.com> Thu Jun 06 10:55:44 2013 -0700
committer Android Git Automerger <android-git-automerger@android.com> Thu Jun 06 10:55:44 2013 -0700
tree fe1be51981e25f7773ab2b0ec0632d5493408301
parent 6861c488bc7022925cde63bdd6a2cff5a50b486c
parent 7b34346d483f41c1a7b444299903017c9d69eb6d

am 7b34346d: am a2425f68: Merge "Doc bug B9297954: Fixes to Location APIs" into jb-mr2-dev

* commit '7b34346d483f41c1a7b444299903017c9d69eb6d':
  Doc bug B9297954: Fixes to Location APIs

docs/html/training/location/receive-location-updates.jd

diff --git a/docs/html/training/location/receive-location-updates.jd b/docs/html/training/location/receive-location-updates.jd
index c33f075..e6e8c51 100644
--- a/docs/html/training/location/receive-location-updates.jd
+++ b/docs/html/training/location/receive-location-updates.jd
@@ -417,7 +417,7 @@
     public static final int UPDATE_INTERVAL_IN_SECONDS = 5;
     // Update frequency in milliseconds
     private static final long UPDATE_INTERVAL =
-            MILLISECONDS_PER_SECOND * UPDATE_INTERVAL_IN SECONDS;
+            MILLISECONDS_PER_SECOND * UPDATE_INTERVAL_IN_SECONDS;
     // The fastest update frequency, in seconds
     private static final int FASTEST_INTERVAL_IN_SECONDS = 1;
     // A fast frequency ceiling in milliseconds
@@ -425,7 +425,7 @@
             MILLISECONDS_PER_SECOND * FASTEST_INTERVAL_IN_SECONDS;
     ...
     // Define an object that holds accuracy and frequency parameters
-    LocationResult mLocationRequest;
+    LocationRequest mLocationRequest;
     ...
     @Override
     protected void onCreate(Bundle savedInstanceState) {
@@ -458,9 +458,11 @@
     the request by calling
 <code><a href="{@docRoot}reference/com/google/android/gms/location/LocationClient.html#requestLocationUpdates(com.google.android.gms.location.LocationRequest, com.google.android.gms.location.LocationListener)">requestLocationUpdates()</a></code>.
     Since your client must be connected for your app to receive updates, you should
-    connect the client and make the request in
+    connect the client in
     {@link android.support.v4.app.FragmentActivity#onStart onStart()}. This ensures that you always
-    have a valid, connected client while your app is visible.
+    have a valid, connected client while your app is visible. Since you need a connection before you
+    can request updates, make the update request in
+<code><a href="{@docRoot}reference/com/google/android/gms/common/GooglePlayServicesClient.ConnectionCallbacks.html#onConnected(android.os.Bundle)">ConnectionCallbacks.onConnected()</a></code>
 </p>
 <p>
     Remember that the user may want to turn off location updates for various reasons. You should
@@ -536,6 +538,21 @@
         }
     }
     ...
+    /*
+     * Called by Location Services when the request to connect the
+     * client finishes successfully. At this point, you can
+     * request the current location or start periodic updates
+     */
+    &#64;Override
+    public void onConnected(Bundle dataBundle) {
+        // Display the connection status
+        Toast.makeText(this, "Connected", Toast.LENGTH_SHORT).show();
+        // If already requested, start periodic updates
+        if (mUpdatesRequested) {
+            mLocationClient.requestLocationUpdates(mLocationRequest, this);
+        }
+    }
+    ...
 }
 </pre>
 <p>