public final class

DataSet

extends Object
implements Parcelable Parcelable
java.lang.Object
   ↳ com.google.android.gms.fitness.data.DataSet

Class Overview

Represents a fixed set of data points in a data type's stream from a particular data source. A data set usually represents data at fixed time boundaries, and can be used both for batch data insertion and as a result of read requests.

Here's a sample usage for populating a data source with activity data:

     DataType dataType = DataTypes.ACTIVITY_SEGMENT;
     DataSet dataSet = DataSet.create(dataSource);
     for (ActivitySegment segment : getActivitySegments()) {
       dataSet.add(dataSet.createDataPoint()
           .setTimeInterval(segment.getStartMillis(), segment.getEndTimeMillis(), MILLISECONDS))
           .setValues(segment.getActivity()));
     }
 

Summary

[Expand]
Inherited Constants
From interface android.os.Parcelable
Public Methods
void add(DataPoint dataPoint)
Adds a data point to this data set.
void addAll(Iterable<DataPoint> dataPoints)
Adds a list of data points to this data set in bulk.
static DataSet create(DataSource dataSource)
Creates a new data set to hold data points for the given dataSource.
DataPoint createDataPoint()
Creates an empty data point for this data set's data source.
boolean equals(Object o)
List<DataPoint> getDataPoints()
Returns the list of data points represented by this data set.
DataSource getDataSource()
Returns the data source which this data set represents.
DataType getDataType()
Returns the data type this data set represents.
int hashCode()
boolean isEmpty()
Returns whether this data set contains no data points.
String toString()
void writeToParcel(Parcel parcel, int flags)
[Expand]
Inherited Methods
From class java.lang.Object
From interface android.os.Parcelable

Public Methods

public void add (DataPoint dataPoint)

Adds a data point to this data set. The data points should be for the correct data type and data source, and should have its timestamp already set.

Parameters
dataPoint DataPoint
Throws
IllegalArgumentException if dataPoint has invalid data

public void addAll (Iterable<DataPoint> dataPoints)

Adds a list of data points to this data set in bulk. All data points should be for the correct data type and data source, and should have their timestamp already set.

Parameters
dataPoints Iterable

public static DataSet create (DataSource dataSource)

Creates a new data set to hold data points for the given dataSource.

Data points with the matching data source can be created using createDataPoint(), and after having the values set added to the data set via add(DataPoint).

Parameters
dataSource DataSource
Returns
DataSet
Throws
NullPointerException if specified data source is null

public DataPoint createDataPoint ()

Creates an empty data point for this data set's data source. The new data point is not added to the data set by this method. After the data point is initialized, add(DataPoint) should be called.

Returns
DataPoint

public boolean equals (Object o)

Parameters
o Object
Returns
boolean

public List<DataPoint> getDataPoints ()

Returns the list of data points represented by this data set. The data points will preserve the same order in which they were inserted.

Certain APIs that return a DataSet might insert data points in chronological order, but this isn't enforced.

Returns
List<DataPoint>

public DataSource getDataSource ()

Returns the data source which this data set represents. All of the data points in the data set are from this data source.

Returns
DataSource

public DataType getDataType ()

Returns the data type this data set represents. All of the data points in the data set are of this data type.

Returns
DataType

public int hashCode ()

Returns
int

public boolean isEmpty ()

Returns whether this data set contains no data points.

Returns
boolean true if this data set has no data points, false otherwise.

public String toString ()

Returns
String

public void writeToParcel (Parcel parcel, int flags)

Parameters
parcel Parcel
flags int