Health Data Store

The SDK provides the health data store to access the health data with a user’s consent. The data in the health data store can be shared with other partner apps also.

Preparing Data Access

An application needs to connect the health data store, and acquire data permission to access the data in the health data store. The following figure shows a basic flow for working with Samsung Health.

In case of connection failure, all exceptions should be handled clearly with a proper message to the user. It helps to prevent unexpected operations on your application. For detailed code, see:

Health Data Query

HealthDataResolver helps to access the data with APIs of the following figure.

All queries except inserting data can be requested through a filter to set the target range for a query. A data query is sent asynchronously or synchronously.

Asynchronous query is used usually and you can select one of the methods for your need. See the following examples for more information.

The query result is retrieved as the following table.

    Request Result
    insert()
    update()
    delete()

    		 BaseResult
    read()

    		 ReadResult
    aggregate()

    		 AggregateResult

See data query snippets in API Reference.

Filter

HealthDataResolver.Filter is very useful to clear the data range for reading, updating, and aggregating health data. Multiple filters can be combined with:

  • and()

  • or()

See more descriptions in API Reference.

Data Normalization

The health data is stored based on the normalized unit as defined in International System of Unit (SI) in the following table.

    Item Unit
    Height cm
    Weight kg
    Temperature Celsius
    Blood glucose mmol/L
    Blood pressure mmHg
    HbA1c %
    SpO2 %
    Calorie kcal
    Speed m/s
    Distance meter
    Time millisecond
    Water intake ml
    Caffeine intake mg

Data normalization enables your application to read health data without the specific unit. It means that you should be careful to unify the data units when inserting health data to the health data store. HealthDataUnit helps to convert data value between different units.