Definition of a unique source of sensor data. Data sources can expose raw data coming from
hardware sensors on local or companion devices. They can also expose derived data, created by
transforming or merging other data sources. Multiple data sources can exist for the same
data
type
. Every data point inserted into or read from Google Fit has an associated
data source.
The data source contains enough information to uniquely identify its data, including the
hardware device
and
the application
that collected and/or transformed the data. It also holds useful metadata, such as a stream
name and the device type.
The data source's data stream can be accessed in a live fashion by registering a data source listener, or via queries over fixed time intervals.
An end-user-visible name for the data stream can be set by calling
setName(String)
or otherwise computed from the device model and application
name.
Nested Class Summary
class | DataSource.Builder | A builder that can be used to construct new data source objects. |
Constant Summary
int | DATA_QUALITY_BLOOD_GLUCOSE_ISO151972003 | This constant is deprecated. will be removed in the next version. |
int | DATA_QUALITY_BLOOD_GLUCOSE_ISO151972013 | This constant is deprecated. will be removed in the next version. |
int | DATA_QUALITY_BLOOD_PRESSURE_AAMI | This constant is deprecated. will be removed in the next version. |
int | DATA_QUALITY_BLOOD_PRESSURE_BHS_A_A | This constant is deprecated. will be removed in the next version. |
int | DATA_QUALITY_BLOOD_PRESSURE_BHS_A_B | This constant is deprecated. will be removed in the next version. |
int | DATA_QUALITY_BLOOD_PRESSURE_BHS_B_A | This constant is deprecated. will be removed in the next version. |
int | DATA_QUALITY_BLOOD_PRESSURE_BHS_B_B | This constant is deprecated. will be removed in the next version. |
int | DATA_QUALITY_BLOOD_PRESSURE_ESH2002 | This constant is deprecated. will be removed in the next version. |
int | DATA_QUALITY_BLOOD_PRESSURE_ESH2010 | This constant is deprecated. will be removed in the next version. |
String | EXTRA_DATA_SOURCE | Name for the parcelable intent extra containing a data source. |
int | TYPE_DERIVED | Type constant for a data source which exposes data which is derived from one or more existing data sources by performing transformations on the original data. |
int | TYPE_RAW | Type constant for a data source which exposes original, raw data from an external source such as a hardware sensor, a wearable device, or user input. |
Inherited Constant Summary
Public Method Summary
boolean | |
static DataSource |
extract(Intent
intent)
Extracts the data source extra from the given intent, such as an intent to
view user's data .
|
String |
getAppPackageName()
Returns the package name for the application responsible for setting the data,
or
null if unset/unknown.
|
int[] |
getDataQualityStandards()
This method is deprecated. will be removed in the next version.
|
DataType |
getDataType()
Returns the data type for data coming from this data source.
|
Device |
getDevice()
Returns the device where data is being collected, or
null if
unset.
|
String |
getName()
This method is deprecated. prefer using
getStreamName() to retrieve an identifying name for this
source.
|
String |
getStreamIdentifier()
Returns a unique identifier for the data stream produced by this data source.
|
String |
getStreamName()
Returns the specific
stream name for the stream coming from this data source, or an empty
string if unset.
|
int |
getType()
Returns the constant describing the type of this data source.
|
int |
hashCode()
|
String |
toString()
|
void |
writeToParcel(Parcel parcel, int
flags)
|
Inherited Method Summary
Constants
public static final int DATA_QUALITY_BLOOD_GLUCOSE_ISO151972003
This constant is deprecated.
will be removed in the next version.
ISO: 15197:2003
public static final int DATA_QUALITY_BLOOD_GLUCOSE_ISO151972013
This constant is deprecated.
will be removed in the next version.
ISO: 15197:2013
public static final int DATA_QUALITY_BLOOD_PRESSURE_AAMI
This constant is deprecated.
will be removed in the next version.
Association for the Advancement of Medical Instrumentation. American National Standard. Manual, electronic or automated sphygmomanometers ANSI/AAMI SP10-2002/A1. 3330 Washington Boulevard, Suite 400, Arlington, VA 22201-4598, USA: AAMI; 2003.
public static final int DATA_QUALITY_BLOOD_PRESSURE_BHS_A_A
This constant is deprecated.
will be removed in the next version.
O'Brien et al. "The British Hypertension Society Protocol for the evaluation of blood pressure measuring devices." J Hypertens 1993;11(suppl 2):S43-S63. Meets A/A quality standard.
public static final int DATA_QUALITY_BLOOD_PRESSURE_BHS_A_B
This constant is deprecated.
will be removed in the next version.
O'Brien et al. "The British Hypertension Society Protocol for the evaluation of blood pressure measuring devices." J Hypertens 1993;11(suppl 2):S43-S63. Meets A/B quality standard.
public static final int DATA_QUALITY_BLOOD_PRESSURE_BHS_B_A
This constant is deprecated.
will be removed in the next version.
O'Brien et al. "The British Hypertension Society Protocol for the evaluation of blood pressure measuring devices." J Hypertens 1993;11(suppl 2):S43-S63. Meets B/A quality standard.
public static final int DATA_QUALITY_BLOOD_PRESSURE_BHS_B_B
This constant is deprecated.
will be removed in the next version.
O'Brien et al. "The British Hypertension Society Protocol for the evaluation of blood pressure measuring devices." J Hypertens 1993;11(suppl 2):S43-S63. Meets B/B quality standard.
public static final int DATA_QUALITY_BLOOD_PRESSURE_ESH2002
This constant is deprecated.
will be removed in the next version.
O'Brien, Eoin, et al. "Working Group on Blood Pressure Monitoring of the European Society of Hypertension International Protocol for validation of blood pressure measuring devices in adults." Blood pressure monitoring 7.1 (2002): 3-17.
public static final int DATA_QUALITY_BLOOD_PRESSURE_ESH2010
This constant is deprecated.
will be removed in the next version.
O'Brien, Atkins et al. "European Society of Hypertension International Protocol revision 2010 for the validation of blood pressure measuring devices in adults." Blood Pressure Monitoring 2010, 15:23–38
public static final String EXTRA_DATA_SOURCE
Name for the parcelable intent extra containing a data source. It can be extracted
using
extract(Intent)
.
public static final int TYPE_DERIVED
Type constant for a data source which exposes data which is derived from one or more existing data sources by performing transformations on the original data.
public static final int TYPE_RAW
Type constant for a data source which exposes original, raw data from an external source such as a hardware sensor, a wearable device, or user input.
Public Methods
public boolean equals (Object other)
public static DataSource extract (Intent intent)
Extracts the data source extra from the given intent, such as an intent to
view
user's data
.
Returns
- the data source, or
null
if not found
public String getAppPackageName ()
Returns the package name for the application responsible for setting the data, or
null
if unset/unknown. PackageManager
can be used to query relevant information about the application, such as the name,
icon, logo, etc.
Data coming from local sensors or BLE devices will not have a corresponding application.
public int[] getDataQualityStandards ()
This method is deprecated.
will be removed in the next version.
Returns a list of data quality standards adhered to by this data source. Possible
values include all constants in this class prefixed with
DATA_QUALITY_
.
public DataType getDataType ()
Returns the data type for data coming from this data source. Knowing the type of a data source can be useful to perform transformations on top of raw data without using sources that are themselves computed by transforming raw data.
public Device getDevice ()
Returns the device where data is being collected, or null
if unset.
public String getName ()
This method is deprecated.
prefer using getStreamName()
to retrieve an identifying name for this source.
public String getStreamIdentifier ()
Returns a unique identifier for the data stream produced by this data source. The identifier includes, in order:
- the data source's type (raw or derived)
- the data source's
data type
- the application's package name (unique for a given application)
- the physical device's manufacturer, model, and serial number (UID)
- the data source's
stream name
.
public String getStreamName ()
Returns the specific
stream name
for the stream coming from this data source, or an empty string
if unset.
public int getType ()
Returns the constant describing the type of this data source.
Returns
- one of the constant values (
TYPE_DERIVED
orTYPE_RAW
), zero if unset. Values outside of this range should be treated as unset/unknown.