Tipos de dados do Conexão Saúde

O app Conexão Saúde armazena e estrutura dados de saúde e condicionamento físico, além de registros médicos. É importante entender primeiro quais tipos de dados e permissões a Conexão Saúde oferece para que você possa planejar os requisitos do seu app.

Após o desenvolvimento, ao se preparar para publicar o app na Google Play Store, você precisa declarar o uso de dados do app e o acesso aos tipos de dados da Conexão Saúde que ele usa. Caso contrário, os usuários poderão receber uma mensagem de erro informando que o app não pode acessar os tipos de dados do Conexão Saúde porque eles exigem aprovação especial.

Consulte Preencher a declaração de apps de saúde no Play Console para mais informações.

Categorias de tipos de dados

O Conexão Saúde oferece suporte a tipos de dados usados na maioria dos apps de saúde e fitness para oferecer a maior variedade possível. O objetivo do Conexão Saúde é oferecer uma visão abrangente e um armazenamento de dados de saúde e condicionamento físico. Esses tipos de dados se enquadram nas seguintes categorias:

Tabela: categorias de tipo de dados da Conexão Saúde
Categoria Descrição
directions_run Atividade Isso captura todas as atividades do usuário. Pode incluir atividades de saúde e fitness, como corrida e natação.
straighten Medição corporal Isso captura dados comuns relacionados ao corpo, como o peso e a taxa metabólica basal de um usuário.
fértil Monitoramento de ciclo Ele captura ciclos menstruais e pontos de dados relacionados, como o resultado binário de um teste de ovulação.
grocery Nutrition Isso captura os tipos de dados de hidratação e nutrição. Os dados de hidratação representam a quantidade de água que um usuário ingeriu em uma única bebida. Essa última opção inclui campos opcionais, como calorias, açúcar e magnésio.
sleep_auto Sleep Isso captura dados de intervalos relacionados à duração e ao tipo de sono de um usuário.
vital_signs Vitals Captura informações essenciais sobre a saúde geral do usuário. Ele inclui dados como temperatura corporal, glicemia, pressão arterial e saturação de oxigênio no sangue.
mindfulness Bem-estar Isso captura dados relacionados à saúde mental e ao bem-estar de um usuário.

Guias de experiência do desenvolvedor

A Conexão Saúde oferece guias de experiência do desenvolvedor que se concentram em casos de uso específicos de saúde e fitness. Estes guias mostram como usar tipos de dados relevantes juntos para criar recursos para:

A tabela de tipos de dados a seguir também indica quais guias de experiência estão associados a cada tipo de dado.

Campos de tipo de dados

A tabela de tipos de dados da Conexão Saúde inclui várias colunas de campo para ajudar você a entender a estrutura e os requisitos de cada tipo de dado. Estas são as colunas:

Tabela: descrições dos campos de tipo de dados
Campo Descrição
programação Tipo de registro Indica se os dados são registrados em um instante ou em um intervalo. Os valores possíveis são: Interval, Instantaneous, Series.
straighten Unidade A unidade de medida do tipo de dados (por exemplo, calorias, metros, contagem).
estrela Campos obrigatórios Esses são os campos essenciais que precisam ser incluídos ao gravar dados para esse tipo de dado, ajudando a manter a integridade de dados e a utilidade dos dados.

Tipos de dados de saúde e condicionamento físico

Antes de solicitar uma permissão, o app precisa declará-la no manifesto. Consulte a seção Declarar permissões do guia de início rápido para mais informações.

Para ler dados enquanto o app está em segundo plano ou ler dados históricos, um conjunto adicional de permissões de leitura precisa ser declarado separadamente das permissões de tipo de dados:

Tabela: permissões de leitura adicionais para tipos de dados do Conexão Saúde
Permissão de leitura adicional Declaração de permissões
Ler dados em segundo plano Guia de
  exemplo de leitura em segundo plano 		android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND
Ler dados históricos
  Guia para ler dados com mais de 30 dias 		android.permission.health.READ_HEALTH_DATA_HISTORY

1. Selecionar uma versão do Jetpack

As declarações de permissão variam entre as versões do Jetpack. Selecione o intervalo de versões do Jetpack que seu app usa.

2. Filtrar a tabela de tipos de dados

A tabela a seguir contém a lista completa de tipos de dados, cada um com categoria, flags e guias de recursos e declarações de permissão.

Tabela: tipos de dados da Conexão Saúde
Tipo de dado
  Guias		 Categoria Tipo de registro
Declarações de permissão
Flag de recurso
Calorias ativas queimadas

  Guia de treinos
  • Tipo de registro : intervalo
  • Unidade: Energia

  • Campos obrigatórios

    endTime
    energy
    metadata
    startTime
