public final class

Value

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

Class Overview

Holder object for the value of a single field in a data point. Values are not constructed directly; a value for each field of the data type is created for each data point.

A field value has a particular format, and should be set and read using the format-specific methods. For instance, a float value should be set via setFloat(float) and read via asFloat(). Formats are defined as constants in Field

Summary

[Expand]
Inherited Constants
From interface android.os.Parcelable
Public Methods
String asActivity()
Returns the value of this object as an activity.
float asFloat()
Returns the value of this object as a float.
int asInt()
Returns the value of this object as an int.
String asString()
Returns the value of this object as a string.
void clearKey(String key)
Clears any value currently associated with the given key in the map.
boolean equals(Object o)
int getFormat()
Returns the format of this value, which matches the appropriate field in the data type definition.
Float getKeyValue(String key)
Returns the value of the given key in the map as a Float.
int hashCode()
boolean isSet()
Returns true if this object's value has been set by calling one of the setters.
void setActivity(String activity)
Updates this value object to represent an activity value.
void setFloat(float value)
Updates this value object to represent a float value.
void setInt(int value)
Updates this value object to represent an int value.
void setKeyValue(String key, float value)
Updates the value for a given key in the map to the given float value.
void setString(String value)
Updates this value object to represent a string value.
String toString()
void writeToParcel(Parcel dest, int flags)
[Expand]
Inherited Methods
From class java.lang.Object
From interface android.os.Parcelable

Public Methods

public String asActivity ()

Returns the value of this object as an activity. The integer representation of the activity is converted to a String prior to returning.

Returns
String one of the constants from FitnessActivities; UNKNOWN if the object does not hold a valid activity representation
Throws
IllegalStateException if the object does not hold an int value

public float asFloat ()

Returns the value of this object as a float.

Returns
float
Throws
IllegalStateException if the object does not hold an float value

public int asInt ()

Returns the value of this object as an int.

Returns
int
Throws
IllegalStateException if the object does not hold an int value

public String asString ()

Returns the value of this object as a string.

Returns
String
Throws
IllegalStateException if the object does not hold a string value

public void clearKey (String key)

Clears any value currently associated with the given key in the map. This method can be used only on map values.

Parameters
key String: the key we're modifying

public boolean equals (Object o)

Parameters
o Object
Returns
boolean

public int getFormat ()

Returns the format of this value, which matches the appropriate field in the data type definition.

Returns
int one of the format constants from Field

public Float getKeyValue (String key)

Returns the value of the given key in the map as a Float.

Parameters
key String
Returns
Float null if the key doesn't have a set value in the map
Throws
IllegalStateException if the object does not hold a map value

public int hashCode ()

Returns
int

public boolean isSet ()

Returns true if this object's value has been set by calling one of the setters.

Returns
boolean

public void setActivity (String activity)

Updates this value object to represent an activity value. Activities are internally represented as integers for storage.

Parameters
activity String: one of the activities from FitnessActivities

public void setFloat (float value)

Updates this value object to represent a float value. Any previous values associated with this object are erased.

Parameters
value float: the new value that this objects holds

public void setInt (int value)

Updates this value object to represent an int value. Any previous values are erased.

Parameters
value int: the new value that this object holds

public void setKeyValue (String key, float value)

Updates the value for a given key in the map to the given float value. Any previous values associated with the key are erased. This method can be used only on map values.

Key values should be kept small whenever possible. This is specially important for high frequency streams, since large keys may result in down sampling.

Parameters
key String: the key we're modifying
value float: the new value for the given key

public void setString (String value)

Updates this value object to represent a string value. Any previous values associated with this object are erased.

String values should be kept small whenever possible. This is specially important for high frequency streams, since large values may result in down sampling.

Parameters
value String: the new value that this objects holds

public String toString ()

Returns
String

public void writeToParcel (Parcel dest, int flags)

Parameters
dest Parcel
flags int