Tipi di dati di Connessione Salute (SDK 1.0.0-alpha09 e versioni precedenti)

Connessione Salute memorizza e struttura sia i dati relativi a salute e attività fisica sia i dati delle cartelle cliniche. È importante innanzitutto comprendere quali tipi di dati e autorizzazioni offre Connessione Salute per poter pianificare i requisiti della tua app.

Dopo lo sviluppo, quando ti prepari a pubblicare l'app su Google Play, devi dichiarare l'utilizzo dei dati dell'app, nonché l'accesso ai tipi di dati di Health Connect utilizzati dall'app. In caso contrario, gli utenti potrebbero visualizzare un messaggio di errore in cui la tua app non può accedere ai tipi di dati di Health Connect perché richiedono un'approvazione speciale.

Per saperne di più, consulta Completa la dichiarazione relativa alle app per la salute in Play Console.

Categorie di tipi di dati

Connessione Salute supporta i tipi di dati utilizzati nella maggior parte delle app per la salute e l'attività fisica per offrire la massima varietà possibile. Health Connect mira a offrire una visualizzazione e un archivio completi dei dati relativi alla salute e ai dati sul fitness. Questi tipi di dati rientrano nelle seguenti categorie:

Tabella: categorie di tipi di dati di Health Connect
Categoria Descrizione
directions_run Attività Viene acquisita qualsiasi attività svolta da un utente. Può includere attività di salute e fitness come corsa e nuoto.
straighten Misurazione del corpo Acquisisce dati comuni relativi al corpo, come il peso e il metabolismo basale di un utente.
fertile Monitoraggio del ciclo Vengono acquisiti i cicli mestruali e i punti dati correlati, ad esempio il risultato binario di un test di ovulazione.
grocery Alimentazione Vengono acquisiti i tipi di dati relativi a idratazione e nutrizione. Il primo rappresenta la quantità di acqua che un utente consuma in una singola bevanda. Questi ultimi includono campi facoltativi come calorie, zucchero e magnesio.
sleep_auto Sonno Vengono acquisiti i dati relativi alla durata e al tipo di sonno di un utente.
vital_signs Parametri vitali Vengono acquisite informazioni essenziali sullo stato di salute generale dell'utente. Include dati come temperatura corporea, glicemia, pressione sanguigna e saturazione di ossigeno nel sangue.
mindfulness Benessere Acquisisce dati relativi alla salute mentale e al benessere di un utente.

Guide sull'esperienza di sviluppo

Health Connect fornisce guide all'esperienza degli sviluppatori incentrate su casi d'uso specifici per la salute e il fitness. Queste guide mostrano come utilizzare insieme i tipi di dati pertinenti per creare funzionalità per le seguenti aree:

La seguente tabella dei tipi di dati indica anche quali guide all'esperienza sono associate a ciascun tipo di dati.

Campi del tipo di dati

La tabella dei tipi di dati di Health Connect include diverse colonne di campi per aiutarti a comprendere la struttura e i requisiti di ogni tipo di dati. Le colonne sono le seguenti:

Tabella: descrizioni dei campi del tipo di dati
Campo Descrizione
schedule Tipo di record Indica se i dati vengono registrati in un istante nel tempo o in un intervallo. I valori possibili sono: Interval, Instantaneous, Series.
straighten Unità L'unità di misura per il tipo di dati (ad esempio, calorie, metri, conteggio).
star Campi obbligatori Questi sono i campi essenziali che devono essere inclusi quando si scrivono dati per questo tipo di dati per contribuire a mantenere l'integrità dei dati e l'utilità.

Tipi di dati relativi a salute e attività fisica

Prima di richiedere qualsiasi autorizzazione, la tua app deve dichiararla nel manifest. Per maggiori informazioni, consulta la sezione Dichiarare le autorizzazioni della guida rapida.

La tabella seguente contiene l'elenco completo dei tipi di dati, ciascuno con categoria, guide e feature flag e dichiarazioni delle autorizzazioni.

Questa tabella si riferisce alla versione 1.0.0-alpha09 e precedenti dell'SDK Health Connect. Se utilizzi una versione successiva dell'SDK, consulta Tipi di dati di Health Connect per SDK 1.0.0-alpha10 e versioni successive.

Tabella: tipi di dati di Health Connect
Tipo di dati
  Guide		 Categoria Tipo di record
Dichiarazioni delle autorizzazioni
Flag funzionalità
Calorie attive bruciate

  Guida agli allenamenti
  • Tipo di record: intervallo
  • Unità: Energia

  • Campi obbligatori

    endTime
    energy
    metadata
    startTime
Attività ActiveCaloriesBurnedRecord

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

Tipi di dati aggregati

ACTIVE_CALORIES_TOTAL
Intensità dell'attività

  Guida agli allenamenti
  • Tipo di record: intervallo

  • Campi obbligatori

    activityIntensityType
    endTime
    metadata
    startTime
Attività ActivityIntensityRecord


FEATURE_ACTIVITY_INTENSITY

Tipi di dati aggregati

DURATION_TOTAL
INTENSITY_MINUTES_TOTAL
MODERATE_DURATION_TOTAL
VIGOROUS_DURATION_TOTAL
Temperatura corporea basale

  • Tipo di record: istantaneo
  • Unità: temperatura

  • Campi obbligatori

    temperature
    measurementLocation
    metadata
    time
Monitoraggio del ciclo BasalBodyTemperatureRecord

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

Metabolismo basale

  • Tipo di record: istantaneo
  • Unità: Alimentazione

  • Campi obbligatori

    basalMetabolicRate
    metadata
    time
Misurazione corporea BasalMetabolicRateRecord

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

Tipi di dati aggregati

BASAL_CALORIES_TOTAL
Glicemia

  Guida ai parametri vitali
  • Tipo di record: istantaneo

  • Campi obbligatori

    level
    specimenSource
    mealType
    relationToMeal
    metadata
    time
Parametri vitali BloodGlucoseRecord

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

Pressione sanguigna

  Guida ai parametri vitali
  • Tipo di record: istantaneo
  • Unità: Pressione

  • Campi obbligatori

    systolic
    diastolic
    bodyPosition
    measurementLocation
    metadata
    time
Parametri vitali BloodPressureRecord

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

Tipi di dati aggregati

DIASTOLIC_AVG
DIASTOLIC_MAX
DIASTOLIC_MIN
SYSTOLIC_AVG
SYSTOLIC_MAX
SYSTOLIC_MIN
Grasso corporeo

  • Tipo di record: istantaneo

  • Campi obbligatori

    percentage
    metadata
    time
Misurazione corporea BodyFatRecord

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

Temperatura corporea

  Guida ai segni vitali
  • Tipo di record: istantaneo
  • Unità: temperatura

  • Campi obbligatori

    temperature
    measurementLocation
    metadata
    time
Parametri vitali BodyTemperatureRecord

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

Massa d'acqua corporea

  • Tipo di record: istantaneo
  • Unità: Massa

  • Campi obbligatori

    mass
    metadata
    time
Misurazione corporea BodyWaterMassRecord

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

Massa ossea

  • Tipo di record: istantaneo
  • Unità: Massa

  • Campi obbligatori

    mass
    metadata
    time
Misurazione corporea BoneMassRecord

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

Muco cervicale

  • Tipo di record: istantaneo

  • Campi obbligatori

    appearance
    sensation
    metadata
    time
Monitoraggio del ciclo CervicalMucusRecord

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

Cadenza di pedalata in bici

  Guida agli allenamenti
  • Tipo di record: serie

  • Campi obbligatori

    samples
    endTime
    metadata
    samples
    startTime
Attività CyclingPedalingCadenceRecord

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

Tipi di dati aggregati

RPM_AVG
RPM_MAX
RPM_MIN
Distanza

  Guida agli allenamenti
  • Tipo di record: intervallo
  • Unità: lunghezza

  • Campi obbligatori

    distance
    endTime
    metadata
    startTime
Attività DistanceRecord

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

Tipi di dati aggregati

DISTANCE_TOTAL
Dislivello positivo

  Guida agli allenamenti
  • Tipo di record: intervallo
  • Unità: lunghezza

  • Campi obbligatori

    elevation
    endTime
    metadata
    startTime