Atividade ActiveCaloriesBurnedRecord

android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED

Tipos de dados agregados

ACTIVE_CALORIES_TOTAL
Intensidade da atividade

  Guia de treinos
  • Tipo de registro : intervalo

  • Campos obrigatórios

    activityIntensityType
    endTime
    metadata
    startTime
Atividade ActivityIntensityRecord

android.permission.health.READ_ACTIVITY_INTENSITY
android.permission.health.WRITE_ACTIVITY_INTENSITY

FEATURE_ACTIVITY_INTENSITY

Tipos de dados agregados

DURATION_TOTAL
INTENSITY_MINUTES_TOTAL
MODERATE_DURATION_TOTAL
VIGOROUS_DURATION_TOTAL
Temperatura corporal basal

  • Tipo de registro : instantâneo
  • Unidade: Temperatura

  • Campos obrigatórios

    temperature
    measurementLocation
    metadata
    time
Monitoramento de ciclo BasalBodyTemperatureRecord

android.permission.health.READ_BASAL_BODY_TEMPERATURE
android.permission.health.WRITE_BASAL_BODY_TEMPERATURE

Taxa metabólica basal

  • Tipo de registro : instantâneo
  • Unidade: Potência

  • Campos obrigatórios

    basalMetabolicRate
    metadata
    time
Medidas corporais BasalMetabolicRateRecord

android.permission.health.READ_BASAL_METABOLIC_RATE
android.permission.health.WRITE_BASAL_METABOLIC_RATE

Tipos de dados agregados

BASAL_CALORIES_TOTAL
Glicemia

  Guia de sinais vitais
  • Tipo de registro : instantâneo

  • Campos obrigatórios

    level
    specimenSource
    mealType
    relationToMeal
    metadata
    time
Sinais vitais BloodGlucoseRecord

android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE

Pressão arterial

  Guia de sinais vitais
  • Tipo de registro : instantâneo
  • Unidade : pressão

  • Campos obrigatórios

    systolic
    diastolic
    bodyPosition
    measurementLocation
    metadata
    time
Sinais vitais BloodPressureRecord

android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE

Tipos de dados agregados

DIASTOLIC_AVG
DIASTOLIC_MAX
DIASTOLIC_MIN
SYSTOLIC_AVG
SYSTOLIC_MAX
SYSTOLIC_MIN
Gordura corporal

  • Tipo de registro : instantâneo

  • Campos obrigatórios

    percentage
    metadata
    time
Medidas corporais BodyFatRecord

android.permission.health.READ_BODY_FAT
android.permission.health.WRITE_BODY_FAT

Temperatura corporal

  Guia de Vitals
  • Tipo de registro : instantâneo
  • Unidade: Temperatura

  • Campos obrigatórios

    temperature
    measurementLocation
    metadata
    time
Sinais vitais BodyTemperatureRecord

android.permission.health.READ_BODY_TEMPERATURE
android.permission.health.WRITE_BODY_TEMPERATURE

Massa de água corporal

  • Tipo de registro : instantâneo
  • Unidade: massa

  • Campos obrigatórios

    mass
    metadata
    time
Medidas corporais BodyWaterMassRecord

android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS

Massa óssea

  • Tipo de registro : instantâneo
  • Unidade: massa

  • Campos obrigatórios

    mass
    metadata
    time
Medidas corporais BoneMassRecord

android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS

Muco cervical

  • Tipo de registro : instantâneo

  • Campos obrigatórios

    appearance
    sensation
    metadata
    time
Monitoramento de ciclo CervicalMucusRecord

android.permission.health.READ_CERVICAL_MUCUS
android.permission.health.WRITE_CERVICAL_MUCUS

Cadência das pedaladas no ciclismo

  Guia de treinos
  • Tipo de registro : série

  • Campos obrigatórios

    samples
    endTime
    metadata
    samples
    startTime
Atividade CyclingPedalingCadenceRecord

android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE

Tipos de dados agregados

RPM_AVG
RPM_MAX
RPM_MIN
Distância

  Guia de treinos
  • Tipo de registro : intervalo
  • Unidade : duração

  • Campos obrigatórios

    distance
    endTime
    metadata
    startTime
Atividade DistanceRecord

android.permission.health.READ_DISTANCE
android.permission.health.WRITE_DISTANCE

Tipos de dados agregados

DISTANCE_TOTAL
Elevação ganha

  Guia de treinos
  • Tipo de registro : intervalo
  • Unidade : duração

  • Campos obrigatórios

    elevation
    endTime
    metadata
    startTime
Atividade ElevationGainedRecord

android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRITE_ELEVATION_GAINED

Tipos de dados agregados

