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.