Типы данных платформы "Здоровье и спорт" (SDK 1.0.0-alpha09 и более ранних версий)

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

Когда вы будете готовы опубликовать приложение в Google Play, вам нужно будет задекларировать использование данных в приложении, а также доступ к типам данных платформы "Здоровье и спорт", которые используются в приложении. В противном случае пользователи могут увидеть сообщение об ошибке, в котором говорится, что у приложения нет доступа к типам данных платформы "Здоровье и спорт", поскольку для этого требуется специальное разрешение.

Подробнее о том, как заполнить декларацию для приложений категории "Здоровье" в Play Console…

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

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

Таблица. Категории типов данных в сервисе "Здоровье и спорт"
Категория Описание
directions_run Действия Это позволяет фиксировать любые действия пользователя. Это могут быть занятия спортом, например бег или плавание.
straighten Физические параметры Включает общие данные о теле, например вес пользователя и скорость метаболизма.
fertile Отслеживание цикла Этот тип данных позволяет регистрировать менструальные циклы и связанные с ними элементы, например бинарный результат теста на овуляцию.
grocery Питание Это относится к типам данных о питании и потреблении воды. Первый параметр представляет собой количество воды, которое пользователь выпивает за один раз. Последний включает необязательные поля, такие как калории, сахар и магний.
sleep_auto Для сна Это позволяет собирать данные о продолжительности и типе сна пользователя.
vital_signs Vitals Это позволяет получить важную информацию об общем состоянии здоровья пользователя. К ним относятся, например, температура тела, уровень глюкозы в крови, артериальное давление и насыщение крови кислородом.
mindfulness Красота и здоровье Данные о психическом здоровье и самочувствии пользователя.

Руководства для разработчиков

В руководствах по разработке для платформы "Здоровье и спорт" рассматриваются конкретные сценарии использования, связанные со здоровьем и физической активностью. В этих руководствах рассказывается, как использовать типы данных вместе, чтобы создавать функции для следующих областей:

В таблице ниже также указано, какие руководства по взаимодействию связаны с каждым типом данных.

Поля типов данных

В таблице типов данных платформы "Здоровье и спорт" есть несколько столбцов, которые помогут вам понять структуру и требования каждого типа данных. Эти столбцы перечислены далее.

Таблица: описания полей типов данных
Поле Описание
schedule Тип записи Указывает, записываются ли данные в определенный момент времени или за интервал. Возможные значения: Interval, Instantaneous, Series.
straighten Единица измерения Единица измерения для типа данных (например, калории, метры, количество).
star Обязательные поля Это основные поля, которые необходимо включать при записи данных этого типа, чтобы обеспечить целостность и полезность данных.

Типы данных о здоровье и физической активности

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

В таблице ниже приведен полный список типов данных с указанием категории, флагов функций, руководств и деклараций разрешений.

Эта таблица предназначена для SDK платформы "Здоровье и спорт" версии 1.0.0-alpha09 и ниже. Если вы используете более позднюю версию SDK, ознакомьтесь со статьей Типы данных Здоровья и спорта для SDK версии 1.0.0-alpha10 и более поздних.

Таблица. Типы данных платформы "Здоровье и спорт"
Тип данных
Руководства
Категория Тип записи
Декларация разрешений
Флаг функции
Сожжено калорий во время активности

  Руководство по тренировкам
  Руководство по встроенному отслеживанию
  • Тип записи: интервал.
  • Раздел. Энергия
  • Обязательные поля

    endTime
    energy
    metadata
    startTime
Действия ActiveCaloriesBurnedRecord

androidx.health.permission.ActiveCaloriesBurned.READ
androidx.health.permission.ActiveCaloriesBurned.WRITE

Типы агрегированных данных

ACTIVE_CALORIES_TOTAL
Интенсивность тренировок

  Руководство по тренировкам
  • Тип записи: интервал.
  • Обязательные поля

    activityIntensityType
    endTime
    metadata
    startTime
Действия ActivityIntensityRecord


FEATURE_ACTIVITY_INTENSITY

Типы агрегированных данных

DURATION_TOTAL
INTENSITY_MINUTES_TOTAL
MODERATE_DURATION_TOTAL
VIGOROUS_DURATION_TOTAL
Базальная температура тела

  • Тип записи: мгновенная.
  • Единица измерения: температура.
  • Обязательные поля

    temperature
    measurementLocation
    metadata
    time
Отслеживание цикла BasalBodyTemperatureRecord

androidx.health.permission.BasalBodyTemperature.READ
androidx.health.permission.BasalBodyTemperature.WRITE

Скорость метаболизма (BMR)

  • Тип записи: мгновенная.
  • Единица измерения: мощность.
  • Обязательные поля

    basalMetabolicRate
    metadata
    time
Физические параметры BasalMetabolicRateRecord

androidx.health.permission.BasalMetabolicRate.READ
androidx.health.permission.BasalMetabolicRate.WRITE

Типы агрегированных данных

BASAL_CALORIES_TOTAL
Уровень глюкозы в крови

  Руководство по жизненным показателям
  • Тип записи: мгновенная.
  • Обязательные поля

    level
    specimenSource
    mealType
    relationToMeal
    metadata
    time
Жизненные показатели BloodGlucoseRecord

androidx.health.permission.BloodGlucose.READ
androidx.health.permission.BloodGlucose.WRITE

Артериальное давление

  Руководство по жизненным показателям
  • Тип записи: мгновенная.
  • Единица измерения: давление.
  • Обязательные поля

    systolic
    diastolic
    bodyPosition
    measurementLocation
    metadata
    time
Жизненные показатели BloodPressureRecord

androidx.health.permission.BloodPressure.READ
androidx.health.permission.BloodPressure.WRITE

Типы агрегированных данных

DIASTOLIC_AVG
DIASTOLIC_MAX
DIASTOLIC_MIN
SYSTOLIC_AVG
SYSTOLIC_MAX
SYSTOLIC_MIN
Жировая ткань

  • Тип записи: мгновенная.
  • Обязательные поля

    percentage
    metadata
    time
Физические параметры BodyFatRecord

androidx.health.permission.BodyFat.READ
androidx.health.permission.BodyFat.WRITE

Температура тела

  Руководство по жизненным показателям
  • Тип записи: мгновенная.
  • Единица измерения: температура.
  • Обязательные поля

    temperature
    measurementLocation
    metadata
    time
Жизненные показатели BodyTemperatureRecord

androidx.health.permission.BodyTemperature.READ
androidx.health.permission.BodyTemperature.WRITE

Масса воды в организме

  • Тип записи: мгновенная.
  • Единица измерения: масса.
  • Обязательные поля

    mass
    metadata
    time
Физические параметры BodyWaterMassRecord

androidx.health.permission.BodyWaterMass.READ
androidx.health.permission.BodyWaterMass.WRITE

Масса костей

  • Тип записи: мгновенная.
  • Единица измерения: масса.
  • Обязательные поля

    mass
    metadata
    time
Физические параметры BoneMassRecord

androidx.health.permission.BoneMass.READ
androidx.health.permission.BoneMass.WRITE

Цервикальная слизь

  • Тип записи: мгновенная.
  • Обязательные поля

    appearance
    sensation
    metadata
    time
Отслеживание цикла CervicalMucusRecord

androidx.health.permission.CervicalMucus.READ
androidx.health.permission.CervicalMucus.WRITE

Частота вращения педалей

  Руководство по тренировкам
  • Тип записи: сериал.
  • Обязательные поля

    samples
    endTime
    metadata
    samples
    startTime
Действия CyclingPedalingCadenceRecord

androidx.health.permission.Exercise.READ
androidx.health.permission.Exercise.WRITE

Типы агрегированных данных

RPM_AVG
RPM_MAX
RPM_MIN
Расстояние

  Руководство по тренировкам
  Руководство по встроенному отслеживанию
  • Тип записи: интервал.
  • Единица измерения: длина.
  • Обязательные поля

    distance
    endTime
    metadata
    startTime
