Google Fit REST API dahil olmak üzere Google Fit API'leri, 30 Haziran 2025'ten sonra kullanılamayacak. 1 Mayıs 2024'ten itibaren geliştiriciler bu API'leri kullanmak için kaydolamayacak.
Google Fit platformu, sürekli olarak kaydedilebilen veriler için (bir dönem boyunca birden fazla veri noktasıyla) bu verileri toplayabilir ve hesaplanan sonuçları döndürebilir. Bu, ortalama bir ölçüm veya özet/toplam olabilir. Bu hesaplamalarda zamandan tasarruf edebilir ve birleştirilmiş verileri okuyarak uygulama kullanıcılarınıza yararlı özetler veya ortalamalar gösterebilirsiniz.
Birleştirilmiş verileri okumak için bir veri türü, zaman aralığı ve verileri 'paketleme' (veya gruplandırma) amacıyla başka bir özellik seçmeniz gerekir. Verileri birkaç farklı şekilde gruplandırabilirsiniz:
Dönem
Birleştirilmiş verileri saatlik veya günlük olarak gruplandırın. Örneğin, günlük yakılan adım veya kalori miktarını görebilirsiniz.
Etkinlik türü
Birleştirilmiş verileri etkinlik türüne göre gruplandırın. Örneğin, bir haftalık uyku verilerine dair her uyku aktivitesi türü (hafif, derin ve REM) için ayrı bir paket olacak.
Etkinlik segmenti
Belirli bir dönemdeki etkinlik segmentlerine göre birleştirilmiş verileri toplayın. Örneğin, bir kullanıcı 09:00 ile 10:00 arasında koşuya çıkıp ilk 20 dakika koştuysa, 10 dakika oturdu, 15 dakika yürüdü ve 15 dakika koştuysa bunlar 4 etkinlik segmenti olarak kabul edilir ve 4 grup döndürülür.
Oturum
Verileri toplamak için oturumların zaman sınırlarını kullanın. Örneğin, bir kullanıcı 2 oturum olarak kaydedilen 2 çalıştırmayı (sabah çalıştırma ve öğleden sonra çalıştırma) gerçekleştirdiyse her çalıştırmanın ortalama adımlarını veya ortalama hızını öğrenmek için oturuma göre gruplandırabilirsiniz.
Etkinlik
Toplu sağlık ve sağlıklı yaşam verilerini okumak için bu veri türlerini kullanın.
Etkinlik özeti
Belirli bir zaman diliminde belirli bir etkinliğin toplam süresi ve segmentlerinin sayısı.
Her veri noktası, belirli bir etkinlik türü için bir zaman aralığı boyunca tüm etkinlik segmentlerinin özetini temsil eder.
Kullanıcının yaptığı etkinliğin türü. Etkinlik türlerinin listesini burada bulabilirsiniz.
duration (int—milisaniye)
Zaman aralığındaki tüm segmentlerde bir etkinlik için harcanan toplam süre.
segment sayısı (int—sayı)
Bu veri noktasının zaman aralığı boyunca farklı etkinlik segmentlerinin sayısı.
Android
Ad
com.google.activity.summary
Veri türü nesnesi
AGGREGATE_ACTIVITY_SUMMARY
Alanlar (biçim - birim)
FIELD_ACTIVITY (int—enum)
Kullanıcının yaptığı etkinliğin türü. Etkinlik türlerinin listesini burada bulabilirsiniz.
FIELD_DURATION (int—milisaniye)
Zaman aralığındaki tüm segmentlerde bir etkinlik için harcanan toplam süre.
FIELD_NUM_SEGMENTS (int—sayı)
Bu veri noktasının zaman aralığı boyunca farklı etkinlik segmentlerinin sayısı.
Bazal metabolizma hızı (BMR) özeti
Her veri noktası, kullanıcının zaman aralığındaki ortalama, maksimum ve minimum bazal metabolizma hızını gün başına kilokalori cinsinden gösterir. Kullanıcı kilo aldıysa veya kaybettiyse ve dolayısıyla BMR'si değiştiyse bu yararlı olur.
Çarpanlar tarafından kazanılan puanlar da dahil olmak üzere dönem içinde kazanılan Kardiyo Puanı sayısı (daha yorucu aktiviteler için daha fazla puan kazanılır).
duration (float - dakika)
Kardiyo Puanı'nın kazanıldığı süre (dakika cinsinden ölçülür).
Android
Ad
com.google.heart_minutes.summary
Veri türü nesnesi
AGGREGATE_HEART_POINTS
Alanlar (biçim - birim)
FIELD_INTENSITY (float - Kardiyo Puanı)
Çarpanlar tarafından kazanılan puanlar da dahil olmak üzere dönem içinde kazanılan Kardiyo Puanı sayısı (daha yorucu aktiviteler için daha fazla puan kazanılır).
FIELD_DURATION (float—dakika)
Kardiyo Puanı'nın kazanıldığı süre (dakika cinsinden ölçülür).
Hareket Dakikaları özeti
Dönemdeki toplam taşıma dakikası sayısı. Bu veri türü ve alanları, anlık veri türüyle aynıdır.
Güç özeti
Her veri noktası, kullanıcının belirli bir dönemde vat cinsinden üretilen ortalama, maksimum ve minimum gücünü gösterir.
Kullanıcının belirli bir süre içinde ürettiği ortalama güç (vat cinsinden).
maks. (float—vat)
Kullanıcının belirli bir süre içinde ürettiği maksimum güç (vat cinsinden).
min (float—vat)
Kullanıcının belirli bir süre içinde ürettiği minimum güç (vat cinsinden).
Android
Ad
com.google.power.summary
Veri türü nesnesi
AGGREGATE_POWER_SUMMARY
Alanlar (biçim - birim)
FIELD_AVERAGE (float—vat)
Kullanıcının belirli bir süre içinde ürettiği ortalama güç (vat cinsinden).
FIELD_MAX (float—vat)
Kullanıcının belirli bir süre içinde ürettiği maksimum güç (vat cinsinden).
FIELD_MIN (float—vat)
Kullanıcının belirli bir süre içinde ürettiği minimum güç (vat cinsinden).
Adım sayısı delta özeti
Her veri noktası, dönemdeki toplam adım sayısını temsil eder.
Bu veri türü ve alanları, anlık veri türüyle aynıdır.
Metin
Toplu vücut ölçümü verilerini okumak için bu veri türlerini kullanın.
Vücut yağ yüzdesi özeti
Her veri noktası, kullanıcının belirli bir dönemdeki ortalama, maksimum ve minimum vücut yağ yüzdesini temsil eder.
REST
Ad
com.google.body.fat.percentage.summary
OAuth izin kapsamları
https://www.googleapis.com/auth/fitness.body.read
Alanlar (biçim - birim)
ortalama (float—yüzde)
Kullanıcının belirli bir dönemde toplam vücut kütlesi içindeki vücut yağı içeren ortalama yüzdesi.
max (float—yüzde)
Kullanıcının belirli bir dönemdeki toplam vücut kütlesi cinsinden maksimum yağ yüzdesi.
min (float—yüzde)
Kullanıcının belirli bir dönemde toplam vücut kütlesi için vücut yağı içindeki minimum yüzdesi.
Android
Ad
com.google.body.fat.percentage.summary
Veri türü nesnesi
AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
Alanlar (biçim - birim)
FIELD_AVERAGE (float—yüzde)
Kullanıcının belirli bir dönemde toplam vücut kütlesi içindeki vücut yağı içeren ortalama yüzdesi.
FIELD_MAX (float—yüzde)
Kullanıcının belirli bir dönemdeki toplam vücut kütlesi cinsinden maksimum yağ yüzdesi.
FIELD_MIN (float—yüzde)
Kullanıcının belirli bir dönemde toplam vücut kütlesi için vücut yağı içindeki minimum yüzdesi.
Nabız özeti
Her veri noktası, nabız/dakika cinsinden kullanıcının dönem boyunca ortalama, maksimum ve minimum nabzını gösterir.
REST
Ad
com.google.heart_rate.summary
OAuth izin kapsamları
https://www.googleapis.com/auth/fitness.body.read
Alanlar (biçim - birim)
ortalama (float - nabız/dk)
Kullanıcının belirli bir dönemde nabız/dakika cinsinden ortalama nabzı.
maks. (float—bpm)
Kullanıcının belirli bir dönemde dakikadaki nabız sayısı cinsinden maksimum nabzı.
min (float—bpm)
Kullanıcının belirli bir dönemde dakikadaki nabız sayısı cinsinden minimum nabız.
Android
Ad
com.google.heart_rate.summary
Veri türü nesnesi
AGGREGATE_HEART_RATE_SUMMARY
Alanlar (biçim - birim)
FIELD_AVERAGE (float—bpm)
Kullanıcının belirli bir dönemde nabız/dakika cinsinden ortalama nabzı.
FIELD_MAX (float—bpm)
Kullanıcının belirli bir dönemde dakikadaki nabız sayısı cinsinden maksimum nabzı.
FIELD_MIN (float—bpm)
Kullanıcının belirli bir dönemde dakikadaki nabız sayısı cinsinden minimum nabız.
Boy özeti
Her veri noktası, kullanıcının bir dönem boyunca ortalama, maksimum ve minimum yüksekliğini metre cinsinden gösterir.
REST
Ad
com.google.height.summary
OAuth izin kapsamları
https://www.googleapis.com/auth/fitness.body.read
Alanlar (biçim - birim)
ortalama (float - metre)
Kullanıcının bir zaman diliminde metre cinsinden ortalama boyu.
max (float—metre)
Kullanıcının belirli bir dönemde metre cinsinden maksimum yüksekliği.
min (float—metre)
Kullanıcının belirli bir dönemde metre cinsinden minimum yüksekliği.
Android
Ad
com.google.height.summary
Veri türü nesnesi
AGGREGATE_HEIGHT_SUMMARY
Alanlar (biçim - birim)
FIELD_AVERAGE (float—metre)
Kullanıcının bir zaman diliminde metre cinsinden ortalama boyu.
FIELD_MAX (float—metre)
Kullanıcının belirli bir dönemde metre cinsinden maksimum yüksekliği.
FIELD_MIN (float—metre)
Kullanıcının belirli bir dönemde metre cinsinden minimum yüksekliği.
Kilo özeti
Her veri noktası, kullanıcının belirli bir süre boyunca ortalama, maksimum ve minimum ağırlığını kilogram cinsinden gösterir.
REST
Ad
com.google.weight.summary
OAuth izin kapsamları
https://www.googleapis.com/auth/fitness.body.read
Alanlar (biçim - birim)
ortalama (float-kg)
Kullanıcının belirli bir süredeki ortalama vücut ağırlığı (kilogram cinsinden).
max (float—kg)
Kullanıcının belirli bir dönemde kilogram cinsinden maksimum vücut ağırlığı.
min. (float—kg)
Kullanıcının belirli bir dönemde kilogram cinsinden minimum vücut ağırlığı.
Android
Ad
com.google.weight.summary
Veri türü nesnesi
AGGREGATE_WEIGHT_SUMMARY
Alanlar (biçim - birim)
FIELD_AVERAGE (float-kg)
Kullanıcının belirli bir süredeki ortalama vücut ağırlığı (kilogram cinsinden).
FIELD_MAX (float—kg)
Kullanıcının belirli bir dönemde kilogram cinsinden maksimum vücut ağırlığı.
FIELD_MIN (float—kg)
Kullanıcının belirli bir dönemde kilogram cinsinden minimum vücut ağırlığı.
Konum
Birleştirilmiş konum verilerini okumak için bu veri türlerini kullanın.
Mesafe delta
Her veri noktası, kullanıcının bir süre boyunca katettiği toplam mesafeyi metre cinsinden gösterir. Bu veri türü ve alanları, anlık veri türüyle aynıdır.
Konum sınırlama kutusu
Her veri noktası, bir dönem boyunca kullanıcının konum noktaları üzerinde hesaplanan sınırlayıcı kutuyu temsil eder. Her sınırlayıcı kutuda, sınırlayıcı kutunun dört köşesini temsil eden dört alan bulunur.
Kullanıcının belirli bir süre boyunca metre/saniye cinsinden ortalama hızı.
max (float—saniyede metre)
Kullanıcının belirli bir süredeki maksimum hızı (metre/saniye).
min (float—metre/saniye)
Kullanıcının belirli bir dönemdeki minimum hızı (metre/saniye).
Android
Ad
com.google.speed.summary
Veri türü nesnesi
AGGREGATE_SPEED_SUMMARY
Alanlar (biçim - birim)
ortalama (float—metre/saniye)
Kullanıcının belirli bir süre boyunca metre/saniye cinsinden ortalama hızı.
max (float—saniyede metre)
Kullanıcının belirli bir süredeki maksimum hızı (metre/saniye).
min (float—metre/saniye)
Kullanıcının belirli bir dönemdeki minimum hızı (metre/saniye).
Beslenme
Toplu beslenme verilerini okumak için bu veri türlerini kullanın.
Sıvı alımı özeti
Her veri noktası, kullanıcının belirli bir süre boyunca tükettiği toplam su hacmini litre cinsinden gösterir. Bu veri türü ve alanları, anlık veri türüyle aynıdır.
Beslenme özeti
Her veri noktası, bir dönemdeki tüm beslenme girişlerinin toplamını temsil eder.
Besinler alanındaki her bir değer, dönemdeki tüm girişlerde yer alan besinlerin toplamını temsil eder.
Besin, girişlerin hiçbirinde yer almıyorsa toplu haritada da yer almaz. Dönemdeki tüm girişler aynı öğünle ilgiliyse yemek türü de ayarlanır.
Belirli bir süre içinde yenen yiyeceklerdeki toplam besin maddeleri.
Kabul edilen değerler
"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
Ad
com.google.nutrition.summary
Veri türü nesnesi
AGGREGATE_NUTRITION_SUMMARY
Alanlar (biçim - birim)
FIELD_MEAL_TYPE (int—enum)
Kullanıcının yediği yemek türü (dönemdeki tüm girişler aynı öğünle ilgiliyse gösterilir).
Belirli bir süre içinde yenen yiyeceklerdeki toplam besin öğesi sayısı.
Kabul edilen değerler
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
Sağlık
Toplu tıbbi ve sağlık verilerini okumak için bu veri türlerini kullanabilirsiniz.
Kan şekeri özeti
Her veri noktası, belirli bir zaman aralığındaki ortalama, minimum ve maksimum kan şekeri seviyesi veya konsantrasyonunu temsil eder. 1 mmol/L, 18 mg/dL değerine karşılık gelen mmol/L cinsinden ölçülür.
Bu alanların her birinin değerleri, ilgili zaman aralığında alınan tüm ölçümler için aynıysa döndürülen verilerde alan değerini görürsünüz:
Kullanıcının belirli bir dönemdeki ortalama kan şekeri seviyesi veya konsantrasyonu.
maks (float—mmol/L)
Kullanıcının belirli bir dönemdeki maksimum kan şekeri seviyesi veya konsantrasyonu.
min (float—mmol/L)
Kullanıcının belirli bir dönemdeki minimum kan şekeri seviyesi veya konsantrasyonu.
geçici yemekle ilişki (int—enum) (isteğe bağlı alan)
Okumanın yapıldığı zamana kıyasla kullanıcının yemek yediği zaman.
Kabul edilen değerler
"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
meal type [meal türü] (int—enum) (isteğe bağlı alan)
geçici uykuyla ilişki (int - enum) (isteğe bağlı alan)
Değerin, kullanıcının uyuduğu zamana kıyasla ölçüldüğü zaman.
Kabul edilen değerler
"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
örnek kaynak (int—enum) (isteğe bağlı alan)
Kandaki glikozu ölçmek için kullanılan vücut sıvısının türüdür.
Kullanıcının belirli bir dönemdeki ortalama kan şekeri seviyesi veya konsantrasyonu.
FIELD_MAX (float—mmol/L)
Kullanıcının belirli bir dönemdeki maksimum kan şekeri seviyesi veya konsantrasyonu.
FIELD_MIN (float—mmol/L)
Kullanıcının belirli bir dönemdeki minimum kan şekeri seviyesi veya konsantrasyonu.
FIELD_TEMPORAL_RELATION_TO_MEAL (int—enum) (isteğe bağlı alan)
Okumanın yapıldığı zamana kıyasla kullanıcının yemek yediği zaman.
Kabul edilen değerler
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
FIELD_TEMPORAL_RELATION_TO_SLEEP (int—enum) (isteğe bağlı alan)
Değerin, kullanıcının uyuduğu zamana kıyasla ölçüldüğü zaman.
Kabul edilen değerler
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.
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE (int—enum) (isteğe bağlı alan)
Kandaki glikozu ölçmek için kullanılan vücut sıvısının türüdür.
Kullanıcının belirli bir dönemdeki ortalama küçük tansiyon değeri.
FIELD_BLOOD_PRESSURE_DIASTOLIC_MAX (float—mmHg)
Kullanıcının belirli bir dönemdeki maksimum küçük tansiyon değeri.
FIELD_BLOOD_PRESSURE_DIASTOLIC_MIN (float—mmHg)
Kullanıcının belirli bir dönemdeki minimum küçük tansiyon değeri.
FIELD_BODY_POSITION (int—enum) (isteğe bağlı alan)
Ölçüm yapılırken kullanıcının vücut pozisyonu.
Kabul edilen değerler
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATION (int—enum) (isteğe bağlı alan)
Ölçümün yapıldığı kol ve kolun bir kısmı.
Kabul edilen değerler
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
Vücut sıcaklığı özeti
Her veri noktası, kullanıcının bir zaman aralığında ortalama, minimum ve maksimum vücut sıcaklığını temsil eder.
Ölçüm konumu zaman aralığındaki tüm veri noktaları için aynıysa bu raporda, ölçümün gövde üzerinde yapıldığı konum da yer alır.
Her veri noktası, bir zaman aralığında kullanıcının kandaki oksijen doygunluğunu (ortalama, minimum ve maksimum) ve ilave oksijen akış hızını temsil eder.
Bu alanların her birinin değerleri, ilgili zaman aralığında alınan tüm ölçümler için aynıysa döndürülen verilerde alan değerini görürsünüz: