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 l'attività fisica 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:
| 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 | Parametri vitali | 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. |
Guide sull'esperienza di sviluppo
Connessione Salute 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:
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 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:
| 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:
| 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 alla lettura dei 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.
| Tipo di dati Guide |
Categoria | Tipo di record Dichiarazioni delle autorizzazioni Flag funzionalità |
|---|---|---|
| Calorie attive bruciate Guida agli allenamenti
|
Attività | ActiveCaloriesBurnedRecord
android.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED Tipi di dati aggregatiACTIVE_CALORIES_TOTAL |
| Intensità dell'attività Guida agli allenamenti
|
Attività | ActivityIntensityRecord
android.permission.health.READ_ACTIVITY_INTENSITY android.permission.health.WRITE_ACTIVITY_INTENSITY FEATURE_ACTIVITY_INTENSITYTipi di dati aggregatiDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
Temperatura corporea basale
|
Monitoraggio del ciclo | BasalBodyTemperatureRecord
android.permission.health.READ_BASAL_BODY_TEMPERATURE android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
Metabolismo basale
|
Misurazione corporea | BasalMetabolicRateRecord
android.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE Tipi di dati aggregatiBASAL_CALORIES_TOTAL |
| Glicemia Guida ai parametri vitali
|
Parametri vitali | BloodGlucoseRecord
android.permission.health.READ_BLOOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
| Pressione sanguigna Guida ai parametri vitali
|
Parametri vitali | BloodPressureRecord
android.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE Tipi di dati aggregatiDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
Grasso corporeo
|
Misurazione corporea | BodyFatRecord
android.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
| Temperatura corporea Guida ai segni vitali
|
Parametri vitali | BodyTemperatureRecord
android.permission.health.READ_BODY_TEMPERATURE android.permission.health.WRITE_BODY_TEMPERATURE |
Massa d'acqua corporea
|
Misurazione corporea | BodyWaterMassRecord
android.permission.health.READ_BODY_WATER_MASS android.permission.health.WRITE_BODY_WATER_MASS |
Massa ossea
|
Misurazione corporea | BoneMassRecord
android.permission.health.READ_BONE_MASS android.permission.health.WRITE_BONE_MASS |
Muco cervicale
|
Monitoraggio del ciclo | CervicalMucusRecord
android.permission.health.READ_CERVICAL_MUCUS android.permission.health.WRITE_CERVICAL_MUCUS |
| Cadenza di pedalata Guida agli allenamenti
|
Attività | CyclingPedalingCadenceRecord
android.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE Tipi di dati aggregatiRPM_AVGRPM_MAXRPM_MIN |
| Distanza Guida agli allenamenti
|
Attività | DistanceRecord
android.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE Tipi di dati aggregatiDISTANCE_TOTAL |
| Dislivello positivo Guida agli allenamenti
|
Attività | ElevationGainedRecord
android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED Tipi di dati aggregatiELEVATION_GAINED_TOTAL |
| Allenamento Guida agli allenamenti Guida ad aggiungere percorsi di allenamento
|
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 allenamentoVisualizza tutti i tipi di allenamentoEXERCISE_TYPE_UNKNOWNEXERCISE_TYPE_BADMINTONEXERCISE_TYPE_BASEBALLEXERCISE_TYPE_BASKETBALLEXERCISE_TYPE_BIKINGEXERCISE_TYPE_BIKING_STATIONARYEXERCISE_TYPE_BOOT_CAMPEXERCISE_TYPE_BOXINGEXERCISE_TYPE_CALISTHENICSEXERCISE_TYPE_CRICKETEXERCISE_TYPE_DANCINGEXERCISE_TYPE_ELLIPTICALEXERCISE_TYPE_EXERCISE_CLASSEXERCISE_TYPE_FENCINGEXERCISE_TYPE_FOOTBALL_AMERICANEXERCISE_TYPE_FOOTBALL_AUSTRALIANEXERCISE_TYPE_FRISBEE_DISCEXERCISE_TYPE_GOLFEXERCISE_TYPE_GUIDED_BREATHINGEXERCISE_TYPE_GYMNASTICSEXERCISE_TYPE_HANDBALLEXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAININGEXERCISE_TYPE_HIKINGEXERCISE_TYPE_ICE_HOCKEYEXERCISE_TYPE_ICE_SKATINGEXERCISE_TYPE_MARTIAL_ARTSEXERCISE_TYPE_PADDLINGEXERCISE_TYPE_PARAGLIDINGEXERCISE_TYPE_PILATESEXERCISE_TYPE_RACQUETBALLEXERCISE_TYPE_ROCK_CLIMBINGEXERCISE_TYPE_ROLLER_HOCKEYEXERCISE_TYPE_ROWINGEXERCISE_TYPE_ROWING_MACHINEEXERCISE_TYPE_RUGBYEXERCISE_TYPE_RUNNINGEXERCISE_TYPE_RUNNING_TREADMILLEXERCISE_TYPE_SAILINGEXERCISE_TYPE_SCUBA_DIVINGEXERCISE_TYPE_SKATINGEXERCISE_TYPE_SKIINGEXERCISE_TYPE_SNOWBOARDINGEXERCISE_TYPE_SNOWSHOEINGEXERCISE_TYPE_SOCCEREXERCISE_TYPE_SOFTBALLEXERCISE_TYPE_SQUASHEXERCISE_TYPE_STAIR_CLIMBINGEXERCISE_TYPE_STAIR_CLIMBING_MACHINEEXERCISE_TYPE_STRENGTH_TRAININGEXERCISE_TYPE_STRETCHINGEXERCISE_TYPE_SURFINGEXERCISE_TYPE_SWIMMING_OPEN_WATEREXERCISE_TYPE_SWIMMING_POOLEXERCISE_TYPE_TABLE_TENNISEXERCISE_TYPE_TENNISEXERCISE_TYPE_VOLLEYBALLEXERCISE_TYPE_WALKINGEXERCISE_TYPE_WATER_POLOEXERCISE_TYPE_WEIGHTLIFTINGEXERCISE_TYPE_WHEELCHAIREXERCISE_TYPE_OTHER_WORKOUTEXERCISE_TYPE_YOGATipi di dati aggregatiEXERCISE_DURATION_TOTAL |
| Piani saliti Guida agli allenamenti
|
Attività | FloorsClimbedRecord
android.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED Tipi di dati aggregatiFLOORS_CLIMBED_TOTAL |
| Battito cardiaco Guida ai segnali vitali
|
Parametri vitali | HeartRateRecord
android.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE Tipi di dati aggregatiBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| Variabilità del battito cardiaco Guida ai segni vitali
|
Parametri vitali | HeartRateVariabilityRmssdRecord
android.permission.health.READ_HEART_RATE_VARIABILITY android.permission.health.WRITE_HEART_RATE_VARIABILITY |
Altezza
|
Misurazione corporea | HeightRecord
android.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT Tipi di dati aggregatiHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
Idratazione
|
Alimentazione | HydrationRecord
android.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION Tipi di dati aggregatiVOLUME_TOTAL |
Perdite intermestruali
|
Monitoraggio del ciclo | IntermenstrualBleedingRecord
android.permission.health.READ_INTERMENSTRUAL_BLEEDING android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
Massa magra
|
Misurazione corporea | LeanBodyMassRecord
android.permission.health.READ_LEAN_BODY_MASS android.permission.health.WRITE_LEAN_BODY_MASS |
| Mestruazioni Per MenstruationFlowRecord:
Per MenstruationPeriodRecord:
|
Monitoraggio del ciclo | MenstruationFlowRecord
MenstruationPeriodRecord
android.permission.health.READ_MENSTRUATION android.permission.health.WRITE_MENSTRUATION |
| Mindfulness Guida a Monitorare la mindfulness
|
Benessere | MindfulnessSessionRecord
android.permission.health.READ_MINDFULNESS android.permission.health.WRITE_MINDFULNESS FEATURE_MINDFULNESS_SESSIONTipi di sessioni di mindfulnessVisualizza tutti i tipi di sessioni di mindfulnessMINDFULNESS_SESSION_TYPE_UNKNOWNMINDFULNESS_SESSION_TYPE_MEDITATIONMINDFULNESS_SESSION_TYPE_BREATHINGMINDFULNESS_SESSION_TYPE_MUSICMINDFULNESS_SESSION_TYPE_MOVEMENTMINDFULNESS_SESSION_TYPE_UNGUIDEDTipi di dati aggregatiMINDFULNESS_DURATION_TOTAL |
Alimentazione
|
Alimentazione | NutritionRecord
android.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION Tipi di dati aggregatiBIOTIN_TOTALCAFFEINE_TOTALCALCIUM_TOTALCHLORIDE_TOTALCHOLESTEROL_TOTALCHROMIUM_TOTALCOPPER_TOTALDIETARY_FIBER_TOTALENERGY_FROM_FAT_TOTALENERGY_TOTALFOLATE_TOTALFOLIC_ACID_TOTALIODINE_TOTALIRON_TOTALMAGNESIUM_TOTALMANGANESE_TOTALMOLYBDENUM_TOTALMONOUNSATURATED_FAT_TOTALNIACIN_TOTALPANTOTHENIC_ACID_TOTALPHOSPHORUS_TOTALPOLYUNSATURATED_FAT_TOTALPOTASSIUM_TOTALPROTEIN_TOTALRIBOFLAVIN_TOTALSATURATED_FAT_TOTALSELENIUM_TOTALSODIUM_TOTALSUGAR_TOTALTHIAMIN_TOTALTOTAL_CARBOHYDRATE_TOTALTOTAL_FAT_TOTALTRANS_FAT_TOTALUNSATURATED_FAT_TOTALVITAMIN_A_TOTALVITAMIN_B12_TOTALVITAMIN_B6_TOTALVITAMIN_C_TOTALVITAMIN_D_TOTALVITAMIN_E_TOTALVITAMIN_K_TOTALZINC_TOTAL |
Test di ovulazione
|
Monitoraggio del ciclo | OvulationTestRecord
android.permission.health.READ_OVULATION_TEST android.permission.health.WRITE_OVULATION_TEST |
| Saturazione di ossigeno Guida ai segni vitali
|
Parametri vitali | OxygenSaturationRecord
android.permission.health.READ_OXYGEN_SATURATION android.permission.health.WRITE_OXYGEN_SATURATION |
| Esercizio pianificato Guida agli allenamenti Guida ai piani di allenamento
|
Attività | PlannedExerciseSessionRecord
android.permission.health.READ_PLANNED_EXERCISE android.permission.health.WRITE_PLANNED_EXERCISE FEATURE_PLANNED_EXERCISE |
| Alimentazione Guida agli allenamenti
|
Attività | PowerRecord
android.permission.health.READ_POWER android.permission.health.WRITE_POWER Tipi di dati aggregatiPOWER_AVGPOWER_MAXPOWER_MIN |
| Frequenza respiratoria Guida ai segni vitali
|
Parametri vitali | RespiratoryRateRecord
android.permission.health.READ_RESPIRATORY_RATE android.permission.health.WRITE_RESPIRATORY_RATE |
| Battito cardiaco a riposo Guida ai segnali vitali
|
Parametri vitali | RestingHeartRateRecord
android.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE Tipi di dati aggregatiBPM_AVGBPM_MAXBPM_MIN |
Attività sessuale
|
Monitoraggio del ciclo | SexualActivityRecord
android.permission.health.READ_SEXUAL_ACTIVITY android.permission.health.WRITE_SEXUAL_ACTIVITY |
| Temperatura cutanea Guida ai segni vitali Guida alla misurazione della temperatura cutanea
|
Parametri vitali | SkinTemperatureRecord
android.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE FEATURE_SKIN_TEMPERATURETipi di dati aggregatiTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| Sessione di sonno Guida al sonno Guida al monitoraggio delle sessioni di sonno
|
Sonno | SleepSessionRecord
android.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP Tipi di dati aggregatiSLEEP_DURATION_TOTAL |
| Velocità Guida Allenamenti
|
Attività | SpeedRecord
android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED Tipi di dati aggregatiSPEED_AVGSPEED_MAXSPEED_MIN |
| Passaggi Guida Allenamenti Per StepsRecord:
Per StepsCadenceRecord:
|
Attività | StepsRecord
StepsCadenceRecord
android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS Tipi di dati aggregati per StepsRecordCOUNT_TOTALAggrega i tipi di dati per StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
| Calorie bruciate totali Guida agli allenamenti
|
Attività | TotalCaloriesBurnedRecord
android.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED Tipi di dati aggregatiENERGY_TOTAL |
| VO2 max Guida agli allenamenti
|
Attività | Vo2MaxRecord
android.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
Peso
|
Misurazione corporea | WeightRecord
android.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT Tipi di dati aggregatiWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| Spinte in sedia a rotelle Guida agli allenamenti
|
Attività | WheelchairPushesRecord
android.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES Tipi di dati aggregatiCOUNT_TOTAL |