API платформы здравоохранения

Health Platform API — это API-интерфейс Android, который предоставляет разработчикам единый интерфейс для чтения, записи и обмена историческими данными о здоровье, самочувствии и фитнесе пользователя. С помощью Health Platform пользователи могут контролировать свои данные. Пользователи контролируют, какие приложения имеют доступ для чтения или записи к различным типам данных. Типы данных API платформы здравоохранения включают рост, частоту сердечных сокращений и многое другое.

API-интерфейс Health Platform предоставляет пользователям механизм хранения и совместного использования, который позволяет им выбирать, какие приложения могут получать доступ и отображать их личные данные о здоровье, фитнесе и самочувствии. Это позволяет разработчикам приложений показывать пользователям более полное представление о состоянии здоровья пользователей и более эффективно отслеживать свои данные.

Комплект разработчика программного обеспечения Health Platform API предоставляет разработчикам приложений Android все необходимое для предоставления доступа к данным о здоровье и самочувствии пользователя на некоторых устройствах Samsung, а также позволяет приложениям выполнять массовые операции, такие как вставка, удаление и чтение данных.

Начать

При использовании Health Platform имейте в виду следующее:

• Клиентские приложения должны получать от пользователя детальные разрешения на чтение или запись.
• Пользователь может отказать в разрешениях или отозвать разрешения в любой момент после этого.
• API Health Platform поддерживает только некоторые устройства Samsung.
• HealthDataClient — это клиент Health Platform и точка входа в Health Platform.

На следующем изображении показаны необходимые шаги по интеграции, которые должны выполнить разработчики:

Выпуск файлов

Выпуск Health Platform V1 содержит следующее:

• Клиентский SDK . Включите этот SDK в свое приложение, чтобы использовать API Health Platform. SDK — это репозиторий Maven, который вы можете напрямую включить в файлы сборки Gradle вашего приложения.

Установить платформу здоровья

Установите Health Platform, выполнив следующие действия:

В корневой файл build.gradle приложения добавьте репозиторий, как показано в следующем примере:

allprojects {
    ...
    repositories {
        ...
        google()
    }
}

Добавьте зависимость от Health Platform SDK в файл build.gradle вашего модуля, как показано в следующем примере:

dependencies {
   …
  implementation 'com.google.android.libraries.healthdata:health-data-api:1.0.0-alpha01'
}

Данные

Платформа здоровья хранит и структурирует данные о здоровье и фитнесе. В нем также рассматриваются основные различия между способами измерения данных разных типов. Например, измерение частоты пульса выполняется сразу, а подсчет шагов — за определенный период времени.

Ниже приведены основные объекты Health Platform и их различия:

• RawData : запись измерений и данных.
• DataType : спецификатор для распространенных типов данных о здоровье и фитнесе, таких как частота сердечных сокращений, количество жира в организме или температура тела, а также их форматы, такие как поля, только для чтения или необязательные.
• SampleData : объект RawData , который представляет собой мгновенное измерение, например частоту сердечных сокращений, артериальное давление или скорость бега.
• IntervalData : объект RawData , который представляет собой совокупное измерение, выполненное за определенный период времени, например количество пройденных шагов, пройденное расстояние или сожженные калории.
• SeriesData : объект RawData , который инкапсулирует последовательность измерений за определенный период времени. SeriesData особенно подходит для данных высокочастотных датчиков, таких как непрерывные измерения частоты пульса во время тренировки.

Каждый из трех классов RawData соответствует определенному подклассу DataType : SampleData , IntervalData и SeriesData соответствуют SampleDataType , IntervalDataType и SeriesDataType соответственно.

При вставке каждому объекту RawData платформа Health присваивает уникальный идентификатор (UID). Вы можете использовать этот UID для ссылки на определенный объект RawData в запросах на чтение, обновление или удаление.

Типы данных

Платформа здоровья включает в себя широкий набор типов данных, которые обычно используются в приложениях для здоровья и фитнеса. Данные, хранящиеся в доступных типах данных, предоставляют пользователям полное представление об их исторических данных о здоровье, физической форме и самочувствии, давая представление об их повседневной деятельности.

Каждый тип данных определяется своим форматом данных, который включает в себя следующее:

• Поля: конкретные или общие поля, связанные с типом данных. Например, тип данных насыщения крови кислородом (SpO2) имеет такие поля, как «Заголовок», «Примечания» и «Процент».
• Тип: long, double, string или enum.
• Атрибут: только для чтения, обязательный, необязательный или диапазон проверки.

Список типов данных

Получите максимальную отдачу от Health Platform, разобравшись в доступных типах данных. Health Platform поддерживает типы данных, показанные в следующей таблице. Типы данных организованы в соответствии с их форматом: выборка, интервал или серия.

Типы SampleData :

Типы IntervalData :

Типы SeriesData :

Функции разработчика

Ниже описан набор стандартных функций обработки данных, доступных в Health Platform. Платформа предоставляет стандартные функции вставки, обновления и удаления необработанных данных.

Чтение агрегированных данных

Платформа позволяет клиентам применять функцию агрегации к следующим типам AggregatedData :

• StatisticalData : средние, минимальные или максимальные значения в наборе SampleData или SeriesData , например минимальная и максимальная частота пульса во время сеанса активности.
• CumulativeData : сумма значений IntervalData , например общее количество шагов за дневной интервал.
• CountData : простой подсчет количества базовых объектов RawData , например количества сеансов активности за данную неделю. Данные подсчета можно вычислять для типов данных выборки, интервала и серии.

Подключитесь к API платформы здравоохранения

HealthDataClient — это точка входа в API платформы здравоохранения.

Следующие шаги описывают, как подключиться к Health Platform:

1. Используйте HealthDataService.getClient для создания новых экземпляров HealthDataClient .
2. Затем клиентское приложение должно запросить разрешение у пользователя с помощью метода requestPermissions (Set) .

HealthDataClient автоматически управляет подключением к базовому уровню хранения и обрабатывает все межпроцессные коммуникации (IPC) и сериализацию исходящих запросов и входящих ответов.