Health Connect speichert und strukturiert sowohl Gesundheits- und Fitnessdaten als auch medizinische Daten. Es ist wichtig, zuerst zu verstehen, welche Datentypen und Berechtigungen Health Connect bietet, damit du die Anforderungen deiner App planen kannst.
Nach der Entwicklung und wenn du deine App für die Veröffentlichung im Play Store vorbereitest, musst du die Datennutzung deiner App deklarieren und den Zugriff auf die Health Connect-Datentypen, die deine App verwendet, angeben. Andernfalls wird Nutzern möglicherweise eine Fehlermeldung angezeigt, dass deine App nicht auf die Health Connect-Datentypen zugreifen kann, weil dafür eine spezielle Genehmigung erforderlich ist.
Kategorien von Datentypen
Health Connect unterstützt Datentypen, die in den meisten Gesundheits- und Fitness-Apps verwendet werden, um möglichst große Vielfalt zu bieten. Health Connect soll einen umfassenden Überblick über Gesundheits- und Fitnessdaten bieten und diese speichern. Diese Datentypen lassen sich in die folgenden Kategorien unterteilen:
| Kategorie | Beschreibung | |
|---|---|---|
| directions_run | Aktivität | Hier werden alle Aktivitäten eines Nutzers erfasst. Dazu können auch Aktivitäten wie Laufen und Schwimmen gehören. |
| Gerade | Körpermaße | Hier werden gängige körperbezogene Daten erfasst, z. B. das Gewicht und der Grundumsatz eines Nutzers. |
| fruchtbar | Zyklus-Tracking | Hier werden Menstruationszyklen und zugehörige Daten erfasst, z. B. das binäre Ergebnis eines Ovulationstests. |
| Lebensmittel | Nutrition | Hier werden die Datentypen „Flüssigkeitszufuhr“ und „Ernährung“ erfasst. Ersterer gibt an, wie viel Wasser ein Nutzer mit einer einzelnen Portion zu sich nimmt. Letzterer enthält optionale Felder wie Kalorien, Zucker und Magnesium. |
| sleep_auto | Schlaf | Hier werden Intervalldaten zur Dauer und Art des Schlafs eines Nutzers erfasst. |
| vital_signs | Vitals | Hier werden wichtige Informationen zur allgemeinen Gesundheit des Nutzers erfasst. Dazu gehören Daten wie Körpertemperatur, Blutzucker, Blutdruck und Sauerstoffsättigung. |
| Achtsamkeit | Wellness | Hier werden Daten zur psychischen Gesundheit und zum Wohlbefinden eines Nutzers erfasst. |
Felder für Datentypen
Die Tabelle mit den Health Connect-Datentypen enthält mehrere Spalten mit Feldern, die Ihnen helfen, die Struktur und die Anforderungen der einzelnen Datentypen zu verstehen. Folgende Spalten sind verfügbar:
| Feld | Beschreibung | |
|---|---|---|
| Zeitplan | Datensatztyp | Gibt an, ob die Daten zu einem bestimmten Zeitpunkt oder über ein Intervall hinweg erfasst werden. Mögliche Werte sind: Interval, Instantaneous und Series. |
| Gerade | Einheit | Die Maßeinheit für den Datentyp (z. B. „Kalorien“, „Meter“, „Anzahl“). |
| Stern | Pflichtfelder | Dies sind die erforderlichen Felder, die beim Schreiben von Daten für diesen Datentyp enthalten sein müssen, um die Datenintegrität und Nützlichkeit zu wahren. |
Datentypen für Gesundheit und Fitness
Bevor Berechtigungen angefordert werden, müssen sie in deinem Manifest deklariert werden. Weitere Informationen finden Sie im Abschnitt Berechtigungen deklarieren der Kurzanleitung.
Wenn Sie Daten lesen möchten, während Ihre App im Hintergrund ausgeführt wird, oder wenn Sie Verlaufsdaten lesen möchten, muss ein zusätzlicher Satz von Leseberechtigungen separat von den Berechtigungen für Datentypen deklariert werden:
| Zusätzliche Leseberechtigung | Erklärung zu Berechtigungen |
|---|---|
|
Daten im Hintergrund lesen
Beispiel für das Lesen im Hintergrund |
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND |
|
Verlaufsdaten lesen
Daten lesen, die älter als 30 Tage sind |
android.permission.health.READ_HEALTH_DATA_HISTORY |
1. Jetpack-Version auswählen
Berechtigungsdeklarationen unterscheiden sich zwischen Jetpack-Versionen. Wählen Sie daher den Jetpack-Versionsbereich aus, den Ihre App verwendet.
2. Tabelle „Datentypen“ filtern
Die folgende Tabelle enthält die vollständige Liste der Datentypen mit Kategorie, Feature-Flags und Anleitungen sowie Berechtigungserklärungen.
| Datentyp Leitfäden für Funktionen |
Kategorie | Datensatztyp Erklärungen zu Berechtigungen Funktions-Flag |
|---|---|---|
Aktiv verbrannte Kalorien
|
Aktivität | ActiveCaloriesBurnedRecord
android.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED Aggregierte DatentypenACTIVE_CALORIES_TOTAL |
Aktivitätsintensität
|
Aktivität | ActivityIntensityRecord
android.permission.health.READ_ACTIVITY_INTENSITY android.permission.health.WRITE_ACTIVITY_INTENSITY FEATURE_ACTIVITY_INTENSITYAggregierte DatentypenDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
Basaltemperatur
|
Zyklus-Tracking | BasalBodyTemperatureRecord
android.permission.health.READ_BASAL_BODY_TEMPERATURE android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
Grundumsatz
|
Körperwerte | BasalMetabolicRateRecord
android.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE Aggregierte DatentypenBASAL_CALORIES_TOTAL |
Blutzucker
|
Vitalparameter | BloodGlucoseRecord
android.permission.health.READ_BLOOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
Blutdruck
|
Vitalparameter | BloodPressureRecord
android.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE Aggregierte DatentypenDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
Körperfett
|
Körperwerte | BodyFatRecord
android.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
Körpertemperatur
|
Vitalparameter | BodyTemperatureRecord
android.permission.health.READ_BODY_TEMPERATURE android.permission.health.WRITE_BODY_TEMPERATURE |
Gesamtkörperwasser
|
Körperwerte | BodyWaterMassRecord
android.permission.health.READ_BODY_WATER_MASS android.permission.health.WRITE_BODY_WATER_MASS |
Knochenmasse
|
Körperwerte | BoneMassRecord
android.permission.health.READ_BONE_MASS android.permission.health.WRITE_BONE_MASS |
Zervixschleim
|
Zyklus-Tracking | CervicalMucusRecord
android.permission.health.READ_CERVICAL_MUCUS android.permission.health.WRITE_CERVICAL_MUCUS |
Trittfrequenz beim Radfahren
|
Aktivität | CyclingPedalingCadenceRecord
android.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE Aggregierte DatentypenRPM_AVGRPM_MAXRPM_MIN |
Distanz
|
Aktivität | DistanceRecord
android.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE Aggregierte DatentypenDISTANCE_TOTAL |
Bewältigte Steigung
|
Aktivität | ElevationGainedRecord
android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED Aggregierte DatentypenELEVATION_GAINED_TOTAL |
| Training Trainingsrouten hinzufügen
|
Aktivität | ExerciseSessionRecord
android.permission.health.READ_EXERCISE android.permission.health.READ_EXERCISE_ROUTE android.permission.health.WRITE_EXERCISE android.permission.health.WRITE_EXERCISE_ROUTE TrainingstypenAlle Trainingstypen ansehenEXERCISE_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_YOGAAggregierte DatentypenEXERCISE_DURATION_TOTAL |
Aufgestiegene Stockwerke
|
Aktivität | FloorsClimbedRecord
android.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED Aggregierte DatentypenFLOORS_CLIMBED_TOTAL |
Herzfrequenz
|
Vitalparameter | HeartRateRecord
android.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE Aggregierte DatentypenBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
Herzfrequenzvariabilität
|
Vitalparameter | HeartRateVariabilityRmssdRecord
android.permission.health.READ_HEART_RATE_VARIABILITY android.permission.health.WRITE_HEART_RATE_VARIABILITY |
Höhe
|
Körperwerte | HeightRecord
android.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT Aggregierte DatentypenHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
Hydration
|
Ernährung | HydrationRecord
android.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION Aggregierte DatentypenVOLUME_TOTAL |
Zwischenblutungen
|
Zyklus-Tracking | IntermenstrualBleedingRecord
android.permission.health.READ_INTERMENSTRUAL_BLEEDING android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
Magere Körpermasse
|
Körperwerte | LeanBodyMassRecord
android.permission.health.READ_LEAN_BODY_MASS android.permission.health.WRITE_LEAN_BODY_MASS |
| Menstruation Für MenstruationFlowRecord:
Für MenstruationPeriodRecord:
|
Zyklus-Tracking | MenstruationFlowRecord
MenstruationPeriodRecord
android.permission.health.READ_MENSTRUATION android.permission.health.WRITE_MENSTRUATION |
| Achtsamkeit Anleitung zum Erfassen von Achtsamkeit
|
Wohlbefinden | MindfulnessSessionRecord
android.permission.health.READ_MINDFULNESS android.permission.health.WRITE_MINDFULNESS FEATURE_MINDFULNESS_SESSIONAggregierte DatentypenMINDFULNESS_DURATION_TOTAL |
Ernährung
|
Ernährung | NutritionRecord
android.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION Aggregierte DatentypenBIOTIN_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 |
Ovulationstest
|
Zyklus-Tracking | OvulationTestRecord
android.permission.health.READ_OVULATION_TEST android.permission.health.WRITE_OVULATION_TEST |
Sauerstoffsättigung
|
Vitalparameter | OxygenSaturationRecord
android.permission.health.READ_OXYGEN_SATURATION android.permission.health.WRITE_OXYGEN_SATURATION |
| Geplantes Training Anleitung für Trainingspläne
|
Aktivität | PlannedExerciseSessionRecord
android.permission.health.READ_PLANNED_EXERCISE android.permission.health.WRITE_PLANNED_EXERCISE FEATURE_PLANNED_EXERCISE |
Stromversorgung
|
Aktivität | PowerRecord
android.permission.health.READ_POWER android.permission.health.WRITE_POWER Aggregierte DatentypenPOWER_AVGPOWER_MAXPOWER_MIN |
Atemfrequenz
|
Vitalparameter | RespiratoryRateRecord
android.permission.health.READ_RESPIRATORY_RATE android.permission.health.WRITE_RESPIRATORY_RATE |
Ruheherzfrequenz
|
Vitalparameter | RestingHeartRateRecord
android.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE Aggregierte DatentypenBPM_AVGBPM_MAXBPM_MIN |
Sexuelle Aktivität
|
Zyklus-Tracking | SexualActivityRecord
android.permission.health.READ_SEXUAL_ACTIVITY android.permission.health.WRITE_SEXUAL_ACTIVITY |
| Hauttemperatur Anleitung zum Messen der Hauttemperatur
|
Vitalparameter | SkinTemperatureRecord
android.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE FEATURE_SKIN_TEMPERATUREAggregierte DatentypenTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| Schlafsitzung Schlafsitzungen aufzeichnen
|
Schlaf | SleepSessionRecord
android.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP Aggregierte DatentypenSLEEP_DURATION_TOTAL |
Geschwindigkeit
|
Aktivität | SpeedRecord
android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED Aggregierte DatentypenSPEED_AVGSPEED_MAXSPEED_MIN |
| Schritte Für StepsRecord:
Für StepsCadenceRecord:
|
Aktivität | StepsRecord
StepsCadenceRecord
android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS Aggregierte Datentypen für StepsRecordCOUNT_TOTALZusammengefasste Datentypen für StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
Insgesamt verbrannte Kalorien
|
Aktivität | TotalCaloriesBurnedRecord
android.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED Aggregierte DatentypenENERGY_TOTAL |
Maximale Sauerstoffaufnahme
|
Aktivität | Vo2MaxRecord
android.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
Gewicht
|
Körperwerte | WeightRecord
android.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT Aggregierte DatentypenWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
Rollstuhlschübe
|
Aktivität | WheelchairPushesRecord
android.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES Aggregierte DatentypenCOUNT_TOTAL |