ELEVATION_GAINED_TOTAL
Exercício

  Guia de treinos
  Guia para adicionar rotas de exercícios
  • Tipo de registro : intervalo

  • Campos obrigatórios

    exerciseType
    endTime
    laps
    metadata
    segments
    startTime
Atividade ExerciseSessionRecord

android.permission.health.READ_EXERCISE
android.permission.health.READ_EXERCISE_ROUTE
android.permission.health.WRITE_EXERCISE
android.permission.health.WRITE_EXERCISE_ROUTE

Tipos de exercício

Ver todos os tipos de exercício
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

Tipos de dados agregados

EXERCISE_DURATION_TOTAL
Andares subidos

  Guia de exercícios
  • Tipo de registro : intervalo

  • Campos obrigatórios

    floors
    endTime
    metadata
    startTime
Atividade FloorsClimbedRecord

android.permission.health.READ_FLOORS_CLIMBED
android.permission.health.WRITE_FLOORS_CLIMBED

Tipos de dados agregados

FLOORS_CLIMBED_TOTAL
Frequência cardíaca

  Guia de sinais vitais
  • Tipo de registro : série

  • Campos obrigatórios

    samples
    endTime
    metadata
    startTime
Sinais vitais HeartRateRecord

android.permission.health.READ_HEART_RATE
android.permission.health.WRITE_HEART_RATE

Tipos de dados agregados

BPM_AVG
BPM_MAX
BPM_MIN
MEASUREMENTS_COUNT
Variabilidade da frequência cardíaca

  Guia de métricas vitais
  • Tipo de registro : instantâneo

  • Campos obrigatórios

    heartRateVariabilityMillis
    metadata
    time
Sinais vitais HeartRateVariabilityRmssdRecord

android.permission.health.READ_HEART_RATE_VARIABILITY
android.permission.health.WRITE_HEART_RATE_VARIABILITY

Altura

  • Tipo de registro : instantâneo
  • Unidade : duração

  • Campos obrigatórios

    height
    metadata
    time
Medidas corporais HeightRecord

android.permission.health.READ_HEIGHT
android.permission.health.WRITE_HEIGHT

Tipos de dados agregados

HEIGHT_AVG
HEIGHT_MAX
HEIGHT_MIN
Hydration

  • Tipo de registro : intervalo
  • Unidade : Volume

  • Campos obrigatórios

    endTime
    metadata
    startTime
    volume
Nutrição HydrationRecord

android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION

Tipos de dados agregados

VOLUME_TOTAL
Sangramento intermenstrual

  • Tipo de registro : instantâneo

  • Campos obrigatórios

    metadata
    time
Monitoramento de ciclo IntermenstrualBleedingRecord

android.permission.health.READ_INTERMENSTRUAL_BLEEDING
android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING

Massa corporal magra

  • Tipo de registro : instantâneo
  • Unidade: massa

  • Campos obrigatórios

    mass
    metadata
    time
Medidas corporais LeanBodyMassRecord

android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS

Menstruation


Para MenstruationFlowRecord:
  • Tipo de registro : instantâneo

  • Campos obrigatórios

    flow
    metadata
    time

Para MenstruationPeriodRecord:
  • Tipo de registro : intervalo

  • Campos obrigatórios

    endTime
    metadata
    startTime
Monitoramento de ciclo MenstruationFlowRecord

MenstruationPeriodRecord

android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION


Mindfulness

  Guia Acompanhar o mindfulness
  • Tipo de registro : intervalo

  • Campos obrigatórios

    endTime
    metadata
    mindfulnessSessionType
    startTime
Bem-estar MindfulnessSessionRecord

android.permission.health.READ_MINDFULNESS
android.permission.health.WRITE_MINDFULNESS

FEATURE_MINDFULNESS_SESSION

Tipos de dados agregados

MINDFULNESS_DURATION_TOTAL
Nutrição

  • Tipo de registro : intervalo
  • Unidade: massa

  • Campos obrigatórios

    endTime
    mealType
    metadata
    startTime
Nutrição NutritionRecord

android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION

Tipos de dados agregados

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
Teste de ovulação

  • Tipo de registro : instantâneo

  • Campos obrigatórios

    metadata
    result
    time
Monitoramento de ciclo OvulationTestRecord

android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST

Saturação de oxigênio

  Guia de sinais vitais
  • Tipo de registro : instantâneo

  • Campos obrigatórios

    metadata
    percentage
    time
Sinais vitais OxygenSaturationRecord

android.permission.health.READ_OXYGEN_SATURATION
android.permission.health.WRITE_OXYGEN_SATURATION

Exercício planejado

  Guia de treinos
  Guia de planos de treinamento
  • Tipo de registro : intervalo

  • Campos obrigatórios

    block
    endTime
    exerciseType
    hasExplicitTime
    metadata
