Update documentation of gnssRequestLocationCb
Bug: 73716887
Test: This change updates comment only. Verified it builds.
Change-Id: I580de91d95b25075af4b8e9fd7d3ed6536303616
diff --git a/gnss/1.1/IGnssCallback.hal b/gnss/1.1/IGnssCallback.hal
index 9fd71ae..fdd2ebe 100644
--- a/gnss/1.1/IGnssCallback.hal
+++ b/gnss/1.1/IGnssCallback.hal
@@ -39,11 +39,19 @@
/**
* Callback for requesting Location.
*
- * HAL implementation shall call this when it wants the framework to provide location to assist
- * with GNSS HAL operation. For example, to assist with time to first fix, and/or error
- * recovery, it may ask for a location that is independent from GNSS (e.g. from the "network"
- * LocationProvier), or to provide a Device-Based-Hybrid location to supplement A-GPS/GNSS
- * emergency call flows managed by the GNSS HAL.
+ * HAL implementation must call this when it wants the framework to provide locations to assist
+ * with GNSS HAL operation, for example, to assist with time to first fix, error recovery, or to
+ * supplement GNSS location for other clients of the GNSS HAL.
+ *
+ * If a request is made with independentFromGnss set to true, the framework must avoid
+ * providing locations derived from GNSS locations (such as "fused" location), to help improve
+ * information independence for situations such as error recovery.
+ *
+ * In response to this method call, GNSS HAL can expect zero, one, or more calls to
+ * IGnss::injectLocation or IGnss::injectBestLocation, dependent on availability of location
+ * from other sources, which may happen at some arbitrary delay. Generally speaking, HAL
+ * implementations must be able to handle calls to IGnss::injectLocation or
+ * IGnss::injectBestLocation at any time.
*
* @param independentFromGnss True if requesting a location that is independent from GNSS.
*/