summaryrefslogtreecommitdiffstats
path: root/include/hardware/fused_location.h
diff options
context:
space:
mode:
Diffstat (limited to 'include/hardware/fused_location.h')
-rw-r--r--include/hardware/fused_location.h17
1 files changed, 17 insertions, 0 deletions
diff --git a/include/hardware/fused_location.h b/include/hardware/fused_location.h
index 5c7821c..ff64aef 100644
--- a/include/hardware/fused_location.h
+++ b/include/hardware/fused_location.h
@@ -228,6 +228,23 @@ typedef struct {
* seconds.
*/
int64_t period_ns;
+
+ /**
+ * The smallest displacement between reported locations in meters.
+ *
+ * If set to 0, then you should report locations at the requested
+ * interval even if the device is stationary. If positive, you
+ * can use this parameter as a hint to save power (e.g. throttling
+ * location period if the user hasn't traveled close to the displacement
+ * threshold). Even small positive values can be interpreted to mean
+ * that you don't have to compute location when the device is stationary.
+ *
+ * There is no need to filter location delivery based on this parameter.
+ * Locations can be delivered even if they have a displacement smaller than
+ * requested. This parameter can safely be ignored at the cost of potential
+ * power savings.
+ */
+ float smallest_displacement_meters;
} FlpBatchOptions;
#define FLP_RESULT_SUCCESS 0