Attività ElevationGainedRecord

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

Tipi di dati aggregati

ELEVATION_GAINED_TOTAL
Allenamento

  Guida agli allenamenti
  Guida all'aggiunta di percorsi di allenamento
  • Tipo di record: intervallo

  • Campi obbligatori

    exerciseType
    endTime
    laps
    metadata
    segments
    startTime
Attività ExerciseSessionRecord

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

Tipi di allenamento

Visualizza tutti i tipi di allenamento
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

Tipi di dati aggregati

EXERCISE_DURATION_TOTAL
Piani saliti

  Guida agli allenamenti
  • Tipo di record: intervallo

  • Campi obbligatori

    floors
    endTime
    metadata
    startTime
Attività FloorsClimbedRecord

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

Tipi di dati aggregati

FLOORS_CLIMBED_TOTAL
Frequenza cardiaca

  Guida ai parametri vitali
  • Tipo di record: serie

  • Campi obbligatori

    samples
    endTime
    metadata
    startTime
Parametri vitali HeartRateRecord

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

Tipi di dati aggregati

BPM_AVG
BPM_MAX
BPM_MIN
MEASUREMENTS_COUNT
Variabilità del battito cardiaco

  Guida ai segnali vitali
  • Tipo di record: istantaneo

  • Campi obbligatori

    heartRateVariabilityMillis
    metadata
    time
Parametri vitali HeartRateVariabilityRmssdRecord

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

Altezza

  • Tipo di record: istantaneo
  • Unità: lunghezza

  • Campi obbligatori

    height
    metadata
    time
Misurazione corporea HeightRecord

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

Tipi di dati aggregati

HEIGHT_AVG
HEIGHT_MAX
HEIGHT_MIN
Idratazione

  • Tipo di record: intervallo
  • Unità: Volume

  • Campi obbligatori

    endTime
    metadata
    startTime
    volume
Alimentazione HydrationRecord

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

Tipi di dati aggregati

VOLUME_TOTAL
Perdite intermestruali

  • Tipo di record: istantaneo

  • Campi obbligatori

    metadata
    time
Monitoraggio del ciclo IntermenstrualBleedingRecord

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

Massa magra

  • Tipo di record: istantaneo
  • Unità: Massa

  • Campi obbligatori

    mass
    metadata
    time
Misurazione corporea LeanBodyMassRecord

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

Mestruazioni


Per MenstruationFlowRecord:
  • Tipo di record: istantaneo

  • Campi obbligatori

    flow
    metadata
    time

Per MenstruationPeriodRecord:
  • Tipo di record: intervallo

  • Campi obbligatori

    endTime
    metadata
    startTime
Monitoraggio del ciclo MenstruationFlowRecord

MenstruationPeriodRecord

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


Mindfulness

  Guida al monitoraggio della mindfulness
  • Tipo di record: intervallo

  • Campi obbligatori

    endTime
    metadata
    mindfulnessSessionType
    startTime
Benessere MindfulnessSessionRecord


FEATURE_MINDFULNESS_SESSION

Tipi di sessioni di mindfulness

Visualizza tutti i tipi di sessioni di mindfulness
MINDFULNESS_SESSION_TYPE_UNKNOWN
MINDFULNESS_SESSION_TYPE_MEDITATION
MINDFULNESS_SESSION_TYPE_BREATHING
MINDFULNESS_SESSION_TYPE_MUSIC
MINDFULNESS_SESSION_TYPE_MOVEMENT
MINDFULNESS_SESSION_TYPE_UNGUIDED

Tipi di dati aggregati

MINDFULNESS_DURATION_TOTAL
Alimentazione

  • Tipo di record: intervallo
  • Unità: Massa

  • Campi obbligatori

    endTime
    mealType
    metadata
    startTime
Alimentazione NutritionRecord

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

Tipi di dati aggregati

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
Test di ovulazione

  • Tipo di record: istantaneo

  • Campi obbligatori

    metadata
    result
    time
Monitoraggio del ciclo OvulationTestRecord

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

Saturazione di ossigeno

  Guida ai segni vitali
  • Tipo di record: istantaneo

  • Campi obbligatori

    metadata
    percentage
    time
