DataPoint.Builder

AI-generated Key Takeaways

• DataPoint.Builder is used to create DataPoint instances.

• You can set different types of field values for a DataPoint using methods like setActivityField, setField (for float, map, int, string), setFloatValues, and setIntValues.

• Data points representing an interval of time should use setTimeInterval, while instantaneous readings should use setTimestamp.

• The build method finalizes and returns the DataPoint object.

public static class DataPoint.Builder extends Object

Builder for DataPoint instances.

Public Method Summary

DataPoint	build() Builds and returns the DataPoint.
DataPoint.Builder	setActivityField(Field field, String activity) Sets the value of an activity field to activity.
DataPoint.Builder	setField(Field field, float value) Sets the floating point value of the given field to value.
DataPoint.Builder	setField(Field field, Map<String, Float> value) Sets the map value of the given field to value.
DataPoint.Builder	setField(Field field, int value) Sets the integer value of the given field to value.
DataPoint.Builder	setField(Field field, String value) Sets the string value of the given field to value.
DataPoint.Builder	setFloatValues(float... values) Sets the values of the data point, where the format for all of its values is float.
DataPoint.Builder	setIntValues(int... values) Sets the values of the data point, where the format for all of its values is int.
DataPoint.Builder	setTimeInterval(long startTime, long endTime, TimeUnit timeUnit) Sets the time interval of a data point that represents an interval of time.
DataPoint.Builder	setTimestamp(long timestamp, TimeUnit timeUnit) Sets the timestamp of a data point that represent an instantaneous reading, measurement, or input.

Inherited Method Summary

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Methods

public DataPoint build ()

Builds and returns the DataPoint.

public DataPoint.Builder setActivityField (Field field, String activity)

Sets the value of an activity field to activity.

Throws

IllegalArgumentException	If the given index is out of the range for this data type.
IllegalStateException	If the field isn't of format Field.FORMAT_INT32.

public DataPoint.Builder setField (Field field, float value)

Sets the floating point value of the given field to value.

Throws

IllegalArgumentException	If the given index is out of the range for this data type.
IllegalStateException	If the field isn't of format Field.FORMAT_FLOAT.

public DataPoint.Builder setField (Field field, Map<String, Float> value)

Sets the map value of the given field to value.

Throws

IllegalArgumentException	If the given index is out of the range for this data type.
IllegalStateException	If the field isn't of format Field.FORMAT_MAP.

public DataPoint.Builder setField (Field field, int value)

Sets the integer value of the given field to value.

Throws

IllegalArgumentException	If the given index is out of the range for this data type.
IllegalStateException	If the field isn't of format Field.FORMAT_INT32.

public DataPoint.Builder setField (Field field, String value)

Sets the string value of the given field to value.

Throws

IllegalArgumentException	If the given index is out of the range for this data type.
IllegalStateException	If the field isn't of format Field.FORMAT_STRING.

public DataPoint.Builder setFloatValues (float... values)

Sets the values of the data point, where the format for all of its values is float.

Parameters

values	The value for each field of the data point, in order.

public DataPoint.Builder setIntValues (int... values)

Sets the values of the data point, where the format for all of its values is int.

Parameters

values	The value for each field of the data point, in order.

public DataPoint.Builder setTimeInterval (long startTime, long endTime, TimeUnit timeUnit)

Sets the time interval of a data point that represents an interval of time. For data points that represent instantaneous readings, setTimestamp(long, TimeUnit) should be used.

Examples of data types that represent intervals include:

• DataType.TYPE_STEP_COUNT_DELTA
• DataType.TYPE_ACTIVITY_SEGMENT
• DataType.TYPE_DISTANCE_DELTA

Google Fit accepts timestamps with up to nanosecond granularity.

Parameters

startTime	The start time in the given unit, representing elapsed time since epoch.
endTime	The end time in the given unit, representing elapsed time since epoch.
timeUnit	The time unit of both start and end timestamps.

public DataPoint.Builder setTimestamp (long timestamp, TimeUnit timeUnit)

Sets the timestamp of a data point that represent an instantaneous reading, measurement, or input. For data points that represent intervals, setTimeInterval(long, long, TimeUnit) should be used.

Examples of data types with instantaneous timestamp include:

• DataType.TYPE_HEART_RATE_BPM
• DataType.TYPE_LOCATION_SAMPLE
• DataType.TYPE_SPEED

Google Fit accepts timestamps with up to nanosecond granularity for all DataTypes.

Parameters

timestamp	The timestamp in the given unit, representing elapsed time since epoch.
timeUnit	The unit of the given timestamp.