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

Commit 8761e143 authored by Scott Main's avatar Scott Main Committed by Android (Google) Code Review
Browse files

docs: Clarify the callback mechanisms for LocationRequest

and clarify horizontal geofencing

Change-Id: I8ff264d7a12c8ec3c79854e008aeeb5f922ad459
parent c86e8dff
Loading
Loading
Loading
Loading
+2 −2
Original line number Diff line number Diff line
@@ -22,7 +22,7 @@ import android.os.Parcelable;
/**
 * Represents a geographical boundary, also known as a geofence.
 *
 * <p>Currently only circular geofences are supported.
 * <p>Currently only circular geofences are supported and they do not support altitude changes.
 */
public final class Geofence implements Parcelable {
    /** @hide */
@@ -34,7 +34,7 @@ public final class Geofence implements Parcelable {
    private final float mRadius;

    /**
     * Create a horizontal, circular geofence.
     * Create a circular geofence (on a flat, horizontal plane).
     *
     * @param latitude latitude in degrees
     * @param longitude longitude in degrees
+8 −0
Original line number Diff line number Diff line
@@ -811,6 +811,10 @@ public class LocationManager {
    /**
     * Register for fused location updates using a LocationRequest and callback.
     *
     * <p>Upon a location update, the system delivers the new {@link Location} to the
     * provided {@link LocationListener}, by calling its {@link
     * LocationListener#onLocationChanged} method.</p>
     *
     * <p>The system will automatically select and enable the best providers
     * to compute a location for your application. It may use only passive
     * locations, or just a single location source, or it may fuse together
@@ -869,6 +873,10 @@ public class LocationManager {
    /**
     * Register for fused location updates using a LocationRequest and a pending intent.
     *
     * <p>Upon a location update, the system delivers the new {@link Location} with your provided
     * {@link PendingIntent}, as the value for {@link LocationManager#KEY_LOCATION_CHANGED}
     * in the intent's extras.</p>
     *
     * <p> To unregister for Location updates, use: {@link #removeUpdates(PendingIntent)}.
     *
     * <p> See {@link #requestLocationUpdates(LocationRequest, LocationListener, Looper)}