Действия DistanceRecord

androidx.health.permission.Distance.READ
androidx.health.permission.Distance.WRITE

Типы агрегированных данных

DISTANCE_TOTAL
Набор высоты

  Руководство по тренировкам
  • Тип записи: интервал.
  • Единица измерения: длина.
  • Обязательные поля

    elevation
    endTime
    metadata
    startTime
Действия ElevationGainedRecord

androidx.health.permission.ElevationGained.READ
androidx.health.permission.ElevationGained.WRITE

Типы агрегированных данных

ELEVATION_GAINED_TOTAL
Тренировки

  Руководство по тренировкам
  Руководство по добавлению маршрутов тренировок
  • Тип записи: интервал.
  • Обязательные поля

    exerciseType
    endTime
    laps
    metadata
    segments
    startTime
Действия ExerciseSessionRecord

androidx.health.permission.ExerciseSession.READ
androidx.health.permission.ExerciseSession.WRITE

Типы тренировок

Посмотреть все типы тренировок
EXERCISE_TYPE_UNKNOWN
EXERCISE_TYPE_BADMINTON
EXERCISE_TYPE_BASEBALL
EXERCISE_TYPE_BASKETBALL
EXERCISE_TYPE_BIKING
EXERCISE_TYPE_BIKING_STATIONARY
EXERCISE_TYPE_BOOT_CAMP
EXERCISE_TYPE_BOXING
EXERCISE_TYPE_CALISTHENICS
EXERCISE_TYPE_CRICKET
EXERCISE_TYPE_DANCING
EXERCISE_TYPE_ELLIPTICAL
EXERCISE_TYPE_EXERCISE_CLASS
EXERCISE_TYPE_FENCING
EXERCISE_TYPE_FOOTBALL_AMERICAN
EXERCISE_TYPE_FOOTBALL_AUSTRALIAN
EXERCISE_TYPE_FRISBEE_DISC
EXERCISE_TYPE_GOLF
EXERCISE_TYPE_GUIDED_BREATHING
EXERCISE_TYPE_GYMNASTICS
EXERCISE_TYPE_HANDBALL
EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING
EXERCISE_TYPE_HIKING
EXERCISE_TYPE_ICE_HOCKEY
EXERCISE_TYPE_ICE_SKATING
EXERCISE_TYPE_MARTIAL_ARTS
EXERCISE_TYPE_PADDLING
EXERCISE_TYPE_PARAGLIDING
EXERCISE_TYPE_PILATES
EXERCISE_TYPE_RACQUETBALL
EXERCISE_TYPE_ROCK_CLIMBING
EXERCISE_TYPE_ROLLER_HOCKEY
EXERCISE_TYPE_ROWING
EXERCISE_TYPE_ROWING_MACHINE
EXERCISE_TYPE_RUGBY
EXERCISE_TYPE_RUNNING
EXERCISE_TYPE_RUNNING_TREADMILL
EXERCISE_TYPE_SAILING
EXERCISE_TYPE_SCUBA_DIVING
EXERCISE_TYPE_SKATING
EXERCISE_TYPE_SKIING
EXERCISE_TYPE_SNOWBOARDING
EXERCISE_TYPE_SNOWSHOEING
EXERCISE_TYPE_SOCCER
EXERCISE_TYPE_SOFTBALL
EXERCISE_TYPE_SQUASH
EXERCISE_TYPE_STAIR_CLIMBING
EXERCISE_TYPE_STAIR_CLIMBING_MACHINE
EXERCISE_TYPE_STRENGTH_TRAINING
EXERCISE_TYPE_STRETCHING
EXERCISE_TYPE_SURFING
EXERCISE_TYPE_SWIMMING_OPEN_WATER
EXERCISE_TYPE_SWIMMING_POOL
EXERCISE_TYPE_TABLE_TENNIS
EXERCISE_TYPE_TENNIS
EXERCISE_TYPE_VOLLEYBALL
EXERCISE_TYPE_WALKING
EXERCISE_TYPE_WATER_POLO
EXERCISE_TYPE_WEIGHTLIFTING
EXERCISE_TYPE_WHEELCHAIR
EXERCISE_TYPE_OTHER_WORKOUT
EXERCISE_TYPE_YOGA

