diff --git a/api/current.txt b/api/current.txt index 84ebdf3118f62..8be087c15c889 100644 --- a/api/current.txt +++ b/api/current.txt @@ -20583,7 +20583,7 @@ package android.location { method public double getAccumulatedDeltaRangeMeters(); method public int getAccumulatedDeltaRangeState(); method public double getAccumulatedDeltaRangeUncertaintyMeters(); - method public double getAutomaticGainControlLevelInDb(); + method public double getAutomaticGainControlLevelDb(); method public long getCarrierCycles(); method public float getCarrierFrequencyHz(); method public double getCarrierPhase(); @@ -20599,7 +20599,7 @@ package android.location { method public int getState(); method public int getSvid(); method public double getTimeOffsetNanos(); - method public boolean hasAutomaticGainControlLevelInDb(); + method public boolean hasAutomaticGainControlLevelDb(); method public boolean hasCarrierCycles(); method public boolean hasCarrierFrequencyHz(); method public boolean hasCarrierPhase(); @@ -20693,7 +20693,7 @@ package android.location { method public int getSatelliteCount(); method public int getSvid(int); method public boolean hasAlmanacData(int); - method public boolean hasCarrierFrequency(int); + method public boolean hasCarrierFrequencyHz(int); method public boolean hasEphemerisData(int); method public boolean usedInFix(int); field public static final int CONSTELLATION_BEIDOU = 5; // 0x5 diff --git a/api/system-current.txt b/api/system-current.txt index 7b0e10b1429f6..9ec51c7f8183e 100644 --- a/api/system-current.txt +++ b/api/system-current.txt @@ -22083,7 +22083,7 @@ package android.location { method public double getAccumulatedDeltaRangeMeters(); method public int getAccumulatedDeltaRangeState(); method public double getAccumulatedDeltaRangeUncertaintyMeters(); - method public double getAutomaticGainControlLevelInDb(); + method public double getAutomaticGainControlLevelDb(); method public long getCarrierCycles(); method public float getCarrierFrequencyHz(); method public double getCarrierPhase(); @@ -22099,7 +22099,7 @@ package android.location { method public int getState(); method public int getSvid(); method public double getTimeOffsetNanos(); - method public boolean hasAutomaticGainControlLevelInDb(); + method public boolean hasAutomaticGainControlLevelDb(); method public boolean hasCarrierCycles(); method public boolean hasCarrierFrequencyHz(); method public boolean hasCarrierPhase(); @@ -22193,7 +22193,7 @@ package android.location { method public int getSatelliteCount(); method public int getSvid(int); method public boolean hasAlmanacData(int); - method public boolean hasCarrierFrequency(int); + method public boolean hasCarrierFrequencyHz(int); method public boolean hasEphemerisData(int); method public boolean usedInFix(int); field public static final int CONSTELLATION_BEIDOU = 5; // 0x5 diff --git a/api/test-current.txt b/api/test-current.txt index 9dc30549d544c..ca3ef74dc4bfb 100644 --- a/api/test-current.txt +++ b/api/test-current.txt @@ -20652,7 +20652,7 @@ package android.location { method public double getAccumulatedDeltaRangeMeters(); method public int getAccumulatedDeltaRangeState(); method public double getAccumulatedDeltaRangeUncertaintyMeters(); - method public double getAutomaticGainControlLevelInDb(); + method public double getAutomaticGainControlLevelDb(); method public long getCarrierCycles(); method public float getCarrierFrequencyHz(); method public double getCarrierPhase(); @@ -20668,7 +20668,7 @@ package android.location { method public int getState(); method public int getSvid(); method public double getTimeOffsetNanos(); - method public boolean hasAutomaticGainControlLevelInDb(); + method public boolean hasAutomaticGainControlLevelDb(); method public boolean hasCarrierCycles(); method public boolean hasCarrierFrequencyHz(); method public boolean hasCarrierPhase(); @@ -20799,7 +20799,7 @@ package android.location { method public int getSatelliteCount(); method public int getSvid(int); method public boolean hasAlmanacData(int); - method public boolean hasCarrierFrequency(int); + method public boolean hasCarrierFrequencyHz(int); method public boolean hasEphemerisData(int); method public boolean usedInFix(int); field public static final int CONSTELLATION_BEIDOU = 5; // 0x5 diff --git a/location/java/android/location/GnssMeasurement.java b/location/java/android/location/GnssMeasurement.java index aac9727614eac..de85c1660ba58 100644 --- a/location/java/android/location/GnssMeasurement.java +++ b/location/java/android/location/GnssMeasurement.java @@ -670,6 +670,8 @@ public final class GnssMeasurement implements Parcelable { * related to L5 will be filled. * *

The value is only available if {@link #hasCarrierFrequencyHz()} is {@code true}. + * + * @return the carrier frequency of the signal tracked in Hz. */ public float getCarrierFrequencyHz() { return mCarrierFrequencyHz; @@ -888,10 +890,10 @@ public final class GnssMeasurement implements Parcelable { } /** - * Returns {@code true} if {@link #getAutomaticGainControlLevelInDb()} is available, + * Returns {@code true} if {@link #getAutomaticGainControlLevelDb()} is available, * {@code false} otherwise. */ - public boolean hasAutomaticGainControlLevelInDb() { + public boolean hasAutomaticGainControlLevelDb() { return isFlagSet(HAS_AUTOMATIC_GAIN_CONTROL); } @@ -908,9 +910,9 @@ public final class GnssMeasurement implements Parcelable { * components) may also affect the typical output of of this value on any given hardware design * in an open sky test - the important aspect of this output is that changes in this value are * indicative of changes on input signal power in the frequency band for this measurement. - *

The value is only available if {@link #hasAutomaticGainControlLevelInDb()} is {@code true} + *

The value is only available if {@link #hasAutomaticGainControlLevelDb()} is {@code true} */ - public double getAutomaticGainControlLevelInDb() { + public double getAutomaticGainControlLevelDb() { return mAutomaticGainControlLevelInDb; } @@ -1064,7 +1066,7 @@ public final class GnssMeasurement implements Parcelable { builder.append(String.format( format, "AgcLevelDb", - hasAutomaticGainControlLevelInDb() ? mAutomaticGainControlLevelInDb : null)); + hasAutomaticGainControlLevelDb() ? mAutomaticGainControlLevelInDb : null)); return builder.toString(); } diff --git a/location/java/android/location/GnssStatus.java b/location/java/android/location/GnssStatus.java index e90a174eb9be3..a44bc5b9db267 100644 --- a/location/java/android/location/GnssStatus.java +++ b/location/java/android/location/GnssStatus.java @@ -224,7 +224,7 @@ public final class GnssStatus { * * @param satIndex the index of the satellite in the list. */ - public boolean hasCarrierFrequency(int satIndex) { + public boolean hasCarrierFrequencyHz(int satIndex) { return (mSvidWithFlags[satIndex] & GNSS_SV_FLAGS_HAS_CARRIER_FREQUENCY) != 0; } @@ -239,7 +239,11 @@ public final class GnssStatus { * will be reported for this same satellite, in one all the values related to L1 will be filled, * and in the other all of the values related to L5 will be filled. * - *

The value is only available if {@link #hasCarrierFrequency(int satIndex)} is {@code true}. + *

The value is only available if {@link #hasCarrierFrequencyHz(int satIndex)} is {@code true}. + * + * @param satIndex the index of the satellite in the list. + * + * @return the carrier frequency of the signal tracked in Hz. */ public float getCarrierFrequencyHz(int satIndex) { return mCarrierFrequencies[satIndex];