Interfejsy Google Fit API, w tym interfejs Google Fit REST API, po 30 czerwca 2025 r. nie będą już dostępne. Od 1 maja 2024 roku deweloperzy nie mogą rejestrować się w celu korzystania z tych interfejsów API.
Instrukcje dotyczące interfejsu API lub platformy, na które należy przejść, znajdziesz w przewodniku po migracji do Health Connect. Porównanie Health Connect z interfejsami API Google Fit i internetowymi interfejsami API Fitbita znajdziesz w porównaniu Health Connect.
Do danych, które mogą być rejestrowane w sposób ciągły (z wieloma punktami danych w czasie)
okres), platforma Google Fit może agregować te dane i wyświetlać
obliczone wyniki. Może to być pomiar uśredniony lub podsumowanie/suma. Ty
pozwala zaoszczędzić czas potrzebny na wykonanie tych obliczeń i wyświetlić użytkownikom przydatne podsumowania lub
możesz łatwo obliczyć średnie wartości, odczytując dane zbiorcze.
Aby odczytać dane zbiorcze, musisz wybrać typ danych, zakres czasu i inne właściwości
do „zasobnika” (lub pogrupuj) dane. Dane możesz grupować na kilka różnych sposobów:
Przedział czasu
Grupowanie danych zbiorczych według godziny lub dnia. Możesz na przykład sprawdzać liczbę kroków lub spalonych kalorii dziennie.
Typ aktywności
Zbiorcze dane o grupie według typu aktywności. Na przykład dla danych dotyczących snu z całego tygodnia będzie osobny segment dla każdego rodzaju aktywności (płytkiej, głębokiej i REM).
Segment aktywności
Pogrupować zagregowane dane według segmentów aktywności w danym okresie. Jeśli na przykład użytkownik biegał od 9:00 do 10:00, ale biegał przez pierwsze 20 minut, siedział przez 10 minut, chodził przez 15 minut i biegał przez 15 minut, uznajemy to za 4 segmenty aktywności i zwróciłyby 4 zasobniki.
Sesja
Wykorzystaj limity czasowe sesji, aby agregować dane. Jeśli np. użytkownik wykonał 2 biegi rejestrowane jako 2 sesje (poranny i popołudniowy), możesz grupować według sesji, aby poznać średnie kroki lub średnią prędkość każdego z nich.
Aktywność
Używaj tych typów danych do odczytywania zbiorczych danych o zdrowiu i samopoczuciu.
Podsumowanie aktywności
Łączny czas i liczba segmentów dla danej aktywności w wybranym okresie.
Każdy punkt danych reprezentuje podsumowanie wszystkich segmentów aktywności w konkretnym
typu aktywności w danym przedziale czasu.
Łączny czas spędzony na aktywności we wszystkich segmentach w wybranym okresie.
FIELD_NUM_SEGMENTS (int – liczba)
Liczba różnych segmentów aktywności w przedziale czasu dla tego punktu danych.
Podsumowanie podstawowej przemiany materii (BMR)
Każdy punkt danych odzwierciedla średnią, maksymalną i minimalną przemianę materii
w wybranym okresie, w kilokaloriach na dzień. Jest to przydatne, jeśli użytkownik ma
przybrał lub stracił wagę i w związku z tym zmienił się wskaźnik BMR.
Maksymalna wartość BMR użytkownika w danym okresie.
min (float–kcal dziennie)
Minimalna wartość BMR użytkownika w danym okresie.
Android
Nazwa
com.google.calories.bmr.summary
Obiekt typu danych
AGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
Pola (format – jednostki)
FIELD_AVERAGE (float–kcal dziennie)
Średni BMR użytkownika w danym okresie.
FIELD_MAX (float–kcal dziennie)
Maksymalna wartość BMR użytkownika w danym okresie.
FIELD_MIN (float – kcal dziennie)
Minimalna wartość BMR użytkownika w danym okresie.
Podsumowanie spalonych kalorii
Zbiorcze lub całkowita liczba kalorii spalonych w określonym czasie (w kilokaloriach).
Ten typ danych i jego pola są takie same jak w przypadku danych błyskawicznych
.
Podsumowanie punktów kardio
Każdy punkt danych reprezentuje liczbę punktów kardio zdobytych w wybranym okresie.
liczbę punktów kardio zdobytych w danym okresie,
łącznie z punktami zdobytymi przez mnożniki (więcej punktów zdobytych za
bardziej intensywnej aktywności).
duration (float – minuty)
Czas zdobywania punktów kardio mierzony w minutach.
Android
Nazwa
com.google.heart_minutes.summary
Obiekt typu danych
AGGREGATE_HEART_POINTS
Pola (format – jednostki)
FIELD_INTENSITY (float – punkty kardio)
liczbę punktów kardio zdobytych w danym okresie,
łącznie z punktami zdobytymi przez mnożniki (więcej punktów zdobytych za
bardziej intensywnej aktywności).
FIELD_DURATION (float – minuty)
Czas zdobywania punktów kardio mierzony w minutach.
Podsumowanie minut ruchu
Łączna liczba minut ruchu w danym okresie. Ten typ danych i pola
są takie same jak w przypadku danych błyskawicznych.
Podsumowanie zasilania
Każdy punkt danych reprezentuje średnią, maksymalną i minimalną moc generowaną w watach w danym okresie.
Średnia moc wytworzona przez użytkownika w danym okresie (w watach).
max (float – watów)
Maksymalna moc wytworzona przez użytkownika w danym okresie (w watach).
min (float – watów)
Minimalna moc wytworzona przez użytkownika w danym okresie (w watach).
Android
Nazwa
com.google.power.summary
Obiekt typu danych
AGGREGATE_POWER_SUMMARY
Pola (format – jednostki)
FIELD_AVERAGE (float – watów)
Średnia moc wytworzona przez użytkownika w danym okresie (w watach).
FIELD_MAX (float – waty)
Maksymalna moc wytworzona przez użytkownika w danym okresie (w watach).
FIELD_MIN (float – waty)
Minimalna moc wytworzona przez użytkownika w danym okresie (w watach).
Podsumowanie delta liczby kroków
Każdy punkt danych reprezentuje łączną liczbę kroków w danym okresie.
Ten typ danych i jego pola są takie same jak w przypadku danych błyskawicznych
.
Treść
Używaj tych typów danych do odczytu zbiorczych danych pomiarowych dotyczących ciała.
Podsumowanie procentowej tkanki tłuszczowej
Każdy punkt danych reprezentuje średnią, maksymalną i minimalną zawartość tkanki tłuszczowej użytkownika
w danym okresie.
REST
Nazwa
com.google.body.fat.percentage.summary
Zakresy uprawnień protokołu OAuth
https://www.googleapis.com/auth/fitness.body.read
Pola (format – jednostki)
średnio (float – wartość procentowa)
Średni procent masy ciała użytkownika stanowiący tkankę tłuszczową w danym okresie.
max (float – wartość procentowa)
Maksymalny procent całkowitej masy ciała użytkownika, który stanowi tkankę tłuszczową w danym okresie.
min (float – wartość procentowa)
Minimalny procent całkowitej masy ciała użytkownika, który stanowi tkankę tłuszczową w danym okresie.
Android
Nazwa
com.google.body.fat.percentage.summary
Obiekt typu danych
AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
Pola (format – jednostki)
FIELD_AVERAGE (float – wartość procentowa)
Średni procent masy ciała użytkownika stanowiący tkankę tłuszczową w danym okresie.
FIELD_MAX (float – wartość procentowa)
Maksymalny procent całkowitej masy ciała użytkownika, który stanowi tkankę tłuszczową w danym okresie.
FIELD_MIN (float – wartość procentowa)
Minimalny procent całkowitej masy ciała użytkownika, który stanowi tkankę tłuszczową w danym okresie.
Podsumowanie tętna
Każdy punkt danych reprezentuje średnie, maksymalne i minimalne tętno użytkownika w okresie
w uderzeniach na minutę.
REST
Nazwa
com.google.heart_rate.summary
Zakresy uprawnień protokołu OAuth
https://www.googleapis.com/auth/fitness.body.read
Pola (format – jednostki)
średnio (float–uderz./min)
Średnie tętno użytkownika w wybranym okresie (w uderzeniach na minutę).
maks. (float–uderz./min)
Maksymalne tętno użytkownika w danym okresie (w uderzeniach na minutę).
min (float–uderz./min)
Minimalne tętno użytkownika w uderzeniach na minutę w danym okresie.
Android
Nazwa
com.google.heart_rate.summary
Obiekt typu danych
AGGREGATE_HEART_RATE_SUMMARY
Pola (format – jednostki)
FIELD_AVERAGE (float–uderz./min)
Średnie tętno użytkownika w wybranym okresie (w uderzeniach na minutę).
FIELD_MAX (float–uderz./min)
Maksymalne tętno użytkownika w danym okresie (w uderzeniach na minutę).
FIELD_MIN (float – uderz./min)
Minimalne tętno użytkownika w uderzeniach na minutę w danym okresie.
Podsumowanie wzrostu
Każdy punkt danych reprezentuje średnią, maksymalną i minimalną wysokość użytkownika w danym okresie.
okresu w metrach.
REST
Nazwa
com.google.height.summary
Zakresy uprawnień protokołu OAuth
https://www.googleapis.com/auth/fitness.body.read
Pola (format – jednostki)
średnio (float – m)
Średni wzrost użytkownika w danym okresie (w metrach).
max (float – m)
Maksymalna wysokość użytkownika w danym okresie (w metrach).
min (float – metry)
Minimalna wysokość użytkownika w danym okresie (w metrach).
Android
Nazwa
com.google.height.summary
Obiekt typu danych
AGGREGATE_HEIGHT_SUMMARY
Pola (format – jednostki)
FIELD_AVERAGE (float – m)
Średni wzrost użytkownika w danym okresie (w metrach).
FIELD_MAX (float – m)
Maksymalna wysokość użytkownika w danym okresie (w metrach).
FIELD_MIN (float – metry)
Minimalna wysokość użytkownika w danym okresie (w metrach).
Podsumowanie wagi
Każdy punkt danych reprezentuje średnią, maksymalną i minimalną wagę użytkownika w
w kilogramach czasu.
REST
Nazwa
com.google.weight.summary
Zakresy uprawnień protokołu OAuth
https://www.googleapis.com/auth/fitness.body.read
Pola (format – jednostki)
średnio (float – kg)
Średnia waga ciała użytkownika w danym okresie (w kilogramach).
maks (float – kg)
Maksymalna masa ciała użytkownika w danym okresie (w kilogramach).
min (float–kg)
Minimalna masa ciała użytkownika w danym okresie (w kilogramach).
Android
Nazwa
com.google.weight.summary
Obiekt typu danych
AGGREGATE_WEIGHT_SUMMARY
Pola (format – jednostki)
FIELD_AVERAGE (float – kg)
Średnia waga ciała użytkownika w danym okresie (w kilogramach).
FIELD_MAX (float–kg)
Maksymalna masa ciała użytkownika w danym okresie (w kilogramach).
FIELD_MIN (float – kg)
Minimalna masa ciała użytkownika w danym okresie (w kilogramach).
Lokalizacja
Te typy danych umożliwiają odczytywanie zbiorczych danych o lokalizacji.
Delta odległości
Każdy punkt danych reprezentuje całkowitą odległość pokonaną przez użytkownika w czasie
okresu w metrach. Ten typ danych i jego pola są takie same jak w przypadku
błyskawicznego typu danych.
Ramka ograniczająca lokalizację
Każdy punkt danych reprezentuje ograniczenie
obliczone na podstawie
punkty lokalizacji w danym okresie. Każda ramka ograniczająca ma 4 pola
reprezentujący cztery rogi ramki ograniczającej.
Minimalna szerokość ramki ograniczającej wyrażona w stopniach jako liczba zmiennoprzecinkowa.
niska długość geograficzna (float – stopnie)
Minimalna długość geograficzna ramki ograniczającej wyrażona w stopniach w postaci liczby zmiennoprzecinkowej.
wysoka szerokość geograficzna (float – stopnie)
Maksymalna szerokość geograficzna ramki ograniczającej wyrażona w stopniach jako liczba zmiennoprzecinkowa.
wysoka długość geograficzna (float – stopnie)
Maksymalna długość geograficzna ramki ograniczającej wyrażona w stopniach w postaci liczby zmiennoprzecinkowej.
Android
Nazwa
com.google.location.bounding_box
Obiekt typu danych
AGGREGATE_LOCATION_BOUNDING_BOX
Pola (format – jednostki)
FIELD_LOW_LATITUDE (float – stopnie)
Szerokość lewego dolnego rogu ramki ograniczającej wyrażona w stopniach jako liczba zmiennoprzecinkowa.
FIELD_LOW_LONGITUDE (float – stopnie)
Długość geograficzna lewego dolnego rogu ramki ograniczającej wyrażona w stopniach jako liczba zmiennoprzecinkowa.
FIELD_HIGH_LATITUDE (float – stopnie)
Szerokość geograficzna prawego górnego rogu ramki ograniczającej wyrażona w stopniach jako liczba zmiennoprzecinkowa.
FIELD_HIGH_LONGITUDE (float – stopnie)
Długość geograficzna prawego górnego rogu ramki ograniczającej wyrażona w stopniach jako liczba zmiennoprzecinkowa.
Podsumowanie szybkości
Każdy punkt danych reprezentuje średnią, maksymalną i minimalną prędkość, z której korzysta użytkownik.
pokonywane w danym okresie, w metrach na sekundę.
Średnia prędkość użytkownika w danym okresie (w metrach na sekundę).
max (float – metry na sekundę)
Maksymalna prędkość użytkownika w danym okresie (w metrach na sekundę).
min (float – metry na sekundę)
Minimalna prędkość użytkownika w danym okresie (w metrach na sekundę).
Android
Nazwa
com.google.speed.summary
Obiekt typu danych
AGGREGATE_SPEED_SUMMARY
Pola (format – jednostki)
średnio (float – metry na sekundę)
Średnia prędkość użytkownika w danym okresie (w metrach na sekundę).
max (float – metry na sekundę)
Maksymalna prędkość użytkownika w danym okresie (w metrach na sekundę).
min (float – metry na sekundę)
Minimalna prędkość użytkownika w danym okresie (w metrach na sekundę).
Odżywianie
Używaj tych typów danych, aby odczytywać zbiorcze dane dotyczące odżywiania.
Podsumowanie nawodnienia
Każdy punkt danych reprezentuje całkowitą ilość wody wypitej przez użytkownika w okresie
okresu w litrach. Ten typ danych i jego pola są takie same jak w przypadku
błyskawicznego typu danych.
Podsumowanie żywienia
Każdy punkt danych reprezentuje sumę wszystkich wpisów dotyczących wartości odżywczych w danym okresie.
Każda wartość w polu składników odżywczych to suma składników odżywczych we wszystkich produktach
wpisów w danym okresie.
Jeśli danej wartości odżywczej nie było w żadnej pozycji, nie będzie jej na mapie zbiorczej.
albo. Jeśli wszystkie wpisy w danym okresie dotyczą tego samego posiłku, typ posiłku.
.
Łączna zawartość składników odżywczych w jedzeniu w danym okresie.
Akceptowane wartości
"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
Nazwa
com.google.nutrition.summary
Obiekt typu danych
AGGREGATE_NUTRITION_SUMMARY
Pola (format – jednostki)
FIELD_MEAL_TYPE (int – wyliczenie)
Rodzaj posiłku jedzonego przez użytkownika (jeśli wszystkie wpisy w danym okresie dotyczą tego samego posiłku).
Łączna zawartość składników odżywczych w jedzeniu w danym okresie.
Akceptowane wartości
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
Zdrowie
Używaj tych typów danych do odczytu zbiorczych danych medycznych i dotyczących zdrowia.
Podsumowanie poziomu glukozy we krwi
Każdy punkt danych reprezentuje średni, minimalny i maksymalny poziom glukozy we krwi
lub stężenie w zakresie czasowym, mierzone w mmol/L, gdzie 1 mmol/L to 18
mg/dl.
Jeśli wartości w każdym z tych pól są takie same we wszystkich wykonanych pomiarach
w wybranym przedziale czasu w zwróconych danych pojawi się wartość pola:
stosunek czasowy do posiłku,
czasowy stosunek do snu
źródło próbki
Jeśli wartości będą różne w pomiarach, pole zostanie wykluczone.
Średni poziom glukozy we krwi lub stężenie glukozy we krwi w danym okresie.
max (float – mmol/L)
Maksymalny poziom glukozy we krwi lub stężenie glukozy we krwi w danym okresie.
min (float – mmol/L)
Minimalny poziom glukozy we krwi lub stężenie glukozy we krwi w danym okresie.
tymczasowy stosunek do posiłku (int – wyliczenie) (pole opcjonalne)
Czas wykonania odczytu w porównaniu z datą spożycia przez użytkownika.
Akceptowane wartości
"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
rodzaj posiłku (int – wyliczenie) (pole opcjonalne)
rodzaj posiłku, który użytkownik zjadł w momencie wykonania odczytu;
Czas wykonania odczytu w porównaniu z datą spożycia przez użytkownika.
Akceptowane wartości
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
Czas wykonania odczytu w porównaniu z czasem snu użytkownika.
Akceptowane wartości
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.
Każdy punkt danych reprezentuje średnie, minimalne i maksymalne ciśnienie krwi w
zakresu czasu mierzonego w mmHg.
Jeśli wartości w każdym z tych pól są takie same we wszystkich wykonanych pomiarach
w wybranym przedziale czasu w zwróconych danych pojawi się wartość pola:
pozycja ciała
lokalizacja pomiaru
Jeśli wartości będą różne w pomiarach, pole zostanie wykluczone.
Pozycja ciała użytkownika w momencie wykonywania pomiaru.
Akceptowane wartości
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
W której grupie eksperymentalnej i w jakiej części wykonano pomiar.
Akceptowane wartości
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
Podsumowanie temperatury ciała
Każdy punkt danych reprezentuje średnią, minimalną i maksymalną temperaturę ciała
użytkownika w danym okresie.
Będzie również zawierać lokalizację, w której dokonano pomiaru na ciele, jeśli
lokalizacja pomiaru była taka sama dla wszystkich punktów danych w danym przedziale czasu.
Każdy punkt danych reprezentuje średnią, minimalną i maksymalną saturację krwi.
nasycenie i natężenie przepływu tlenu przez użytkownika w danym przedziale czasu.
Jeśli wartości w każdym z tych pól są takie same we wszystkich wykonanych pomiarach
w wybranym przedziale czasu w zwróconych danych pojawi się wartość pola:
tryb administrowania terapią tlenową
system nasycenia tlenem
metoda pomiaru nasycenia tlenem
Jeśli wartości będą różne w pomiarach, pole zostanie wykluczone.
[null,null,["Ostatnia aktualizacja: 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."]]],[]]