summaryrefslogtreecommitdiff
path: root/location
diff options
context:
space:
mode:
Diffstat (limited to 'location')
-rw-r--r--location/java/android/location/Address.java2
-rw-r--r--location/java/android/location/GnssCapabilities.java6
-rw-r--r--location/java/android/location/GnssMeasurementsEvent.java18
3 files changed, 15 insertions, 11 deletions
diff --git a/location/java/android/location/Address.java b/location/java/android/location/Address.java
index bb97c783132b..90d99296aa06 100644
--- a/location/java/android/location/Address.java
+++ b/location/java/android/location/Address.java
@@ -26,7 +26,7 @@ import android.os.Parcel;
import android.os.Parcelable;
/**
- * A class representing an Address, i.e, a set of Strings describing a location.
+ * A class representing an Address, that is, a set of Strings describing a location.
*
* The address format is a simplified version of xAL (eXtensible Address Language)
* http://www.oasis-open.org/committees/ciq/ciq.html#6
diff --git a/location/java/android/location/GnssCapabilities.java b/location/java/android/location/GnssCapabilities.java
index 62f7156d7083..c6f32c2cd387 100644
--- a/location/java/android/location/GnssCapabilities.java
+++ b/location/java/android/location/GnssCapabilities.java
@@ -246,7 +246,11 @@ public final class GnssCapabilities implements Parcelable {
}
/**
- * Returns {@code true} if GNSS chipset supports on demand time, {@code false} otherwise.
+ * Returns {@code true} if GNSS chipset requests periodic time signal injection from the
+ * platform in addition to on-demand and occasional time updates, {@code false} otherwise.
+ *
+ * <p><em>Note: The naming of this capability and the behavior it controls differ substantially.
+ * This is the result of a historic implementation bug, b/73893222.</em>
*/
public boolean hasOnDemandTime() {
return (mTopFlags & TOP_HAL_CAPABILITY_ON_DEMAND_TIME) != 0;
diff --git a/location/java/android/location/GnssMeasurementsEvent.java b/location/java/android/location/GnssMeasurementsEvent.java
index d4b861fdb0c1..4fc2ee8b7fb0 100644
--- a/location/java/android/location/GnssMeasurementsEvent.java
+++ b/location/java/android/location/GnssMeasurementsEvent.java
@@ -43,7 +43,7 @@ public final class GnssMeasurementsEvent implements Parcelable {
private final List<GnssAutomaticGainControl> mGnssAgcs;
private final boolean mIsFullTracking;
- private static final int HAS_FULL_TRACKING = 1;
+ private static final int HAS_IS_FULL_TRACKING = 1;
/**
* Used for receiving GNSS satellite measurements from the GNSS engine.
@@ -174,7 +174,7 @@ public final class GnssMeasurementsEvent implements Parcelable {
* False indicates that the GNSS chipset may optimize power via duty cycling, constellations and
* frequency limits, etc.
*
- * <p>The value is only available if {@link #hasFullTracking()} is {@code true}.
+ * <p>The value is only available if {@link #hasIsFullTracking()} is {@code true}.
*/
public boolean isFullTracking() {
return mIsFullTracking;
@@ -183,8 +183,8 @@ public final class GnssMeasurementsEvent implements Parcelable {
/**
* Return {@code true} if {@link #isFullTracking()} is available, {@code false} otherwise.
*/
- public boolean hasFullTracking() {
- return (mFlag & HAS_FULL_TRACKING) == HAS_FULL_TRACKING;
+ public boolean hasIsFullTracking() {
+ return (mFlag & HAS_IS_FULL_TRACKING) == HAS_IS_FULL_TRACKING;
}
public static final @android.annotation.NonNull Creator<GnssMeasurementsEvent> CREATOR =
@@ -227,7 +227,7 @@ public final class GnssMeasurementsEvent implements Parcelable {
builder.append(mClock);
builder.append(' ').append(mMeasurements.toString());
builder.append(' ').append(mGnssAgcs.toString());
- if (hasFullTracking()) {
+ if (hasIsFullTracking()) {
builder.append(" isFullTracking=").append(mIsFullTracking);
}
builder.append("]");
@@ -334,8 +334,8 @@ public final class GnssMeasurementsEvent implements Parcelable {
* and frequency limits, etc.
*/
@NonNull
- public Builder setFullTracking(boolean isFullTracking) {
- mFlag |= HAS_FULL_TRACKING;
+ public Builder setIsFullTracking(boolean isFullTracking) {
+ mFlag |= HAS_IS_FULL_TRACKING;
mIsFullTracking = isFullTracking;
return this;
}
@@ -344,8 +344,8 @@ public final class GnssMeasurementsEvent implements Parcelable {
* Clears the full tracking mode indicator.
*/
@NonNull
- public Builder clearFullTracking() {
- mFlag &= ~HAS_FULL_TRACKING;
+ public Builder clearIsFullTracking() {
+ mFlag &= ~HAS_IS_FULL_TRACKING;
return this;
}