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 Sie Ihre App für die Veröffentlichung bei Google Play vorbereiten, müssen Sie die Datennutzung Ihrer App sowie den Zugriff auf die Health Connect-Datentypen deklarieren, die Ihre App verwendet. 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.
Weitere Informationen finden Sie unter Gesundheits-Apps-Erklärung in der Play Console ausfüllen.
Datentypkategorien
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. |
| straighten | Körpermaße | Hier werden gängige körperbezogene Daten erfasst, z. B. das Gewicht und der Grundumsatz eines Nutzers. |
| fertile | Zyklus-Tracking | Hier werden Menstruationszyklen und zugehörige Daten erfasst, z. B. das binäre Ergebnis eines Ovulationstests. |
| grocery | 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 | Vitalparameter | Hier werden wichtige Informationen zur allgemeinen Gesundheit des Nutzers erfasst. Dazu gehören Daten wie Körpertemperatur, Blutzucker, Blutdruck und Sauerstoffsättigung. |
| mindfulness | Wellness | Hier werden Daten zur psychischen Gesundheit und zum Wohlbefinden eines Nutzers erfasst. |
Leitfäden für Entwickler
Health Connect bietet Entwicklerleitfäden, die sich auf bestimmte Anwendungsfälle im Bereich Gesundheit und Fitness konzentrieren. In diesen Anleitungen erfahren Sie, wie Sie relevante Datentypen kombinieren, um Funktionen für die folgenden Bereiche zu entwickeln:
In der folgenden Tabelle mit Datentypen ist auch angegeben, welche Leitfäden für die Nutzererfahrung mit den einzelnen Datentypen verknüpft sind.
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 | |
|---|---|---|
| schedule | Datensatztyp | Gibt an, ob die Daten zu einem bestimmten Zeitpunkt oder über ein Intervall hinweg erfasst werden. Mögliche Werte sind: Interval, Instantaneous, Series. |
| straighten | Einheit | Die Maßeinheit für den Datentyp (z. B. „Kalorien“, „Meter“, „Anzahl“). |
| star | 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 Ihrem Manifest deklariert werden. Weitere Informationen finden Sie im Abschnitt Berechtigungen deklarieren der Kurzanleitung.
Die folgende Tabelle enthält die vollständige Liste der Datentypen mit Kategorie, Feature-Flags und Anleitungen sowie Berechtigungserklärungen.
Diese Tabelle gilt für Health Connect SDK-Version 1.0.0-alpha09 und niedriger. Wenn Sie eine höhere Version des SDK verwenden, sehen Sie sich die Health Connect-Datentypen für SDK 1.0.0-alpha10 und höher an.
| Datentyp Guides |
Kategorie | Datensatztyp Erklärungen zu Berechtigungen Funktions-Flag |
|---|---|---|
| Verbrannte aktive Kalorien Anleitung für Trainingseinheiten
|
Aktivität | ActiveCaloriesBurnedRecord
androidx.health.permission.ActiveCaloriesBurned.READ androidx.health.permission.ActiveCaloriesBurned.WRITE Aggregierte DatentypenACTIVE_CALORIES_TOTAL |
| Intensität der Aktivität Anleitung für Trainingseinheiten
|
Aktivität | ActivityIntensityRecord
FEATURE_ACTIVITY_INTENSITYAggregierte DatentypenDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
Basaltemperatur
|
Zyklus-Tracking | BasalBodyTemperatureRecord
androidx.health.permission.BasalBodyTemperature.READ androidx.health.permission.BasalBodyTemperature.WRITE |
Grundumsatz
|
Körperwerte | BasalMetabolicRateRecord
androidx.health.permission.BasalMetabolicRate.READ androidx.health.permission.BasalMetabolicRate.WRITE Aggregierte DatentypenBASAL_CALORIES_TOTAL |
| Blutzucker Leitfaden zu Vitalzeichen
|
Vitalparameter | BloodGlucoseRecord
androidx.health.permission.BloodGlucose.READ androidx.health.permission.BloodGlucose.WRITE |
| Blutdruck Leitfaden zu Vitalzeichen
|
Vitalparameter | BloodPressureRecord
androidx.health.permission.BloodPressure.READ androidx.health.permission.BloodPressure.WRITE Aggregierte DatentypenDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
Körperfett
|
Körperwerte | BodyFatRecord
androidx.health.permission.BodyFat.READ androidx.health.permission.BodyFat.WRITE |
| Körpertemperatur Leitfaden zu Vitalparametern
|
Vitalparameter | BodyTemperatureRecord
androidx.health.permission.BodyTemperature.READ androidx.health.permission.BodyTemperature.WRITE |
Gesamtkörperwasser
|
Körperwerte | BodyWaterMassRecord
androidx.health.permission.BodyWaterMass.READ androidx.health.permission.BodyWaterMass.WRITE |
Knochenmasse
|
Körperwerte | BoneMassRecord
androidx.health.permission.BoneMass.READ androidx.health.permission.BoneMass.WRITE |
Zervixschleim
|
Zyklus-Tracking | CervicalMucusRecord
androidx.health.permission.CervicalMucus.READ androidx.health.permission.CervicalMucus.WRITE |
| Trittfrequenz beim Radfahren Anleitung für Workouts
|
Aktivität | CyclingPedalingCadenceRecord
androidx.health.permission.Exercise.READ androidx.health.permission.Exercise.WRITE Aggregierte DatentypenRPM_AVGRPM_MAXRPM_MIN |
| Strecke Anleitung für Trainingseinheiten
|
Aktivität | DistanceRecord
androidx.health.permission.Distance.READ androidx.health.permission.Distance.WRITE Aggregierte DatentypenDISTANCE_TOTAL |
| Höhenmeter Anleitung für Trainingseinheiten
|
Aktivität | ElevationGainedRecord
androidx.health.permission.ElevationGained.READ androidx.health.permission.ElevationGained.WRITE Aggregierte DatentypenELEVATION_GAINED_TOTAL |
| Training Leitfaden zu Work-outs Leitfaden zum Hinzufügen von Trainingsrouten
|
Aktivität | ExerciseSessionRecord
androidx.health.permission.ExerciseSession.READ androidx.health.permission.ExerciseSession.WRITE 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 Anleitung für Trainingseinheiten
|
Aktivität | FloorsClimbedRecord
androidx.health.permission.FloorsClimbed.READ androidx.health.permission.FloorsClimbed.WRITE Aggregierte DatentypenFLOORS_CLIMBED_TOTAL |
| Herzfrequenz Leitfaden zu Vitalparametern
|
Vitalparameter | HeartRateRecord
androidx.health.permission.HeartRate.READ androidx.health.permission.HeartRate.WRITE Aggregierte DatentypenBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| Herzfrequenzvariabilität Leitfaden zu Vitals-Messwerten
|
Vitalparameter | HeartRateVariabilityRmssdRecord
androidx.health.permission.HeartRateVariability.READ androidx.health.permission.HeartRateVariability.WRITE |
Höhe
|
Körperwerte | HeightRecord
androidx.health.permission.Height.READ androidx.health.permission.Height.WRITE Aggregierte DatentypenHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
Hydration
|
Ernährung | HydrationRecord
androidx.health.permission.Hydration.READ androidx.health.permission.Hydration.WRITE Aggregierte DatentypenVOLUME_TOTAL |
Zwischenblutungen
|
Zyklus-Tracking | IntermenstrualBleedingRecord
androidx.health.permission.IntermenstrualBleeding.READ androidx.health.permission.IntermenstrualBleeding.WRITE |
Magere Körpermasse
|
Körperwerte | LeanBodyMassRecord
androidx.health.permission.LeanBodyMass.READ androidx.health.permission.LeanBodyMass.WRITE |
| Menstruation Für MenstruationFlowRecord:
Für MenstruationPeriodRecord:
|
Zyklus-Tracking | MenstruationFlowRecord
MenstruationPeriodRecord
androidx.health.permission.Menstruation.READ androidx.health.permission.Menstruation.WRITE |
| Achtsamkeit Anleitung zum Erfassen von Achtsamkeit
|
Wohlbefinden | MindfulnessSessionRecord
FEATURE_MINDFULNESS_SESSIONArten von AchtsamkeitsübungenAlle Arten von Achtsamkeitsübungen ansehenMINDFULNESS_SESSION_TYPE_UNKNOWNMINDFULNESS_SESSION_TYPE_MEDITATIONMINDFULNESS_SESSION_TYPE_BREATHINGMINDFULNESS_SESSION_TYPE_MUSICMINDFULNESS_SESSION_TYPE_MOVEMENTMINDFULNESS_SESSION_TYPE_UNGUIDEDAggregierte DatentypenMINDFULNESS_DURATION_TOTAL |
Ernährung
|
Ernährung | NutritionRecord
androidx.health.permission.Nutrition.READ androidx.health.permission.Nutrition.WRITE 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
androidx.health.permission.OvulationTest.READ androidx.health.permission.OvulationTest.WRITE |
| Sauerstoffsättigung Leitfaden zu Vitalparametern
|
Vitalparameter | OxygenSaturationRecord
androidx.health.permission.OxygenSaturation.READ androidx.health.permission.OxygenSaturation.WRITE |
| Geplantes Training Anleitung für Workouts Anleitung für Trainingspläne
|
Aktivität | PlannedExerciseSessionRecord
androidx.health.permission.PlannedExerciseSession.READ androidx.health.permission.PlannedExerciseSession.WRITE FEATURE_PLANNED_EXERCISE |
| Stromversorgung Anleitung für Trainingseinheiten
|
Aktivität | PowerRecord
androidx.health.permission.Power.READ androidx.health.permission.Power.WRITE Aggregierte DatentypenPOWER_AVGPOWER_MAXPOWER_MIN |
| Atemfrequenz Leitfaden zu Vitalparametern
|
Vitalparameter | RespiratoryRateRecord
androidx.health.permission.RespiratoryRate.READ androidx.health.permission.RespiratoryRate.WRITE |
| Ruheherzfrequenz Leitfaden zu Vitalparametern
|
Vitalparameter | RestingHeartRateRecord
androidx.health.permission.RestingHeartRate.READ androidx.health.permission.RestingHeartRate.WRITE Aggregierte DatentypenBPM_AVGBPM_MAXBPM_MIN |
Sexuelle Aktivität
|
Zyklus-Tracking | SexualActivityRecord
androidx.health.permission.SexualActivity.READ androidx.health.permission.SexualActivity.WRITE |
| Hauttemperatur Leitfaden zu Vitalparametern Leitfaden zum Messen der Hauttemperatur
|
Vitalparameter | SkinTemperatureRecord
FEATURE_SKIN_TEMPERATUREAggregierte DatentypenTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| Schlafeinheit Schlafanleitung Schlafeinheiten aufzeichnen
|
Schlaf | SleepSessionRecord
androidx.health.permission.SleepSession.READ androidx.health.permission.SleepSession.WRITE Aggregierte DatentypenSLEEP_DURATION_TOTAL |
| Geschwindigkeit Leitfaden für Trainingseinheiten
|
Aktivität | SpeedRecord
androidx.health.permission.Speed.READ androidx.health.permission.Speed.WRITE Aggregierte DatentypenSPEED_AVGSPEED_MAXSPEED_MIN |
| Schritte Anleitung für Training Für StepsRecord:
Für StepsCadenceRecord:
|
Aktivität | StepsRecord
StepsCadenceRecord
androidx.health.permission.Steps.READ androidx.health.permission.Steps.WRITE Aggregierte Datentypen für StepsRecordCOUNT_TOTALAggregierte Datentypen für StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
| Insgesamt verbrannte Kalorien Anleitung für Training
|
Aktivität | TotalCaloriesBurnedRecord
androidx.health.permission.TotalCaloriesBurned.READ androidx.health.permission.TotalCaloriesBurned.WRITE Aggregierte DatentypenENERGY_TOTAL |
| Maximale Sauerstoffaufnahme Anleitung für Trainingseinheiten
|
Aktivität | Vo2MaxRecord
androidx.health.permission.VO2Max.READ androidx.health.permission.VO2Max.WRITE |
Gewicht
|
Körperwerte | WeightRecord
androidx.health.permission.Weight.READ androidx.health.permission.Weight.WRITE Aggregierte DatentypenWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| Rollstuhl-Schubs Leitfaden für Training
|
Aktivität | WheelchairPushesRecord
androidx.health.permission.WheelchairPushes.READ androidx.health.permission.WheelchairPushes.WRITE Aggregierte DatentypenCOUNT_TOTAL |