Für Daten, die kontinuierlich aufgezeichnet werden können (mit mehreren Datenpunkten über einen bestimmten Zeitraum), kann die Google Fit-Plattform diese Daten aggregieren und die berechneten Ergebnisse zurückgeben. Das kann eine durchschnittliche Messung oder eine Zusammenfassung/Gesamtsumme sein. So sparen Sie Zeit bei diesen Berechnungen und können Ihren App-Nutzern mithilfe von aggregierten Daten nützliche Zusammenfassungen oder Durchschnittswerte anzeigen.
Wenn Sie aggregierte Daten lesen möchten, müssen Sie einen Datentyp, einen Zeitraum und etwas zum Auswählen der Daten auswählen. Sie können Daten auf mehrere Arten gruppieren:
Zeitraum
Aggregierte Daten pro Stunde oder Tag. Du kannst beispielsweise Schritte oder verbrannte Kalorien pro Tag anzeigen lassen.
Aktivitätstyp
Zusammengefasste Daten nach Aktivitätstyp gruppieren Für Schlafdaten über eine Woche gibt es beispielsweise einen Bucket für jeden Schlafaktivitätstyp (Leicht, Tief und REM).
Aktivitätssegment
Zusammengefasste Daten nach Aktivitätssegmenten in einem Zeitraum anzeigen Wenn ein Nutzer beispielsweise zwischen 9:00 und 10:00 Uhr gelaufen ist, dann aber die ersten 20 Minuten gelaufen ist, sich 10 Minuten lang getan, 15 Minuten zu Fuß gegangen und 15 Minuten gelaufen ist, werden dies als 4 Aktivitätssegmente betrachtet und 4 Buckets zurückgegeben.
Sitzung
Nutzen Sie die Zeitlimits von Sitzungen, um Daten zusammenzufassen. Wenn ein Nutzer beispielsweise 2 Ausführungen aufgezeichnet hat, die als 2 Sitzungen (morgens und nachmittags) aufgezeichnet wurden, können Sie nach Sitzungen gruppieren, um die durchschnittlichen Schritte oder die durchschnittliche Geschwindigkeit der einzelnen Trainings zu ermitteln.
Aktivität
Mit diesen Datentypen kannst du aggregierte Gesundheits- und Wellnessdaten lesen.
Übersicht über Aktivitäten
Gesamtzeit und Anzahl der Segmente für eine bestimmte Aktivität in einem Zeitraum.
Jeder Datenpunkt stellt eine Zusammenfassung aller Aktivitätssegmente für einen bestimmten Aktivitätstyp über ein Zeitintervall dar.
Die Gesamtzeit, die für eine Aktivität in allen Segmenten im Zeitraum aufgewendet wurde.
FIELD_NUM_SEGMENTS (int – Anzahl)
Die Anzahl der einzelnen Aktivitätssegmente über das Zeitintervall dieses Datenpunkts.
Zusammenfassung der Grundumsatzrate
Jeder Datenpunkt steht für die durchschnittliche, maximale und minimale Grundumsatzrate des Nutzers im Zeitraum in Kilocalories pro Tag. Dies ist nützlich, wenn der Nutzer zugenommen oder abgenommen hat und sich sein BMR geändert hat.
Der durchschnittliche BMR des Nutzers in einem bestimmten Zeitraum.
max (float – Kcal pro Tag)
Der maximale BMR des Nutzers über einen bestimmten Zeitraum.
min (float–kcal pro Tag)
Der minimale BMR des Nutzers über einen bestimmten Zeitraum.
Android
Name
com.google.calories.bmr.summary
Datentypobjekt
AGGREGATE_BASAL_METABOLIC_RATE_ZUSAMMENFASSUNG
Felder (Format: Einheiten)
FIELD_AVERAGE (float—kcal pro Tag)
Der durchschnittliche BMR des Nutzers in einem bestimmten Zeitraum.
FIELD_MAX (float – kcal pro Tag)
Der maximale BMR des Nutzers über einen bestimmten Zeitraum.
FIELD_MIN (float – kcal pro Tag)
Der minimale BMR des Nutzers über einen bestimmten Zeitraum.
verbrannte Kalorien
Die aggregierten oder insgesamt verbrannten Kalorien in Kilokalorien über einen bestimmten Zeitraum.
Dieser Datentyp und seine Felder sind mit denen für den aktuellen Datentyp identisch.
Kardiopunkte – Zusammenfassung
Jeder Datenpunkt steht für die Anzahl der Kardiopunkte, die du im entsprechenden Zeitraum gesammelt hast.
Die Anzahl der Kardiopunkte, die du im Laufe des Zeitraums gesammelt hast, einschließlich der Punkte, die du mit Multiplikatoren gesammelt hast (mehr Punkte für anstrengendere Aktivitäten).
Dauer (float–Minuten)
Die Zeit, in der die Kardiopunkte gesammelt wurden, gemessen in Minuten.
Android
Name
com.google.heart_minutes.summary
Datentypobjekt
AGGREGATE_HEART_POINTS
Felder (Format: Einheiten)
FIELD_INTENSITY (float: Kardiopunkte)
Die Anzahl der Kardiopunkte, die du im Laufe des Zeitraums gesammelt hast, einschließlich der Punkte, die du mit Multiplikatoren gesammelt hast (mehr Punkte für anstrengendere Aktivitäten).
FIELD_DURATION (float–Minuten)
Die Zeit, in der die Kardiopunkte gesammelt wurden, gemessen in Minuten.
Aktivitätsminuten
Die Gesamtzahl der Aktivitätsminuten im Zeitraum. Dieser Datentyp und die zugehörigen Felder sind mit denen für den aktuellen Datentyp identisch.
Leistungsübersicht
Jeder Datenpunkt steht für die durchschnittliche, maximale und minimale in Watt erzeugte Energie des Nutzers über einen bestimmten Zeitraum.
Die durchschnittliche im Monat generierte Leistung in Watt.
Max. (float–Watt)
Die maximale Leistung des Nutzers in Watt während des Zeitraums.
Min. (float–Watt)
Die minimale Leistung des Nutzers in Watt im Zeitraum.
Android
Name
com.google.power.summary
Datentypobjekt
AGGREGATE_POWER_SUMMARY
Felder (Format: Einheiten)
FIELD_AVERAGE (float—Watt)
Die durchschnittliche im Monat generierte Leistung in Watt.
FIELD_MAX (float – Watt)
Die maximale Leistung des Nutzers in Watt während des Zeitraums.
FIELD_MIN (float – Watt)
Die minimale Leistung des Nutzers in Watt im Zeitraum.
Deltazusammenfassung der Schrittzahl
Jeder Datenpunkt steht für die Gesamtzahl der Schritte im ausgewählten Zeitraum.
Dieser Datentyp und seine Felder sind mit denen für den aktuellen Datentyp identisch.
Körper
Mit diesen Datentypen können Sie zusammengefasste Daten zur Körpermessung lesen.
Körperfettanteil – Zusammenfassung
Jeder Datenpunkt steht für den durchschnittlichen, maximalen und minimalen Körperfettanteil des Nutzers über einen bestimmten Zeitraum.
REST
Name
com.google.body.fat.percentage.summary
OAuth-Berechtigungsbereiche
https://www.googleapis.com/auth/fitness.body.read
Felder (Format: Einheiten)
average (float—percent)
Der durchschnittliche Prozentsatz des Gesamtkörpers, den das Körperfett zunimmt, über einen bestimmten Zeitraum.
max (float–%)
Der maximale Prozentsatz des Körperfettanteils, den der Nutzer insgesamt über einen bestimmten Zeitraum hat.
min (float–%)
Der minimale Prozentsatz der gesamten Körpermasse, der dem Körperfett entspricht, über einen bestimmten Zeitraum.
Android
Name
com.google.body.fat.percentage.summary
Datentypobjekt
AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
Felder (Format: Einheiten)
FIELD_AVERAGE (float–%)
Der durchschnittliche Prozentsatz des Gesamtkörpers, den das Körperfett zunimmt, über einen bestimmten Zeitraum.
FIELD_MAX (float–%)
Der maximale Prozentsatz des Körperfettanteils, den der Nutzer insgesamt über einen bestimmten Zeitraum hat.
FIELD_MIN (float–%)
Der minimale Prozentsatz der gesamten Körpermasse, der dem Körperfett entspricht, über einen bestimmten Zeitraum.
Zusammenfassung der Herzfrequenz
Jeder Datenpunkt steht für die durchschnittliche, maximale und minimale Herzfrequenz des Nutzers im Zeitraum in Schlägen pro Minute.
REST
Name
com.google.heart_rate.summary
OAuth-Berechtigungsbereiche
https://www.googleapis.com/auth/fitness.body.read
Felder (Format: Einheiten)
Durchschnitt (float–bpm)
Die durchschnittliche Herzfrequenz des Nutzers in Schlägen pro Minute über einen bestimmten Zeitraum.
max. (float–bpm)
Die maximale Herzfrequenz des Nutzers in Schlägen pro Minute über einen bestimmten Zeitraum.
min (float–bpm)
Die Mindestherzfrequenz des Nutzers in Schlägen pro Minute über einen bestimmten Zeitraum.
Android
Name
com.google.heart_rate.summary
Datentypobjekt
AGGREGATE_HEART_RATE_SUMMARY
Felder (Format: Einheiten)
FIELD_AVERAGE (float–bpm)
Die durchschnittliche Herzfrequenz des Nutzers in Schlägen pro Minute über einen bestimmten Zeitraum.
FIELD_MAX (float–bpm)
Die maximale Herzfrequenz des Nutzers in Schlägen pro Minute über einen bestimmten Zeitraum.
FIELD_MIN (float–bpm)
Die Mindestherzfrequenz des Nutzers in Schlägen pro Minute über einen bestimmten Zeitraum.
Höhenübersicht
Jeder Datenpunkt steht für die durchschnittliche, maximale und minimale Höhe des Nutzers über einen bestimmten Zeitraum in Metern.
REST
Name
com.google.height.summary
OAuth-Berechtigungsbereiche
https://www.googleapis.com/auth/fitness.body.read
Felder (Format: Einheiten)
average (float—meters)
Die durchschnittliche Höhe des Nutzers in Metern.
max (float–Meter)
Maximale Höhe des Nutzers in Metern.
min (float–Meter)
Die Mindesthöhe des Nutzers für einen Zeitraum in Metern.
Android
Name
com.google.height.summary
Datentypobjekt
AGGREGATE_HEIGHT_SUMMARY
Felder (Format: Einheiten)
FIELD_AVERAGE (float–Meter)
Die durchschnittliche Höhe des Nutzers in Metern.
FIELD_MAX (float–Meter)
Maximale Höhe des Nutzers in Metern.
FIELD_MIN (float–Meter)
Die Mindesthöhe des Nutzers für einen Zeitraum in Metern.
Gewichtsübersicht
Jeder Datenpunkt stellt die durchschnittliche, maximale und minimale Gewichtung des Nutzers über einen bestimmten Zeitraum in Kilogramm dar.
REST
Name
com.google.weight.summary
OAuth-Berechtigungsbereiche
https://www.googleapis.com/auth/fitness.body.read
Felder (Format: Einheiten)
average (float–kg)
Das durchschnittliche Körpergewicht des Nutzers über einen Zeitraum in Kilogramm.
max (float–kg)
Das maximale Körpergewicht des Nutzers über einen bestimmten Zeitraum in Kilogramm.
min (float–kg)
Das minimale Körpergewicht des Nutzers in einem bestimmten Zeitraum in Kilogramm.
Android
Name
com.google.weight.summary
Datentypobjekt
AGGREGATE_WEIGHT_SUMMARY
Felder (Format: Einheiten)
FIELD_AVERAGE (float–kg)
Das durchschnittliche Körpergewicht des Nutzers über einen Zeitraum in Kilogramm.
FIELD_MAX (float–kg)
Das maximale Körpergewicht des Nutzers über einen bestimmten Zeitraum in Kilogramm.
FIELD_MIN (float–kg)
Das minimale Körpergewicht des Nutzers in einem bestimmten Zeitraum in Kilogramm.
Standort
Mit diesen Datentypen können Sie zusammengefasste Standortdaten lesen.
Abstandsdelta
Jeder Datenpunkt stellt die Gesamtstrecke des Nutzers in einem bestimmten Zeitraum in Metern dar. Dieser Datentyp und die zugehörigen Felder sind mit denen für den aktuellen Datentyp identisch.
Standort-Begrenzungsrahmen
Jeder Datenpunkt steht für den Begrenzungsrahmen, der über die Standortpunkte des Nutzers über einen bestimmten Zeitraum berechnet wird. Jeder Begrenzungsrahmen hat vier Felder, die die vier Ecken des Begrenzungsrahmens darstellen.
Minimaler Breitengrad des Begrenzungsrahmens, in Form einer Gleitkommazahl, in Grad
Niedriger Längengrad (float—Grad)
Minimaler Längengrad des Begrenzungsrahmens, in Form einer Gleitkommazahl, in Grad
Hoher Breitengrad (float—Grad)
Maximaler Breitengrad des Begrenzungsrahmens, angegeben als Gleitkommazahl in Grad.
Hoher Längengrad (float—Grad)
Längengrad des Begrenzungsrahmens, angegeben als Gleitkommazahl in Grad.
Android
Name
com.google.location.bounding_box
Datentypobjekt
AGGREGATE_LOCATION_BOUNDING_BOX
Felder (Format: Einheiten)
FIELD_LOW_LATITUDE (float bis Grad)
Breitengrad der unteren linken Ecke des Begrenzungsrahmens, in Form einer Gleitkommazahl, in Grad.
FIELD_LOW_LONGITUDE (float bis Grad)
Längengrad der linken unteren Ecke des Begrenzungsrahmens, dargestellt als Gleitkommazahl in Grad.
FIELD_HIGH_LATITUDE (float bis Grad)
Breitengrad der oberen rechten Ecke des Begrenzungsrahmens, in Form einer Gleitkommazahl, in Grad.
FIELD_HIGH_LONGITUDE (float bis Grad)
Längengrad der oberen rechten Ecke des Begrenzungsrahmens, dargestellt als Gleitkommazahl in Grad.
Geschwindigkeitsübersicht
Jeder Datenpunkt steht für die durchschnittliche, maximale und minimale Geschwindigkeit, die der Nutzer über einen bestimmten Zeitraum in Metern pro Sekunde zurückgelegt hat.
Die durchschnittliche Geschwindigkeit des Nutzers über einen bestimmten Zeitraum in Metern pro Sekunde.
max (float–Meter pro Sekunde)
Die maximale Geschwindigkeit des Nutzers über einen bestimmten Zeitraum, in Metern pro Sekunde.
min (float–Meter pro Sekunde)
Die minimale Geschwindigkeit des Nutzers über einen bestimmten Zeitraum in Metern pro Sekunde.
Android
Name
com.google.speed.summary
Datentypobjekt
AGGREGATE_SPEED_SUMMARY
Felder (Format: Einheiten)
Durchschnittlich (float–Meter pro Sekunde)
Die durchschnittliche Geschwindigkeit des Nutzers über einen bestimmten Zeitraum in Metern pro Sekunde.
max (float–Meter pro Sekunde)
Die maximale Geschwindigkeit des Nutzers über einen bestimmten Zeitraum, in Metern pro Sekunde.
min (float–Meter pro Sekunde)
Die minimale Geschwindigkeit des Nutzers über einen bestimmten Zeitraum in Metern pro Sekunde.
Ernährung
Mit diesen Datentypen kannst du zusammengefasste Ernährungsdaten lesen.
Hydrationsübersicht
Jeder Datenpunkt stellt die Gesamtmenge an Wasser dar, die ein Nutzer über einen bestimmten Zeitraum in Litern verbraucht hat. Dieser Datentyp und die zugehörigen Felder sind mit denen für den aktuellen Datentyp identisch.
Ernährungsübersicht
Jeder Datenpunkt steht für die Summe aller Ernährungseinträge über einen bestimmten Zeitraum.
Im Feld „Nährstoffe“ steht jeder Wert für die Summe des Nährstoffs über alle Einträge im Zeitraum.
Wenn der Nährstoff nicht in den Einträgen enthalten war, ist er auch nicht in der aggregierten Karte enthalten. Wenn alle Einträge im Zeitraum für dieselbe Mahlzeit gelten, wird auch der Mahlzeitentyp festgelegt.
Die Nährstoffe insgesamt, die im Essen über einen bestimmten Zeitraum aufgenommen wurden.
Gültige Werte
"key": "calories" // Calories in kcal
"key": "fat.total" // Total fat in grams
"key": "fat.saturated" // Saturated fat in grams
"key": "fat.unsaturated" // Unsaturated fat in grams
"key": "fat.polyunsaturated" // Polyunsaturated fat in grams
"key": "fat.monounsaturated" // Monounsaturated fat in grams
"key": "fat.trans" // Trans fat in grams
"key": "cholesterol" // Cholesterol in milligrams
"key": "sodium" // Sodium in milligrams
"key": "potassium" // Potassium in milligrams
"key": "carbs.total" // Total carbohydrates in grams
"key": "dietary_fiber" // Dietary fiber in grams
"key": "sugar" // Amount of sugar in grams
"key": "protein" // Protein amount in grams
Android
Name
com.google.nutrition.summary
Datentypobjekt
AGGREGATE_NUTRITION_SUMMARY
Felder (Format: Einheiten)
FIELD_MEAL_TYPE (int – Aufzählung)
Welche Art von Mahlzeit, die der Nutzer gegessen hat (vorhanden, wenn alle Einträge im Zeitraum für dieselbe Mahlzeit gelten)
Die Nährstoffe insgesamt, die im Essen über einen bestimmten Zeitraum aufgenommen wurden.
Gültige Werte
NUTRIENT_CALORIES // Calories in kcal
NUTRIENT_TOTAL_FAT // Total fat in grams
NUTRIENT_SATURATED_FAT // Saturated fat in grams
NUTRIENT_UNSATURATED_FAT // Unsaturated fat in grams
NUTRIENT_POLYUNSATURATED_FAT // Polyunsaturated fat in grams
NUTRIENT_MONOUNSATURATED_FAT // Monounsaturated fat in grams
NUTRIENT_TRANS_FAT // Trans fat in grams
NUTRIENT_CHOLESTEROL // Cholesterol in milligrams
NUTRIENT_SODIUM // Sodium in milligrams
NUTRIENT_POTASSIUM // Potassium in milligrams
NUTRIENT_TOTAL_CARBS // Total carbohydrates in grams
NUTRIENT_DIETARY_FIBER // Dietary fiber in grams
NUTRIENT_SUGAR // Amount of sugar in grams
NUTRIENT_PROTEIN // Protein amount in grams
Gesundheit
Mit diesen Datentypen können Sie aggregierte medizinische und Gesundheitsdaten lesen.
Blutzucker-Übersicht
Jeder Datenpunkt steht für die durchschnittliche, minimale und maximale Blutzuckerkonzentration oder -konzentration im Zeitraum, gemessen in mmol/l, wobei 1 mmol/l 18 mg/dl beträgt.
Wenn die Werte für jedes dieser Felder für alle Messungen während des Zeitraums identisch sind, sehen Sie den Feldwert in den zurückgegebenen Daten:
zeitlicher Bezug zu einer Mahlzeit
zeitlicher Bezug zum Schlaf
Probenquelle
Wenn sich die Werte in den Messwerten unterscheiden, wird das Feld ausgeschlossen.
Der durchschnittliche Blutzuckerspiegel oder die Konzentration eines Nutzers über einen Zeitraum.
max (float–mmol/l)
Die maximale Blutzuckerkonzentration oder -konzentration des Nutzers über einen bestimmten Zeitraum.
min (float–mmol/l)
Der Blutzuckerspiegel oder die Mindestkonzentration des Nutzers über einen bestimmten Zeitraum.
temporale Beziehung zu Mahlzeiten (int—Aufzählung) (optionales Feld)
Zeitpunkt der Messung im Vergleich zum Zeitpunkt des Nutzers.
Gültige Werte
"intVal": 1 // Reading wasn't taken before or after a meal
"intVal": 2 // Reading was taken during a fasting period
"intVal": 3 // Reading was taken before a meal
"intVal": 4 // Reading was taken after a meal
Mahlzeittyp (int – Aufzählung) (optionales Feld)
Welche Art von Mahlzeit, die der Nutzer gegessen hat, als die Messung vorgenommen wurde
temporäre Beziehung zum Schlaf (int—Aufzählung) (optionales Feld)
Wann die Messung durchgeführt wurde und wann der Nutzer geschlafen hat.
Gültige Werte
"intVal": 1 // User was fully awake
"intVal": 2 // Before the user fell asleep
"intVal": 3 // After the user woke up
"intVal": 4 // While the user was still sleeping
Probenquelle (int – Aufzählung) (optionales Feld)
Art der Körperflüssigkeit, die zur Messung des Blutzuckerspiegels verwendet wird.
Zeitpunkt der Messung im Vergleich zum Zeitpunkt des Nutzers.
Gültige Werte
FIELD_TEMPORAL_RELATION_TO_MEAL_GENERAL // Reading wasn't taken before or after a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_FASTING // Reading was taken during a fasting period
FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL // Reading was taken before a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_AFTER_MEAL // Reading was taken after a meal
Wann die Messung durchgeführt wurde und wann der Nutzer geschlafen hat.
Gültige Werte
TEMPORAL_RELATION_TO_SLEEP_FULLY_AWAKE // User was fully awake.
TEMPORAL_RELATION_TO_SLEEP_BEFORE_SLEEP // Before the user fell asleep.
TEMPORAL_RELATION_TO_SLEEP_ON_WAKING // After the user woke up.
TEMPORAL_RELATION_TO_SLEEP_DURING_SLEEP // While the user was still sleeping.
Die Körperposition des Nutzers zum Zeitpunkt der Messung.
Gültige Werte
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
Welcher Arm und welcher Teil der Messung wurde gemessen.
Gültige Werte
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_WRIST // Left wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_WRIST // Right wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_UPPER_ARM // Left upper arm
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_UPPER_ARM // Right upper arm
Körpertemperaturübersicht
Jeder Datenpunkt steht für die durchschnittliche, minimale und maximale Körpertemperatur des Nutzers über einen bestimmten Zeitraum.
Außerdem wird der Standort angegeben, an dem die Messung am Körper erfolgt ist, sofern er für alle Datenpunkte im Zeitintervall gleich ist.
Jeder Datenpunkt steht für die durchschnittliche, minimale und maximale Sauerstoffsättigung des Blutes und die Sauerstoffsättigung des Nutzers in einem Zeitintervall.
Wenn die Werte für jedes dieser Felder für alle Messungen während des Zeitraums identisch sind, sehen Sie den Feldwert in den zurückgegebenen Daten:
Verabreichungsmodus mit Sauerstofftherapie
Sauerstoffsättigungssystem
Methode zur Messung der Sauerstoffsättigung
Wenn sich die Werte in den Messwerten unterscheiden, wird das Feld ausgeschlossen.