Типы агрегированных данных

EXERCISE_DURATION_TOTAL
Пройденные этажи

  Руководство по тренировкам
  • Тип записи: интервал.
  • Обязательные поля

    floors
    endTime
    metadata
    startTime
Действия FloorsClimbedRecord

androidx.health.permission.FloorsClimbed.READ
androidx.health.permission.FloorsClimbed.WRITE

Типы агрегированных данных

FLOORS_CLIMBED_TOTAL
Пульс

  Руководство по жизненным показателям
  • Тип записи: сериал.
  • Обязательные поля

    samples
    endTime
    metadata
    startTime
Жизненные показатели HeartRateRecord

androidx.health.permission.HeartRate.READ
androidx.health.permission.HeartRate.WRITE

Типы агрегированных данных

BPM_AVG
BPM_MAX
BPM_MIN
MEASUREMENTS_COUNT
Вариабельность сердечного ритма

  Руководство по жизненным показателям
  • Тип записи: мгновенная.
  • Обязательные поля

    heartRateVariabilityMillis
    metadata
    time
Жизненные показатели HeartRateVariabilityRmssdRecord

androidx.health.permission.HeartRateVariability.READ
androidx.health.permission.HeartRateVariability.WRITE

Высота

  • Тип записи: мгновенная.
  • Единица измерения: длина.
  • Обязательные поля

    height
    metadata
    time
Физические параметры HeightRecord

androidx.health.permission.Height.READ
androidx.health.permission.Height.WRITE

Типы агрегированных данных

HEIGHT_AVG
HEIGHT_MAX
HEIGHT_MIN
Потребление воды

  • Тип записи: интервал.
  • Единица измерения: объем.
  • Обязательные поля

    endTime
    metadata
    startTime
    volume
Питание HydrationRecord

androidx.health.permission.Hydration.READ
androidx.health.permission.Hydration.WRITE

Типы агрегированных данных

VOLUME_TOTAL
Межменструальные кровотечения

  • Тип записи: мгновенная.
  • Обязательные поля

    metadata
    time
Отслеживание цикла IntermenstrualBleedingRecord

androidx.health.permission.IntermenstrualBleeding.READ
androidx.health.permission.IntermenstrualBleeding.WRITE

Сухая масса тела

  • Тип записи: мгновенная.
  • Единица измерения: масса.
  • Обязательные поля

    mass
    metadata
    time
Физические параметры LeanBodyMassRecord

androidx.health.permission.LeanBodyMass.READ
androidx.health.permission.LeanBodyMass.WRITE

Менструация


Для MenstruationFlowRecord:
  • Тип записи: мгновенная.
  • Обязательные поля

    flow
    metadata
    time

Для MenstruationPeriodRecord:
  • Тип записи: интервал.
  • Обязательные поля

    endTime
    metadata
    startTime
Отслеживание цикла MenstruationFlowRecord

MenstruationPeriodRecord

androidx.health.permission.Menstruation.READ
androidx.health.permission.Menstruation.WRITE


Осознанность

  Руководство по отслеживанию осознанности
  • Тип записи: интервал.
  • Обязательные поля

    endTime
    metadata
    mindfulnessSessionType
    startTime
Здоровье MindfulnessSessionRecord


FEATURE_MINDFULNESS_SESSION

Типы занятий по развитию осознанности

Посмотреть все типы занятий по развитию осознанности
MINDFULNESS_SESSION_TYPE_UNKNOWN
MINDFULNESS_SESSION_TYPE_MEDITATION
MINDFULNESS_SESSION_TYPE_BREATHING
MINDFULNESS_SESSION_TYPE_MUSIC
MINDFULNESS_SESSION_TYPE_MOVEMENT
MINDFULNESS_SESSION_TYPE_UNGUIDED