Parametri vitali OxygenSaturationRecord

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

Esercizio pianificato

  Guida agli allenamenti
  Guida ai piani di allenamento
  • Tipo di record: intervallo

  • Campi obbligatori

    block
    endTime
    exerciseType
    hasExplicitTime
    metadata
Attività PlannedExerciseSessionRecord

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

FEATURE_PLANNED_EXERCISE
Alimentazione

  Guida agli allenamenti
  • Tipo di record: serie

  • Campi obbligatori

    endTime
    samples
    metadata
    startTime
Attività PowerRecord

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

Tipi di dati aggregati

POWER_AVG
POWER_MAX
POWER_MIN
Frequenza respiratoria

  Guida ai segni vitali
  • Tipo di record: istantaneo

  • Campi obbligatori

    metadata
    rate
    time
Parametri vitali RespiratoryRateRecord

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

Battito cardiaco a riposo

  Guida ai segnali vitali
  • Tipo di record: istantaneo

  • Campi obbligatori

    beatsPerMinute
    metadata
    time
Parametri vitali RestingHeartRateRecord

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

Tipi di dati aggregati

BPM_AVG
BPM_MAX
BPM_MIN
Attività sessuale

  • Tipo di record: istantaneo

  • Campi obbligatori

    metadata
    protectionUsed
    time
Monitoraggio del ciclo SexualActivityRecord

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

Temperatura cutanea

  Guida ai parametri vitali
  Guida alla misurazione della temperatura cutanea
  • Tipo di record: serie
  • Unità: temperatura

  • Campi obbligatori

    deltas
    endTime
    measurementLocation
    metadata
    startTime
Parametri vitali SkinTemperatureRecord


FEATURE_SKIN_TEMPERATURE

Tipi di dati aggregati

TEMPERATURE_DELTA_AVG
TEMPERATURE_DELTA_MAX
TEMPERATURE_DELTA_MIN
Sessione di sonno

  Guida al sonno
  Guida al monitoraggio delle sessioni di sonno
  • Tipo di record: intervallo

  • Campi obbligatori

    endTime
    metadata
    stages
    startTime
Sonno SleepSessionRecord

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

Tipi di dati aggregati

SLEEP_DURATION_TOTAL
Velocità

  Guida Allenamenti
  • Tipo di record: serie

  • Campi obbligatori

    endTime
    metadata
    samples
    startTime
Attività SpeedRecord

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

Tipi di dati aggregati

SPEED_AVG
SPEED_MAX
SPEED_MIN
Passaggi

  Guida Allenamenti

Per StepsRecord:
  • Tipo di record: intervallo

  • Campi obbligatori

    count
    endTime
    metadata
    startTime

Per StepsCadenceRecord:
  • Tipo di record: serie

  • Campi obbligatori

    endTime
    samples
    metadata
    startTime
Attività StepsRecord

StepsCadenceRecord

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

Aggrega i tipi di dati per StepsRecord

COUNT_TOTAL

Tipi di dati aggregati per StepsCadenceRecord

RATE_AVG
RATE_MAX
RATE_MIN
Calorie bruciate totali

  Guida agli allenamenti
  • Tipo di record: intervallo
  • Unità: Energia

  • Campi obbligatori

    endTime
    energy
    metadata
    startTime
Attività TotalCaloriesBurnedRecord

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

Tipi di dati aggregati

ENERGY_TOTAL
VO2 max

  Guida agli allenamenti
  • Tipo di record: istantaneo

  • Campi obbligatori

    measurementMethod
    metadata
    time
    vo2MillilitersPerMinuteKilogram
Attività Vo2MaxRecord

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

Peso

  • Tipo di record: istantaneo

  • Campi obbligatori

    metadata
    time
    weight
Misurazione corporea WeightRecord

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

Tipi di dati aggregati

WEIGHT_AVG
WEIGHT_MAX
WEIGHT_MIN
Spinte della sedia a rotelle

  Guida agli allenamenti
  • Tipo di record: intervallo

  • Campi obbligatori

    count
    endTime
    metadata
    startTime
Attività WheelchairPushesRecord

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

Tipi di dati aggregati

COUNT_TOTAL