From c73cecefc1885744157f0d6b81155f4f686c5ce7 Mon Sep 17 00:00:00 2001 From: Soonil Nagarkar Date: Tue, 20 Oct 2020 11:36:22 -0700 Subject: [PATCH] Improve QUALITY_* constant documentation Given devs a better idea of how these quality constant may work. Bug: 168624248 Test: n/a Change-Id: I16910bc45d013b4a366d4e8036f63fdfbef55461 --- .../java/android/location/LocationRequest.java | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/location/java/android/location/LocationRequest.java b/location/java/android/location/LocationRequest.java index 3046cfd7c32bb..d0706c6b84cb9 100644 --- a/location/java/android/location/LocationRequest.java +++ b/location/java/android/location/LocationRequest.java @@ -74,19 +74,27 @@ public final class LocationRequest implements Parcelable { /** * A quality constant indicating a location provider may choose to satisfy this request by - * providing very accurate locations at the expense of potentially increased power usage. + * providing very accurate locations at the expense of potentially increased power usage. Each + * location provider may interpret this field differently, but as an example, the network + * provider may choose to return only wifi based locations rather than cell based locations in + * order to have greater accuracy when this flag is present. */ public static final int QUALITY_HIGH_ACCURACY = 100; /** * A quality constant indicating a location provider may choose to satisfy this request by - * equally balancing power and accuracy constraints. + * equally balancing power and accuracy constraints. Each location provider may interpret this + * field differently, but location providers will generally use their default behavior when this + * flag is present. */ public static final int QUALITY_BALANCED_POWER_ACCURACY = 102; /** * A quality constant indicating a location provider may choose to satisfy this request by - * providing less accurate locations in order to save power. + * providing less accurate locations in order to save power. Each location provider may + * interpret this field differently, but as an example, the network provider may choose to + * return cell based locations rather than wifi based locations in order to save power when this + * flag is present. */ public static final int QUALITY_LOW_POWER = 104;