Типы агрегированных данных

MINDFULNESS_DURATION_TOTAL
Питание

  • Тип записи: интервал.
  • Единица измерения: масса.
  • Обязательные поля

    endTime
    mealType
    metadata
    startTime
Питание NutritionRecord

androidx.health.permission.Nutrition.READ
androidx.health.permission.Nutrition.WRITE

Типы агрегированных данных

BIOTIN_TOTAL
CAFFEINE_TOTAL
CALCIUM_TOTAL
CHLORIDE_TOTAL
CHOLESTEROL_TOTAL
CHROMIUM_TOTAL
COPPER_TOTAL
DIETARY_FIBER_TOTAL
ENERGY_FROM_FAT_TOTAL
ENERGY_TOTAL
FOLATE_TOTAL
FOLIC_ACID_TOTAL
IODINE_TOTAL
IRON_TOTAL
MAGNESIUM_TOTAL
MANGANESE_TOTAL
MOLYBDENUM_TOTAL
MONOUNSATURATED_FAT_TOTAL
NIACIN_TOTAL
PANTOTHENIC_ACID_TOTAL
PHOSPHORUS_TOTAL
POLYUNSATURATED_FAT_TOTAL
POTASSIUM_TOTAL
PROTEIN_TOTAL
RIBOFLAVIN_TOTAL
SATURATED_FAT_TOTAL
SELENIUM_TOTAL
SODIUM_TOTAL
SUGAR_TOTAL
THIAMIN_TOTAL
TOTAL_CARBOHYDRATE_TOTAL
TOTAL_FAT_TOTAL
TRANS_FAT_TOTAL
UNSATURATED_FAT_TOTAL
VITAMIN_A_TOTAL
VITAMIN_B12_TOTAL
VITAMIN_B6_TOTAL
VITAMIN_C_TOTAL
VITAMIN_D_TOTAL
VITAMIN_E_TOTAL
VITAMIN_K_TOTAL
ZINC_TOTAL
Тест на овуляцию

  • Тип записи: мгновенная.
  • Обязательные поля

    metadata
    result
    time
Отслеживание цикла OvulationTestRecord

androidx.health.permission.OvulationTest.READ
androidx.health.permission.OvulationTest.WRITE

Уровень кислорода в крови

  Руководство по жизненным показателям
  • Тип записи: мгновенная.
  • Обязательные поля

    metadata
    percentage
    time
Жизненные показатели OxygenSaturationRecord

androidx.health.permission.OxygenSaturation.READ
androidx.health.permission.OxygenSaturation.WRITE

Запланированные тренировки

  Руководство по тренировкам
  Руководство по планам тренировок
  • Тип записи: интервал.
  • Обязательные поля

    block
    endTime
    exerciseType
    hasExplicitTime
    metadata
Действия PlannedExerciseSessionRecord

androidx.health.permission.PlannedExerciseSession.READ
androidx.health.permission.PlannedExerciseSession.WRITE

FEATURE_PLANNED_EXERCISE

Мощность

  Руководство по тренировкам
  • Тип записи: сериал.
  • Обязательные поля

    endTime
    samples
    metadata
    startTime
Действия PowerRecord

androidx.health.permission.Power.READ
androidx.health.permission.Power.WRITE

Типы агрегированных данных

POWER_AVG
POWER_MAX
POWER_MIN
Частота дыхания

  Руководство по жизненным показателям
  • Тип записи: мгновенная.
  • Обязательные поля

    metadata
    rate
    time
Жизненные показатели RespiratoryRateRecord

androidx.health.permission.RespiratoryRate.READ
androidx.health.permission.RespiratoryRate.WRITE

Частота сердечных сокращений в покое

  Руководство по жизненным показателям
  • Тип записи: мгновенная.
  • Обязательные поля

    beatsPerMinute
    metadata
    time
