Tipi di dati di Connessione Salute

Connessione Salute archivia 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 sul Play Store, devi dichiarare l'utilizzo dei dati dell'app, nonché l'accesso ai tipi di dati di Connessione Salute 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 Connessione Salute perché richiedono un'approvazione speciale.

Per maggiori informazioni, consulta la sezione Completare 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 il fitness per offrire la massima varietà possibile. Connessione Salute mira a offrire una visualizzazione e un archivio completi dei dati relativi alla salute e all'attività fisica. Questi tipi di dati rientrano nelle seguenti categorie:

Tabella: categorie di tipi di dati di Connessione Salute
Categoria Descrizione
directions_run Attività Viene acquisita qualsiasi attività svolta da un utente. Può includere attività di salute e fitness come corsa e nuoto.
raddrizza Misurazione del corpo Acquisisce dati comuni relativi al corpo, come il peso di un utente e il suo metabolismo basale.
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 Vitals Queste informazioni essenziali riguardano la 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.

Campi del tipo di dati

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

Tabella: descrizioni dei campi del tipo di dati
Campo Descrizione
programmazione 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.
raddrizza Unità L'unità di misura per il tipo di dati (ad esempio, calorie, metri, conteggio).
stella Campi obbligatori Questi sono i campi essenziali che devono essere inclusi quando scrivi i dati per questo tipo di dati per contribuire a mantenere l'integrità e l'utilità dei dati.

Tipi di dati relativi a salute e attività fisica

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

Per leggere i dati mentre l'app è in background o per leggere i dati storici, deve essere dichiarato un insieme aggiuntivo di autorizzazioni di lettura separatamente dalle autorizzazioni per il tipo di dati:

Tabella: autorizzazioni di lettura aggiuntive per i tipi di dati di Connessione Salute
Autorizzazione di lettura aggiuntiva Dichiarazione delle autorizzazioni
Leggi i dati in background
  Guida Esempio di lettura in background 		android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND
Leggere i dati storici
  Guida Leggere i dati più vecchi di 30 giorni 		android.permission.health.READ_HEALTH_DATA_HISTORY

1. Seleziona una versione di Jetpack

Le dichiarazioni delle autorizzazioni variano a seconda delle versioni di Jetpack, assicurati di selezionare l'intervallo di versioni di Jetpack utilizzato dalla tua app.

2. Filtrare la tabella dei tipi di dati

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

Tabella: tipi di dati di Connessione Salute
Tipo di dati
  Guide alle funzionalità		 Categoria Tipo di record
Dichiarazioni delle autorizzazioni
Flag funzionalità
Calorie bruciate durante l'attività fisica

  • Tipo di record: Intervallo
  • Unità: energia

  • Campi obbligatori

    endTime
    energy
    metadata
    startTime
Attività ActiveCaloriesBurnedRecord

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

Tipi di dati aggregati

ACTIVE_CALORIES_TOTAL
Intensità dell'attività

  • Tipo di record: Intervallo

  • Campi obbligatori

    activityIntensityType
    endTime
    metadata
    startTime
Attività ActivityIntensityRecord

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

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

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

Metabolismo basale

  • Tipo di record: istantaneo
  • Unità: Potenza

  • Campi obbligatori

    basalMetabolicRate
    metadata
    time
Misurazione corporea BasalMetabolicRateRecord

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

Tipi di dati aggregati

BASAL_CALORIES_TOTAL
Glicemia

  • Tipo di record: istantaneo

  • Campi obbligatori

    level
    specimenSource
    mealType
    relationToMeal
    metadata
    time
Parametri vitali BloodGlucoseRecord

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

Pressione sanguigna

  • Tipo di record: istantaneo
  • Unità: Pressione

  • Campi obbligatori

    systolic
    diastolic
    bodyPosition
    measurementLocation
    metadata
    time
Parametri vitali BloodPressureRecord

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

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

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

Temperatura corporea

  • Tipo di record: istantaneo
  • Unità: temperatura

  • Campi obbligatori

    temperature
    measurementLocation
    metadata
    time
Parametri vitali BodyTemperatureRecord

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

Massa d'acqua corporea

  • Tipo di record: istantaneo
  • Unità: Massa

  • Campi obbligatori

    mass
    metadata
    time
Misurazione corporea BodyWaterMassRecord

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

Massa ossea

  • Tipo di record: istantaneo
  • Unità: Massa

  • Campi obbligatori

    mass
    metadata
    time
Misurazione corporea BoneMassRecord

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

Muco cervicale

  • Tipo di record: istantaneo

  • Campi obbligatori

    appearance
    sensation
    metadata
    time
Monitoraggio del ciclo CervicalMucusRecord

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

Cadenza di pedalata

  • Tipo di record: serie

  • Campi obbligatori

    samples
    endTime
    metadata
    samples
    startTime
Attività CyclingPedalingCadenceRecord

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

Tipi di dati aggregati

RPM_AVG
RPM_MAX
RPM_MIN
Distanza

  • Tipo di record: Intervallo
  • Unità: lunghezza

  • Campi obbligatori

    distance
    endTime
    metadata
    startTime
Attività DistanceRecord

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

Tipi di dati aggregati

DISTANCE_TOTAL
Dislivello

  • Tipo di record: Intervallo
  • Unità: lunghezza

  • Campi obbligatori

    elevation
    endTime
    metadata
    startTime
Attività ElevationGainedRecord

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

Tipi di dati aggregati