Atividade PlannedExerciseSessionRecord

android.permission.health.READ_PLANNED_EXERCISE
android.permission.health.WRITE_PLANNED_EXERCISE

FEATURE_PLANNED_EXERCISE
Energia

  Guia de treinos
  • Tipo de registro : série

  • Campos obrigatórios

    endTime
    samples
    metadata
    startTime
Atividade PowerRecord

android.permission.health.READ_POWER
android.permission.health.WRITE_POWER

Tipos de dados agregados

POWER_AVG
POWER_MAX
POWER_MIN
Frequência respiratória

  Guia de sinais vitais
  • Tipo de registro : instantâneo

  • Campos obrigatórios

    metadata
    rate
    time
Sinais vitais RespiratoryRateRecord

android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE

Frequência cardíaca em repouso

  Guia de sinais vitais
  • Tipo de registro : instantâneo

  • Campos obrigatórios

    beatsPerMinute
    metadata
    time
Sinais vitais RestingHeartRateRecord

android.permission.health.READ_RESTING_HEART_RATE
android.permission.health.WRITE_RESTING_HEART_RATE

Tipos de dados agregados

BPM_AVG
BPM_MAX
BPM_MIN
Atividade sexual

  • Tipo de registro : instantâneo

  • Campos obrigatórios

    metadata
    protectionUsed
    time
Monitoramento de ciclo SexualActivityRecord

android.permission.health.READ_SEXUAL_ACTIVITY
android.permission.health.WRITE_SEXUAL_ACTIVITY

Temperatura da pele

  Guia de sinais vitais
  Guia de como medir a temperatura da pele
  • Tipo de registro : série
  • Unidade: Temperatura

  • Campos obrigatórios

    deltas
    endTime
    measurementLocation
    metadata
    startTime
Sinais vitais SkinTemperatureRecord

android.permission.health.READ_SKIN_TEMPERATURE
android.permission.health.WRITE_SKIN_TEMPERATURE

FEATURE_SKIN_TEMPERATURE

Tipos de dados agregados

TEMPERATURE_DELTA_AVG
TEMPERATURE_DELTA_MAX
TEMPERATURE_DELTA_MIN
Sessão de sono

  Guia Para dormir
  Guia Monitorar sessões de sono
  • Tipo de registro : intervalo

  • Campos obrigatórios

    endTime
    metadata
    stages
    startTime
Sono SleepSessionRecord

android.permission.health.READ_SLEEP
android.permission.health.WRITE_SLEEP

Tipos de dados agregados

SLEEP_DURATION_TOTAL
Velocidade

  Guia de treinos
  • Tipo de registro : série

  • Campos obrigatórios

    endTime
    metadata
    samples
    startTime
Atividade SpeedRecord

android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED

Tipos de dados agregados

SPEED_AVG
SPEED_MAX
SPEED_MIN
Etapas

  Guia Exercícios

Para StepsRecord:
  • Tipo de registro : intervalo

  • Campos obrigatórios

    count
    endTime
    metadata
    startTime

Para StepsCadenceRecord:
  • Tipo de registro : série

  • Campos obrigatórios

    endTime
    samples
    metadata
    startTime
Atividade StepsRecord

StepsCadenceRecord

android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS

Agrega tipos de dados para StepsRecord

COUNT_TOTAL

Agregar tipos de dados para StepsCadenceRecord

RATE_AVG
RATE_MAX
RATE_MIN
Total de calorias queimadas

  Guia de treinos
  • Tipo de registro : intervalo
  • Unidade: Energia

  • Campos obrigatórios

    endTime
    energy
    metadata
    startTime
Atividade TotalCaloriesBurnedRecord

android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRITE_TOTAL_CALORIES_BURNED

Tipos de dados agregados

ENERGY_TOTAL
VO₂ máx.

  Guia de treinos
  • Tipo de registro : instantâneo

  • Campos obrigatórios

    measurementMethod
    metadata
    time
    vo2MillilitersPerMinuteKilogram
Atividade Vo2MaxRecord

android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX

Peso

  • Tipo de registro : instantâneo

  • Campos obrigatórios

    metadata
    time
    weight
Medidas corporais WeightRecord

android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT

Tipos de dados agregados

WEIGHT_AVG
WEIGHT_MAX
WEIGHT_MIN
Impulsos na cadeira de rodas

  Guia de treinos
  • Tipo de registro : intervalo

  • Campos obrigatórios

    count
    endTime
    metadata
    startTime
Atividade WheelchairPushesRecord

android.permission.health.READ_WHEELCHAIR_PUSHES
android.permission.health.WRITE_WHEELCHAIR_PUSHES

Tipos de dados agregados

COUNT_TOTAL