Жизненные показатели RestingHeartRateRecord

androidx.health.permission.RestingHeartRate.READ
androidx.health.permission.RestingHeartRate.WRITE

Типы агрегированных данных

BPM_AVG
BPM_MAX
BPM_MIN
Действия сексуального характера

  • Тип записи: мгновенная.
  • Обязательные поля

    metadata
    protectionUsed
    time
Отслеживание цикла SexualActivityRecord

androidx.health.permission.SexualActivity.READ
androidx.health.permission.SexualActivity.WRITE

Температура кожи

  Руководство по жизненным показателям
  Руководство по измерению температуры кожи
  • Тип записи: Series
  • Единица измерения: температура.
  • Обязательные поля

    deltas
    endTime
    measurementLocation
    metadata
    startTime
Жизненные показатели SkinTemperatureRecord


FEATURE_SKIN_TEMPERATURE

Типы агрегированных данных

TEMPERATURE_DELTA_AVG
TEMPERATURE_DELTA_MAX
TEMPERATURE_DELTA_MIN
Сеанс сна

  Руководство по сну
  Руководство по отслеживанию сеансов сна
  • Тип записи: интервал.
  • Обязательные поля

    endTime
    metadata
    stages
    startTime
Сон SleepSessionRecord

androidx.health.permission.SleepSession.READ
androidx.health.permission.SleepSession.WRITE

Типы агрегированных данных

SLEEP_DURATION_TOTAL
Скорость

  Руководство по тренировкам
  • Тип записи: сериал.
  • Обязательные поля

    endTime
    metadata
    samples
    startTime
Действия SpeedRecord

androidx.health.permission.Speed.READ
androidx.health.permission.Speed.WRITE

Типы агрегированных данных

SPEED_AVG
SPEED_MAX
SPEED_MIN
Шаги

  Руководство по тренировкам
  Руководство по встроенному отслеживанию
  Руководство по отслеживанию шагов

Для StepsRecord:
  • Тип записи: интервал.
  • Обязательные поля

    count
    endTime
    metadata
    startTime

Для StepsCadenceRecord:
  • Тип записи: сериал.
  • Обязательные поля

    endTime
    samples
    metadata
    startTime
Действия StepsRecord

StepsCadenceRecord

androidx.health.permission.Steps.READ
androidx.health.permission.Steps.WRITE

Типы агрегированных данных для StepsRecord

COUNT_TOTAL

Типы агрегированных данных для StepsCadenceRecord

RATE_AVG
RATE_MAX
RATE_MIN
Общее количество сожженных калорий

  Руководство по тренировкам
  • Тип записи: интервал.
  • Раздел. Энергия
  • Обязательные поля

    endTime
    energy
    metadata
    startTime
Действия TotalCaloriesBurnedRecord

androidx.health.permission.TotalCaloriesBurned.READ
androidx.health.permission.TotalCaloriesBurned.WRITE

Типы агрегированных данных

ENERGY_TOTAL
МПК

  Руководство по тренировкам
  • Тип записи: мгновенная.
  • Обязательные поля

    measurementMethod
    metadata
    time
    vo2MillilitersPerMinuteKilogram
Действия Vo2MaxRecord

androidx.health.permission.VO2Max.READ
androidx.health.permission.VO2Max.WRITE

Вес

  • Тип записи: мгновенная.
  • Обязательные поля

    metadata
    time
    weight
Физические параметры WeightRecord

androidx.health.permission.Weight.READ
androidx.health.permission.Weight.WRITE

Типы агрегированных данных

WEIGHT_AVG
WEIGHT_MAX
WEIGHT_MIN
Толчки на кресле-коляске

  Руководство по тренировкам
  • Тип записи: интервал.
  • Обязательные поля

    count
    endTime
    metadata
    startTime
Действия WheelchairPushesRecord

androidx.health.permission.WheelchairPushes.READ
androidx.health.permission.WheelchairPushes.WRITE

Типы агрегированных данных

COUNT_TOTAL