ELEVATION_GAINED_TOTAL
Allenamento

  Guida Aggiungere percorsi di allenamento
  • Tipo di record: Intervallo

  • Campi obbligatori

    exerciseType
    endTime
    laps
    metadata
    segments
    startTime
Attività ExerciseSessionRecord

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

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

  • Tipo di record: Intervallo

  • Campi obbligatori

    floors
    endTime
    metadata
    startTime
Attività FloorsClimbedRecord

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

Tipi di dati aggregati

FLOORS_CLIMBED_TOTAL
Battito cardiaco

  • Tipo di record: serie

  • Campi obbligatori

    samples
    endTime
    metadata
    startTime
Parametri vitali HeartRateRecord

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

Tipi di dati aggregati

BPM_AVG
BPM_MAX
BPM_MIN
MEASUREMENTS_COUNT
Variabilità del battito cardiaco

  • Tipo di record: istantaneo

  • Campi obbligatori

    heartRateVariabilityMillis
    metadata
    time
Parametri vitali HeartRateVariabilityRmssdRecord

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

Altezza

  • Tipo di record: istantaneo
  • Unità: lunghezza

  • Campi obbligatori

    height
    metadata
    time
Misurazione corporea HeightRecord

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

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

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

Tipi di dati aggregati

VOLUME_TOTAL
Perdite intermestruali

  • Tipo di record: istantaneo

  • Campi obbligatori

    metadata
    time
Monitoraggio del ciclo IntermenstrualBleedingRecord

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

Massa magra

  • Tipo di record: istantaneo
  • Unità: Massa

  • Campi obbligatori

    mass
    metadata
    time
Misurazione corporea LeanBodyMassRecord

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

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

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


Mindfulness

  Guida Traccia la mindfulness
  • Tipo di record: Intervallo

  • Campi obbligatori

    endTime
    metadata
    mindfulnessSessionType
    startTime
Benessere MindfulnessSessionRecord

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

FEATURE_MINDFULNESS_SESSION

Tipi di dati aggregati

MINDFULNESS_DURATION_TOTAL
Alimentazione

  • Tipo di record: Intervallo
  • Unità: Massa

  • Campi obbligatori

    endTime
    mealType
    metadata
    startTime
Alimentazione NutritionRecord

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

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

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

Saturazione di ossigeno

  • Tipo di record: istantaneo

  • Campi obbligatori

    metadata
    percentage
    time
Parametri vitali OxygenSaturationRecord

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

Esercizio pianificato

  Guida ai piani di allenamento
  • Tipo di record: Intervallo

  • Campi obbligatori

    block
    endTime
    exerciseType
    hasExplicitTime
    metadata
Attività PlannedExerciseSessionRecord

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

FEATURE_PLANNED_EXERCISE
Alimentazione

  • Tipo di record: serie

  • Campi obbligatori

    endTime
    samples
    metadata
    startTime
Attività PowerRecord

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

Tipi di dati aggregati

POWER_AVG
POWER_MAX
POWER_MIN
Frequenza respiratoria

  • Tipo di record: istantaneo

  • Campi obbligatori

    metadata
    rate
    time
Parametri vitali RespiratoryRateRecord

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

Battito cardiaco a riposo

  • Tipo di record: istantaneo

  • Campi obbligatori

    beatsPerMinute
    metadata
    time
Parametri vitali RestingHeartRateRecord

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

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

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

Temperatura cutanea

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

  • Campi obbligatori

    deltas
    endTime
    measurementLocation
    metadata
    startTime
Parametri vitali SkinTemperatureRecord

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

FEATURE_SKIN_TEMPERATURE

Tipi di dati aggregati

TEMPERATURE_DELTA_AVG
TEMPERATURE_DELTA_MAX
TEMPERATURE_DELTA_MIN
Sessione di sonno

  Guida Monitorare le sessioni di sonno
  • Tipo di record: Intervallo

  • Campi obbligatori

    endTime
    metadata
    stages
    startTime
Sonno SleepSessionRecord

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

Tipi di dati aggregati

SLEEP_DURATION_TOTAL
Velocità

  • Tipo di record: serie

  • Campi obbligatori

    endTime
    metadata
    samples
    startTime
Attività SpeedRecord

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

Tipi di dati aggregati

SPEED_AVG
SPEED_MAX
SPEED_MIN
Passaggi


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

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

Tipi di dati aggregati per StepsRecord

COUNT_TOTAL

Aggrega i tipi di dati per StepsCadenceRecord

RATE_AVG
RATE_MAX
RATE_MIN
Calorie totali bruciate

  • Tipo di record: Intervallo
  • Unità: energia

  • Campi obbligatori

    endTime
    energy
    metadata
    startTime
Attività TotalCaloriesBurnedRecord

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

Tipi di dati aggregati

ENERGY_TOTAL
VO2 max

  • Tipo di record: istantaneo

  • Campi obbligatori

    measurementMethod
    metadata
    time
    vo2MillilitersPerMinuteKilogram
Attività Vo2MaxRecord

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

Peso

  • Tipo di record: istantaneo

  • Campi obbligatori

    metadata
    time
    weight
Misurazione corporea WeightRecord

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

Tipi di dati aggregati

WEIGHT_AVG
WEIGHT_MAX
WEIGHT_MIN
Spinte in sedia a rotelle

  • Tipo di record: Intervallo

  • Campi obbligatori

    count
    endTime
    metadata
    startTime
Attività WheelchairPushesRecord

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

Tipi di dati aggregati

COUNT_TOTAL