Die Google Fit APIs, einschließlich der Google Fit REST API, sind nach dem 30. Juni 2025 nicht mehr verfügbar. Seit dem 1. Mai 2024 können sich Entwickler nicht mehr für die Nutzung dieser APIs registrieren.
Für Daten, die kontinuierlich aufgezeichnet werden können (mit mehreren Datenpunkten über einen Zeitraum hinweg)
kann die Google Fit-Plattform diese Daten zusammenfassen und
berechnete Ergebnisse. Dabei kann es sich um eine durchschnittliche Messung oder eine Zusammenfassung/Summe handeln. Ich
können Sie bei diesen Berechnungen Zeit sparen und Ihren App-Nutzern nützliche Zusammenfassungen oder
mithilfe aggregierter Daten
einfacher Durchschnitt ermitteln.
Um aggregierte Daten zu lesen, müssen Sie einen Datentyp, einen Zeitraum usw. auswählen
zu „Bucket“ die Daten gruppieren (oder gruppieren). Sie können Daten auf verschiedene Arten gruppieren:
Zeitraum
Sammeln Sie aggregierte Daten pro Stunde oder Tag. Du kannst dir zum Beispiel die Anzahl der pro Tag verbrannten Schritte oder verbrannten Kalorien ansehen.
Aktivitätstyp
Sammeln Sie aggregierte Daten nach Aktivitätstyp. Für Schlafdaten über eine Woche gibt es beispielsweise einen Bucket für jeden Schlafaktivitätstyp (Leicht-, Tief- und REM-Schlaf).
Aktivitätssegment
Sammeln Sie aggregierte Daten nach Aktivitätssegmenten über einen bestimmten Zeitraum. Wenn ein Nutzer beispielsweise zwischen 9:00 Uhr und 10:00 Uhr gelaufen ist, aber die ersten 20 Minuten, 10 Minuten gesessen, 15 Minuten zu Fuß und 15 Minuten gelaufen ist, werden diese als 4 Aktivitätssegmente betrachtet und es werden 4 Buckets zurückgegeben.
Sitzung
Verwenden Sie die Zeitgrenzen von Sitzungen, um Daten zu aggregieren. Wenn ein Nutzer beispielsweise zwei Durchläufe gemacht hat, die als zwei Sitzungen protokolliert wurden (ein Lauf am Morgen und ein Lauf am Nachmittag), können Sie nach Sitzung gruppieren, um die durchschnittliche Schrittzahl oder die durchschnittliche Geschwindigkeit jedes Laufs zu ermitteln.
Aktivität
Verwende diese Datentypen, um aggregierte Gesundheits- und Fitnessdaten zu lesen.
Aktivitätenübersicht
Gesamtdauer und Anzahl der Segmente für eine bestimmte Aktivität innerhalb eines Zeitraums.
Jeder Datenpunkt stellt eine Zusammenfassung aller Aktivitätssegmente für eine bestimmte
Aktivitätstyp in einem Zeitintervall.
Die Art der Aktivität, die der Nutzer ausgeführt hat. Eine Liste der Aktivitätstypen finden Sie hier.
duration (int–Millisekunden)
Die Gesamtzeit, die in allen Segmenten für eine Aktivität in einem Zeitraum aufgewendet wurde.
Anzahl der Segmente (int – Anzahl)
Die Anzahl der unterschiedlichen Aktivitätssegmente im Zeitintervall dieses Datenpunkts.
Android
Name
com.google.activity.summary
Datentypobjekt
AGGREGATE_ACTIVITY_SUMMARY
Felder (Format – Einheiten)
FIELD_ACTIVITY (int – Aufzählung)
Die Art der Aktivität, die der Nutzer ausgeführt hat. Eine Liste der Aktivitätstypen finden Sie hier.
FIELD_DURATION (int–Millisekunden)
Die Gesamtzeit, die in allen Segmenten für eine Aktivität in einem Zeitraum aufgewendet wurde.
FIELD_NUM_SEGMENTS (int – Anzahl)
Die Anzahl der unterschiedlichen Aktivitätssegmente im Zeitintervall dieses Datenpunkts.
Zusammenfassung des Grundumsatzes
Jeder Datenpunkt steht für den durchschnittlichen, maximalen und minimalen Grundumsatz des Nutzers
im Zeitraum in Kilokalorien pro Tag. Dies ist nützlich, wenn Nutzende
Gewichtszunahme oder -verlust und der Grundumsatz hat sich daher verändert.
Der durchschnittliche BMR des Nutzers über einen bestimmten Zeitraum.
max (float – kcal pro Tag)
Der maximale BMR-Wert des Nutzers in einem bestimmten Zeitraum.
Min. (float–kcal pro Tag)
Mindest-GUT des Nutzers über einen bestimmten Zeitraum
Android
Name
com.google.calories.bmr.summary
Datentypobjekt
AGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
Felder (Format – Einheiten)
FIELD_AVERAGE (float–kcal pro Tag)
Der durchschnittliche BMR des Nutzers über einen bestimmten Zeitraum.
FIELD_MAX (float–kcal pro Tag)
Der maximale Bruttoumsatz des Nutzers in einem bestimmten Zeitraum.
FIELD_MIN (float–kcal pro Tag)
Mindest-GUT des Nutzers über einen bestimmten Zeitraum
Übersicht über verbrannte Kalorien
Die zusammengefassten oder insgesamt verbrannten Kalorien in Kilokalorien über einen Zeitraum.
Dieser Datentyp und seine Felder sind mit den Instant-Daten identisch.
Typ aus.
Kardiopunkte – Übersicht
Jeder Datenpunkt steht für die Anzahl der im ausgewählten Zeitraum gesammelten Kardiopunkte.
Die Anzahl der Kardiopunkte, die du im ausgewählten Zeitraum gesammelt hast,
einschließlich der durch Multiplikatoren gesammelten Punkte (mehr Punkte für
anstrengendere Aktivitäten).
duration (float–Minuten)
Die Zeit in Minuten, in der die Kardiopunkte gesammelt wurden.
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 ausgewählten Zeitraum gesammelt hast,
einschließlich der durch Multiplikatoren gesammelten Punkte (mehr Punkte für
anstrengendere Aktivitäten).
FIELD_DURATION (float Minuten)
Die Zeit in Minuten, in der die Kardiopunkte gesammelt wurden.
Aktivitätsminuten-Zusammenfassung
Die Gesamtzahl der Bewegungsminuten im Zeitraum. Dieser Datentyp und diese Felder
sind dieselben wie für den Datentyp „Instant“.
Energieübersicht
Jeder Datenpunkt steht für die durchschnittliche, maximale und minimale Leistung des Nutzers in Watt über einen bestimmten Zeitraum.
Die durchschnittlich erzeugte Leistung des Nutzers in Watt im ausgewählten Zeitraum.
Max (float–Watt)
Die maximale Leistung des Nutzers in Watt im ausgewählten Zeitraum.
Min. (float–Watt)
Die minimale Energie, die der Nutzer im ausgewählten Zeitraum erzeugt hat, in Watt.
Android
Name
com.google.power.summary
Datentypobjekt
AGGREGATE_POWER_SUMMARY
Felder (Format – Einheiten)
FIELD_AVERAGE (float – Watt)
Die durchschnittlich erzeugte Leistung des Nutzers in Watt im ausgewählten Zeitraum.
FIELD_MAX (float–Watt)
Die maximale Leistung des Nutzers in Watt im ausgewählten Zeitraum.
FIELD_MIN (float–Watt)
Die minimale Energie, die der Nutzer im ausgewählten Zeitraum erzeugt hat, in Watt.
Delta für Schrittanzahl – Zusammenfassung
Jeder Datenpunkt steht für die Gesamtzahl der Schritte im ausgewählten Zeitraum.
Dieser Datentyp und seine Felder sind mit den Instant-Daten identisch.
Typ aus.
Text
Verwenden Sie diese Datentypen, um aggregierte Körper-Messdaten zu lesen.
Zusammenfassung Körperfettanteil
Jeder Datenpunkt steht für den durchschnittlichen, maximalen und minimalen Körperfettanteil des Nutzers
für 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 – Prozent)
Der durchschnittliche Prozentsatz der gesamten Körpermasse, die das Körperfett darstellt, über einen bestimmten Zeitraum.
max (float – Prozent)
Der maximale Prozentsatz an der gesamten Körpermasse des Nutzers, d. h. Körperfett, über einen bestimmten Zeitraum.
Min. (float – Prozent)
Der Mindestanteil des Benutzers an der gesamten Körpermasse, d. h. Körperfett, über einen bestimmten Zeitraum.
Android
Name
com.google.body.fat.percentage.summary
Datentypobjekt
AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
Felder (Format – Einheiten)
FIELD_AVERAGE (float – Prozentsatz)
Der durchschnittliche Prozentsatz der gesamten Körpermasse, die das Körperfett darstellt, über einen bestimmten Zeitraum.
FIELD_MAX (float – Prozent)
Der maximale Prozentsatz an der gesamten Körpermasse des Nutzers, d. h. Körperfett, über einen bestimmten Zeitraum.
FIELD_MIN (float – Prozent)
Der Mindestanteil des Benutzers an der gesamten Körpermasse, d. h. Körperfett, über einen bestimmten Zeitraum.
Herzfrequenz-Übersicht
Jeder Datenpunkt steht für die durchschnittliche, maximale und minimale Herzfrequenz des Nutzers
Schlägen pro Minute angegeben werden.
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 Benutzers in Schlägen pro Minute über einen bestimmten Zeitraum.
max. (float–bpm)
Die maximale Herzfrequenz des Benutzers in Schlägen pro Minute über einen bestimmten Zeitraum.
Min. (float–bpm)
Die minimale Herzfrequenz des Benutzers 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 Benutzers in Schlägen pro Minute über einen bestimmten Zeitraum.
FIELD_MAX (float–bpm)
Die maximale Herzfrequenz des Benutzers in Schlägen pro Minute über einen bestimmten Zeitraum.
FIELD_MIN (float–bpm)
Die minimale Herzfrequenz des Benutzers in Schlägen pro Minute über einen bestimmten Zeitraum.
Größenübersicht
Jeder Datenpunkt stellt die durchschnittliche, maximale und minimale Größe des Nutzers in einem bestimmten Zeitraum dar.
in Metern.
REST
Name
com.google.height.summary
OAuth-Berechtigungsbereiche
https://www.googleapis.com/auth/fitness.body.read
Felder (Format – Einheiten)
Durchschnitt (float–Meter)
Die durchschnittliche Größe des Nutzers über einen bestimmten Zeitraum in Metern.
max (float Meter)
Die maximale Größe des Nutzers in Metern über einen bestimmten Zeitraum.
Min. (float Meter)
Die Mindestgröße des Nutzers in Metern über einen bestimmten Zeitraum.
Android
Name
com.google.height.summary
Datentypobjekt
AGGREGATE_HEIGHT_SUMMARY
Felder (Format – Einheiten)
FIELD_AVERAGE (float – Meter)
Die durchschnittliche Größe des Nutzers über einen bestimmten Zeitraum in Metern.
FIELD_MAX (float Meter)
Die maximale Größe des Nutzers in Metern über einen bestimmten Zeitraum.
FIELD_MIN (float – Meter)
Die Mindestgröße des Nutzers in Metern über einen bestimmten Zeitraum.
Gewichtsübersicht
Jeder Datenpunkt steht für das Durchschnitts-, Höchst- und Mindestgewicht der Nutzenden
Zeitraum in Kilogramm.
REST
Name
com.google.weight.summary
OAuth-Berechtigungsbereiche
https://www.googleapis.com/auth/fitness.body.read
Felder (Format – Einheiten)
Durchschnitt (float bis kg)
Das durchschnittliche Körpergewicht des Benutzers über einen bestimmten Zeitraum in Kilogramm.
max. (float–kg)
Das maximale Körpergewicht des Benutzers in einem Zeitraum in Kilogramm.
Min. (float–kg)
Das minimale Körpergewicht des Benutzers über einen 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 Benutzers über einen bestimmten Zeitraum in Kilogramm.
FIELD_MAX (float–kg)
Das maximale Körpergewicht des Benutzers in einem Zeitraum in Kilogramm.
FIELD_MIN (float–kg)
Das minimale Körpergewicht des Benutzers über einen bestimmten Zeitraum in Kilogramm.
Standort
Verwenden Sie diese Datentypen, um aggregierte Standortdaten zu lesen.
Streckendelta
Jeder Datenpunkt stellt die Gesamtstrecke dar, die der Nutzer in einem Zeitraum zurückgelegt hat.
in Metern. Dieser Datentyp und seine Felder sind die gleichen wie für die
Datentyp sofort.
Standortbegrenzungsrahmen
Jeder Datenpunkt stellt die Begrenzung
Feld berechnet, das über die
Standortpunkte in einem bestimmten Zeitraum. Jeder Begrenzungsrahmen hat vier Felder
die die vier Ecken des Begrenzungsrahmens darstellen.
Die durchschnittliche Geschwindigkeit des Nutzers in Metern pro Sekunde über einen bestimmten Zeitraum.
max (float Meter pro Sekunde)
Die Höchstgeschwindigkeit des Nutzers in Metern pro Sekunde über einen bestimmten Zeitraum.
min (float Meter pro Sekunde)
Die Mindestgeschwindigkeit des Nutzers in Metern pro Sekunde über einen bestimmten Zeitraum.
Android
Name
com.google.speed.summary
Datentypobjekt
AGGREGATE_SPEED_SUMMARY
Felder (Format – Einheiten)
Durchschnitt (float Meter pro Sekunde)
Die durchschnittliche Geschwindigkeit des Nutzers in Metern pro Sekunde über einen bestimmten Zeitraum.
max (float Meter pro Sekunde)
Die Höchstgeschwindigkeit des Nutzers in Metern pro Sekunde über einen bestimmten Zeitraum.
min (float Meter pro Sekunde)
Die Mindestgeschwindigkeit des Nutzers in Metern pro Sekunde über einen bestimmten Zeitraum.
Ernährung
Verwende diese Datentypen, um aggregierte Ernährungsdaten zu lesen.
Flüssigkeitszufuhr – Übersicht
Jeder Datenpunkt steht für die Gesamtmenge an Wasser, die eine nutzende Person über einen
Zeitraum in Litern. Dieser Datentyp und seine Felder sind die gleichen wie für die
Datentyp sofort.
Nährwertübersicht
Jeder Datenpunkt steht für die Summe aller Ernährungseinträge für einen bestimmten Zeitraum.
Im Feld Nährstoffe steht jeder Wert für die Summe der Nährstoffe
der Einträge im jeweiligen Zeitraum.
Wenn der Nährstoff in keinem der Einträge enthalten war, ist er auch nicht in der aggregierten Karte enthalten.
auch. Wenn alle Einträge im Zeitraum sich auf dieselbe Mahlzeit beziehen, wird die Art der Mahlzeit
festgelegt.
Die gesamten Nährstoffe, die in den Nahrungsmitteln ü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 hat der Nutzer gegessen (vorhanden, wenn alle Einträge im Zeitraum sich auf dieselbe Mahlzeit beziehen).
Die gesamten Nährstoffe, die in den Nahrungsmitteln ü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
Verwenden Sie diese Datentypen, um aggregierte medizinische Daten zu lesen.
Blutzucker-Übersicht
Jeder Datenpunkt steht für den durchschnittlichen, minimalen und maximalen Blutzuckerspiegel
oder Konzentration über den Zeitraum, gemessen in mmol/l, wobei 1 mmol/l 18 entspricht
mg/dl.
Wenn die Werte in jedem dieser Felder für alle Messungen gleich sind
sehen Sie den Feldwert in den zurückgegebenen Daten:
Zeitliche Beziehung zu einer Mahlzeit
zeitlicher Bezug zum Schlaf
Probenquelle
Wenn die Werte unterschiedlich sind, wird das Feld ausgeschlossen.
Der durchschnittliche Blutzuckerspiegel oder die durchschnittliche Blutzuckerkonzentration des Benutzers über einen bestimmten Zeitraum.
Max. (float–mmol/l)
Der maximale Blutzuckerspiegel oder die maximale Blutzuckerkonzentration des Benutzers über einen bestimmten Zeitraum.
Min. (float–mmol/l)
Der minimale Blutzuckerspiegel oder die niedrigste Blutzuckerkonzentration des Nutzers über einen bestimmten Zeitraum.
Zeitliche Beziehung zur Mahlzeit (int–enum) (optionales Feld)
Zeitpunkt der Messung im Vergleich zu dem Zeitpunkt, zu dem der Nutzer gegessen hat.
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 hat der Nutzer während der Messung gegessen?
Zeitpunkt der Messung im Vergleich zu dem Zeitpunkt, zu dem der Nutzer gegessen hat.
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
Zeitpunkt, zu dem die Messung durchgeführt wurde, verglichen mit dem Zeitpunkt, zu dem 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
Für welche Verzweigung und welcher Teil der Verzweigung die Messung durchgeführt wurde.
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 von
innerhalb eines bestimmten
Zeitraums angezeigt.
Hier wird auch die Stelle am Körper angezeigt, an der die Messung durchgeführt wurde.
Messort war für alle Datenpunkte im Zeitintervall derselbe.
Jeder Datenpunkt steht für die durchschnittliche, minimale und maximale Sauerstoffsättigung
Durchflussmenge der Sättigung und Zusatzsauerstoffsättigung des Nutzers eines Zeitintervalls.
Wenn die Werte in jedem dieser Felder für alle Messungen gleich sind
sehen Sie den Feldwert in den zurückgegebenen Daten:
Verabreichungsmodus für Sauerstofftherapie
Sauerstoffsättigungssystem
Methode zur Messung der Sauerstoffsättigung
Wenn die Werte unterschiedlich sind, wird das Feld ausgeschlossen.
[null,null,["Zuletzt aktualisiert: 2024-08-22 (UTC)."],[[["Google Fit uses aggregate data types to provide summaries of health and wellness metrics, like steps, calories, and heart rate, over specific time periods."],["Developers can retrieve aggregated data by specifying the data type, time range, and how the data should be grouped (e.g., by time period, activity type, or session)."],["Data is categorized into activity, body, and location, each with specific data types and fields providing aggregated values like totals, averages, minimums, and maximums."],["Aggregate data types are read-only, meaning you can only retrieve data, not write or modify it."],["Accessing aggregate data types requires appropriate OAuth permissions, and Google Fit offers both REST and Android APIs for retrieval."]]],[]]
