Health Connect speichert und strukturiert sowohl Gesundheits- und Fitnessdaten als auch Daten aus medizinischen Aufzeichnungen. 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 | Vitalzeichen | 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. |
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 je nach Jetpack-Version. 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 |
ActiveCaloriesBurnedRecordandroid.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
| Aktivitätsintensität |
Aktivität |
ActivityIntensityRecordandroid.permission.health.READ_ACTIVITY_INTENSITY android.permission.health.WRITE_ACTIVITY_INTENSITY FEATURE_ACTIVITY_INTENSITY |
| Basaltemperatur |
Zyklus-Tracking |
BasalBodyTemperatureRecordandroid.permission.health.READ_BASAL_BODY_TEMPERATURE android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
| Grundumsatz |
Körperwerte |
BasalMetabolicRateRecordandroid.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE |
| Blutzucker |
Vitalparameter |
BloodGlucoseRecordandroid.permission.health.READ_BLOOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
| Blutdruck |
Vitalparameter |
BloodPressureRecordandroid.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE |
| Körperfett |
Körperwerte |
BodyFatRecordandroid.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
| Körpertemperatur |
Vitalparameter |
BodyTemperatureRecordandroid.permission.health.READ_BODY_TEMPERATURE android.permission.health.WRITE_BODY_TEMPERATURE |
| Gesamtkörperwasser |
Körperwerte |
BodyWaterMassRecordandroid.permission.health.READ_BODY_WATER_MASS android.permission.health.WRITE_BODY_WATER_MASS |
| Knochenmasse |
Körperwerte |
BoneMassRecordandroid.permission.health.READ_BONE_MASS android.permission.health.WRITE_BONE_MASS |
| Zervixschleim |
Zyklus-Tracking |
CervicalMucusRecordandroid.permission.health.READ_CERVICAL_MUCUS android.permission.health.WRITE_CERVICAL_MUCUS |
| Trittfrequenz beim Radfahren |
Aktivität |
CyclingPedalingCadenceRecordandroid.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE |
| Entfernung |
Aktivität |
DistanceRecordandroid.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE |
| Bewältigte Steigung |
Aktivität |
ElevationGainedRecordandroid.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED |
| Training Trainingsrouten hinzufügen – Anleitung |
Aktivität |
ExerciseSessionRecordandroid.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_YOGA |
| Aufgestiegene Stockwerke |
Aktivität |
FloorsClimbedRecordandroid.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED |
| Herzfrequenz |
Vitalparameter |
HeartRateRecordandroid.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE |
| Herzfrequenzvariabilität |
Vitalparameter |
HeartRateVariabilityRmssdRecordandroid.permission.health.READ_HEART_RATE_VARIABILITY android.permission.health.WRITE_HEART_RATE_VARIABILITY |
| Höhe |
Körperwerte |
HeightRecordandroid.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT |
| Flüssigkeitszufuhr |
Ernährung |
HydrationRecordandroid.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION |
| Zwischenblutungen |
Zyklus-Tracking |
IntermenstrualBleedingRecordandroid.permission.health.READ_INTERMENSTRUAL_BLEEDING android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
| Magere Körpermasse |
Körperwerte |
LeanBodyMassRecordandroid.permission.health.READ_LEAN_BODY_MASS android.permission.health.WRITE_LEAN_BODY_MASS |
| Menstruation |
Zyklus-Tracking |
MenstruationFlowRecordMenstruationPeriodRecordandroid.permission.health.READ_MENSTRUATION android.permission.health.WRITE_MENSTRUATION |
| Achtsamkeit Anleitung zum Erfassen von Achtsamkeit |
Wohlbefinden |
MindfulnessSessionRecordandroid.permission.health.READ_MINDFULNESS android.permission.health.WRITE_MINDFULNESS FEATURE_MINDFULNESS_SESSION |
| Ernährung |
Ernährung |
NutritionRecordandroid.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION |
| Ovulationstest |
Zyklus-Tracking |
OvulationTestRecordandroid.permission.health.READ_OVULATION_TEST android.permission.health.WRITE_OVULATION_TEST |
| Sauerstoffsättigung |
Vitalparameter |
OxygenSaturationRecordandroid.permission.health.READ_OXYGEN_SATURATION android.permission.health.WRITE_OXYGEN_SATURATION |
| Geplantes Training Leitfaden für Trainingspläne |
Aktivität |
PlannedExerciseSessionRecordandroid.permission.health.READ_PLANNED_EXERCISE android.permission.health.WRITE_PLANNED_EXERCISE FEATURE_PLANNED_EXERCISE |
| Stromversorgung |
Aktivität |
PowerRecordandroid.permission.health.READ_POWER android.permission.health.WRITE_POWER |
| Atemfrequenz |
Vitalparameter |
RespiratoryRateRecordandroid.permission.health.READ_RESPIRATORY_RATE android.permission.health.WRITE_RESPIRATORY_RATE |
| Ruheherzfrequenz |
Vitalparameter |
RestingHeartRateRecordandroid.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE |
| Sexuelle Aktivitäten |
Aktivität |
SexualActivityRecordandroid.permission.health.READ_SEXUAL_ACTIVITY android.permission.health.WRITE_SEXUAL_ACTIVITY |
| Hauttemperatur Anleitung zum Messen der Hauttemperatur |
Vitalparameter |
SkinTemperatureRecordandroid.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE FEATURE_SKIN_TEMPERATURE |
| Schlafsitzung Schlafsitzungen aufzeichnen – Anleitung |
Schlaf |
SleepSessionRecordandroid.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP |
| Geschwindigkeit |
Aktivität |
SpeedRecordandroid.permission.health.READ_SPEED android.permission.health.WRITE_SPEED |
| Schritte |
Aktivität |
StepsRecordStepsCadenceRecordandroid.permission.health.READ_STEPS android.permission.health.WRITE_STEPS |
| Insgesamt verbrannte Kalorien |
Aktivität |
TotalCaloriesBurnedRecordandroid.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED |
| Maximale Sauerstoffaufnahme |
Aktivität |
Vo2MaxRecordandroid.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
| Gewicht |
Körperwerte |
WeightRecordandroid.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT |
| Rollstuhlanschübe |
Aktivität |
WheelchairPushesRecordandroid.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES |