diff options
| author | 2021-10-31 18:11:51 -0700 | |
|---|---|---|
| committer | 2021-11-03 13:57:43 -0700 | |
| commit | fee50f1946780d6065b524f69d147756d9502193 (patch) | |
| tree | acf94e3dd83dd04edfa716c771f1cb1c242c36b6 /location/java/android | |
| parent | c5dcc019ad063335230a536ebafbb103fc3180fa (diff) | |
Clarify GNSS location is at the primary antenna
Bug: 199933846
Test: doc only
Change-Id: Ie883e0c221c8a5e28eaaa7feed6aea7b6003fab0
Diffstat (limited to 'location/java/android')
| -rw-r--r-- | location/java/android/location/LocationManager.java | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/location/java/android/location/LocationManager.java b/location/java/android/location/LocationManager.java index 42bbc7232944..0681b8da43fd 100644 --- a/location/java/android/location/LocationManager.java +++ b/location/java/android/location/LocationManager.java @@ -180,6 +180,11 @@ public class LocationManager { * <p>If present, this provider determines location using GNSS satellites. The responsiveness * and accuracy of location fixes may depend on GNSS signal conditions. * + * <p>Locations returned from this provider are with respect to the primary GNSS antenna + * position within the device. {@link #getGnssAntennaInfos()} may be used to determine the GNSS + * antenna position with respect to the Android Coordinate System, and convert between them if + * necessary. This is generally only necessary if working with high accuracy GNSS results. + * * <p>The extras Bundle for locations derived by this location provider may contain the * following key/value pairs: * <ul> @@ -1451,6 +1456,11 @@ public class LocationManager { * provider availability update will be sent. As soon as the provider is enabled again, another * provider availability update will be sent and location updates will resume. * + * <p>Locations returned from {@link #GPS_PROVIDER} are with respect to the primary GNSS antenna + * position within the device. {@link #getGnssAntennaInfos()} may be used to determine the GNSS + * antenna position with respect to the Android Coordinate System, and convert between them if + * necessary. This is generally only necessary if working with high accuracy GNSS results. + * * <p>When location callbacks are invoked, the system will hold a wakelock on your * application's behalf for some period of time, but not indefinitely. If your application * requires a long running wakelock within the location callback, you should acquire it |