Querying Data

To query data you will create a StatisticsQuery and then pass it to the execute method. This will query the data specified and when complete call a callback function with the result.

AIR

var query:StatisticQuery = ...;

Health.instance.execute( query, callback );

The callback function should be of the form:

function( result:HealthQueryResult, error:Error ):void
{
    // Process query result
}

Unity

StatisticsQuery query = ...;
Health.Instance.Execute( 
    query, 
    (result, error) =>
    {
        // Process query result
    }
);

The callback function takes 2 parameters, a HealthQueryResult and an HealthError object.

The HealthQueryResult contains the result of the query including an array of Statistic objects in the statistics parameter. If an error occurred then the error parameter will be non-null and contain the details of the error.

For example:

AIR

var now:Date = new Date();
var startDate:Date = new Date( 2023, 0, 1 );

var stepQuery:StatisticsQuery = new StatisticsQuery( HealthType.STEP_COUNT )
        .withStartDate( startDate )
        .withEndDate( now );

Health.instance.execute(
        stepQuery,
        function ( result:HealthQueryResult, error:Error ):void
        {
            if (error != null)
            {
                trace( "ERROR: " + error.message );
                return;
            }
            // result will contain query data
            for each (var stat:Statistic in result.statistics)
            {
                trace( stat.startDate.toString() + "::" + stat.sum );
            }
        }
);

Unity

System.DateTime start = new System.DateTime(2025, 10, 1);
System.DateTime end = start.AddDays(7);

StatisticsQuery query = new StatisticsQuery(HealthType.STEP_COUNT)
    .withStartDate(start)
    .withEndDate(end);

Health.Instance.Execute(
    query,
    (result, error) =>
    {
        if (error != null)
        {
            Debug.Log("QuerySteps: error: " + error.description);
            return;
        }
        if (result == null)
        {
            Debug.Log("QuerySteps: no result");
            return;
        }

        for (int i = 0; i < result.statistics.Count; i++)
        {
            Statistic statistic = result.statistics[i];
            Debug.Log(i + ": " +
                "\n startDate: " + statistic.startDate +
                "\n sum: " + statistic.sum
            );
        }
    }
);

Aggregating results

You can get the results aggregated into time intervals by calling the withInterval() method on the StatisticsQuery.

For example to group the results into daily totals:

AIR

var stepQuery:StatisticsQuery = new StatisticsQuery( HealthType.STEP_COUNT )
        .withStartDate( startDate )
        .withEndDate( now )
        .withInterval( 1, TimeUnit.DAYS );

Unity

StatisticsQuery query = new StatisticsQuery(HealthType.STEP_COUNT)
    .withStartDate(start)
    .withEndDate(end)
    .withInterval(1, TimeUnit.DAYS);

This can be useful when you are displaying results in a particular format to a user.

The withInterval() method takes 2 parameters, the first being a duration and the second is a unit from the predefined values in the TimeUnit class.

This allows you to create various intervals:

• daily results: withInterval( 1, TimeUnit.DAYS )
• 6 hour buckets: withInterval( 6, TimeUnit.HOURS )
• 30 minute buckets: withInterval( 30, TimeUnit.MINUTES )

Manual User Entries

Filtering out entries that have been manually entered by the user can be helpful in certain situations. To do this, call the filterManualDataEntries() method on the StatisticsQuery.

For example:

AIR

var stepQuery:StatisticsQuery = new StatisticsQuery( HealthType.STEP_COUNT )
        .withStartDate( startDate )
        .withEndDate( now )
        .filterManualDataEntries();

Unity

StatisticsQuery query = new StatisticsQuery(HealthType.STEP_COUNT)
    .withStartDate(start)
    .withEndDate(end)
    .filterManualDataEntries();

Conversely, you can request only manual data entries by using manualDataEntriesOnly():

AIR

var stepQuery:StatisticsQuery = new StatisticsQuery( HealthType.STEP_COUNT )
        .withStartDate( startDate )
        .withEndDate( now )
        .manualDataEntriesOnly();

Unity

StatisticsQuery query = new StatisticsQuery(HealthType.STEP_COUNT)
    .withStartDate(start)
    .withEndDate(end)   
    .manualDataEntriesOnly();

caution

Filtering data entries will override aggregation requests on Android, resulting in a query that returns individual samples. Apple's HealthKit seems to have no issues with this.

Fit

With the Google FIT API service the data records are queried within the time frame and then any with a data source set to user_input are removed. This was impossible when aggregated as the sources were combined together.

HealthConnect

Currently Health Connect seems to be inconsistent with filtering results. Similar to Google Fit the samples must be queried without aggregation to get access to the data origins, however the fields don't seem to be correctly set by certain applications so the results may be inconsistent.