Google Health API veri türleri

Aşağıdaki tabloda, Google Health API'de her türün gösterimini ve her birinin kapsamını anlamanıza yardımcı olacak çeşitli sütunlarla birlikte veri türlerinin tam listesi yer almaktadır.

Önemli: Veri türü tanımlayıcılarının biçimi, veri türü birden fazla kelime içerdiğinde farklılık gösterir. Bir uç noktada, veri türü adı kebap biçiminde (kelimeler arasında kısa çizgi) olmalıdır. Örneğin, body-fat. Ancak bir filtre parametresinde veri türü adı, body_fat gibi alt çizgiyle ayrılmış (snake case) olmalıdır.

Tablo: Google Health API veri türleri

Veri türü   dataType   filter parametresi	Kayıt türü	Kullanılabilir işlemler	Kapsam	Webhook desteği	Gerçek sıfırlar desteği
Yakılan Aktif Enerji   active-energy-burned   active_energy_burned	Aralık	list, reconcile, rollup, dailyRollup	activity_and_fitness
Etkin Dakikalar   active-minutes   active_minutes	Aralık	list, reconcile, rollup, dailyRollup	activity_and_fitness
Aktif Bölge Dakikası   active-zone-minutes   active_zone_minutes	Aralık	list, reconcile, rollup, dailyRollup	activity_and_fitness
Etkinlik Düzeyi   activity-level   activity_level	Aralık	list, reconcile	activity_and_fitness
Yükseklik   altitude   altitude	Aralık	list, reconcile, rollup, dailyRollup	activity_and_fitness
Kan Şekeri   blood-glucose   blood_glucose	Örnek	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Vücut Yağı   body-fat   body_fat	Örnek	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements
Kalp Atış Hızı Bölgesindeki Kalori   calories-in-heart-rate-zone   calories_in_heart_rate_zone	Aralık	grup, günlükGrup	activity_and_fitness
Vücut İç Sıcaklığı   core-body-temperature   core_body_temperature	Örnek	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Günlük Nabız Değişkenliği   daily-heart-rate-variability   daily_heart_rate_variability	Günlük	list, reconcile	health_metrics_and_measurements
Günlük Kalp Hızı Bölgeleri   daily-heart-rate-zones   daily_heart_rate_zones	Günlük	list, reconcile	health_metrics_and_measurements
Günlük Oksijen Doygunluğu   daily-oxygen-saturation   daily_oxygen_saturation	Günlük	list, reconcile	health_metrics_and_measurements
Günlük Solunum Hızı   daily-respiratory-rate   daily_respiratory_rate	Günlük	list, reconcile	health_metrics_and_measurements
Günlük Dinlenme Nabzı   daily-resting-heart-rate   daily_resting_heart_rate	Günlük	list, reconcile	health_metrics_and_measurements
Günlük Uyku Sıcaklığı Türevleri   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	Günlük	list, reconcile	health_metrics_and_measurements
Günlük Maksimum Oksijen Tüketimi   daily-vo2-max   daily_vo2_max	Günlük	list, reconcile	activity_and_fitness
Mesafe   distance   distance	Aralık	list, reconcile, rollup, dailyRollup	activity_and_fitness
Elektrokardiyogram (EKG)   electrocardiogram   electrocardiogram	Oturum	list	ecg
Egzersiz   exercise   exercise	Oturum	list, get, reconcile, create, update, batchDelete	activity_and_fitness
Katlar   floors   floors	Aralık	reconcile, rollup, dailyRollup	activity_and_fitness
Yiyecek   food   food	Yiyecekler	list, get	beslenme
Yiyecek Ölçü Birimi   food-measurement-unit   food_measurement_unit	Yiyecekler	list, get	beslenme
Kalp atış hızı   heart-rate   heart_rate	Örnek	list, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Nabız Değişkenliği   heart-rate-variability   heart_rate_variability	Örnek	list, reconcile	health_metrics_and_measurements
Boy   height   height	Örnek	list, get, reconcile, create, update, batchDelete	health_metrics_and_measurements
Sıvı alımı günlüğü   hydration-log   hydration_log	Oturum	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	beslenme
Düzensiz Kalp Ritmi Bildirimi   irregular-rhythm-notification   irregular_rhythm_notification	Oturum	list	irn
Beslenme Günlüğü   nutrition-log   nutrition_log	Örnek	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	beslenme
Oksijen Doygunluğu   oxygen-saturation   oxygen_saturation	Örnek	list, reconcile	health_metrics_and_measurements
Solunum Hızı Uyku Özeti   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	Örnek	list, reconcile	health_metrics_and_measurements
Maksimum oksijen tüketimi koşusu   run-vo2-max   run_vo2_max	Örnek	list, reconcile, rollup, dailyRollup	activity_and_fitness
Hareketsiz Kalma Süresi   sedentary-period   sedentary_period	Aralık	list, reconcile, rollup, dailyRollup	activity_and_fitness
Uyku   sleep   sleep	Oturum	list, get, reconcile, create, update, batchDelete	uyku
Adımlar   steps   steps	Aralık	list, reconcile, rollup, dailyRollup	activity_and_fitness
Yüzme Uzunluğu Verileri   swim-lengths-data   swim_lengths_data	Aralık	list, reconcile, rollup, dailyRollup	activity_and_fitness
Nabız Bölgesinde Geçirilen Süre   time-in-heart-rate-zone   time_in_heart_rate_zone	Aralık	list, reconcile, rollup, dailyRollup	activity_and_fitness
Toplam Kalori   total-calories   total_calories	Aralık	grup, günlükGrup	activity_and_fitness
Maksimum oksijen tüketimi   vo2-max   vo2_max	Örnek	list, reconcile	activity_and_fitness
Ağırlık   weight   weight	Örnek	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements

Veri kullanılabilirliği

Kullanıcının verilerindeki güncellemeler yalnızca aktivite takipçisini senkronize ettikten veya Fitbit mobil ya da web uygulamasına manuel olarak yeni veri girdikten sonra kullanılabilir. Fitbit uygulaması mobil cihazda açıkken ve iki cihaz arasında etkin bir veri bağlantısı varken ve Bluetooth menzilindeyken Fitbit cihazı ile Fitbit mobil uygulaması her 15 dakikada bir otomatik olarak senkronize edilebilir. Kullanıcı, MobileTrack'i kullanarak etkinliği izliyorsa uygulama açık olduğu sürece MobileTrack her saat senkronize edilir.

Üçüncü taraf erişimi

Fitbit cihazları, üçüncü taraf uygulamaları veya hizmetleriyle doğrudan iletişim kuramaz. Bu cihazlar yalnızca Fitbit mobil uygulamasıyla iletişim kurup senkronize olacak şekilde tasarlanmıştır.

Cihaz, gün boyunca verileri otomatik olarak senkronize eder. Bu işlem, Fitbit uygulaması açıkken veya Bluetooth etkinse ve uygulama arka planda çalışıyorsa her 15 dakikada bir gerçekleşir. Bu senkronizasyon işlemi tamamlandıktan sonra veriler, Google Health API aracılığıyla üçüncü taraf hizmetler için kullanılabilir.

Mesafe standartları

elevationGainMillimeters gibi egzersiz mesafeleri, aşağıdaki nedenlerle standart birim olarak milimetre cinsinden ölçülür:

1. Veri Hassasiyetini Koruma: Milimetre kullanmanın en önemli nedeni, okuduğumuz ve sağladığımız verilerde hassasiyeti kaybetmemektir. Milimetre gibi ayrıntılı bir birim kullanmak, ölçümleri yüksek doğrulukla göstermemize olanak tanır.
2. Standartlaştırma: Hizmetlerimizde standartlaştırılmış birim olarak milimetre kullanılır. Bu tutarlılık, API'nin farklı bölümleriyle etkileşimde bulunan geliştiriciler için tek tip bir deneyim sunulmasına yardımcı olur.
3. Geniş Ölçüm Sistemi Desteği: Milimetre gibi bir temel birim kullanmak, geliştiricilerin metrik, İngiliz veya başka bir ölçüm sistemiyle çalışıp çalışmadıklarına bakılmaksızın, seçilen diğer birimlere dönüştürmesini kolaylaştırır.

Değişken gün uzunlukları

Health API'nin zaman işleme özelliği, kullanıcının saatini önceliklendirerek yaz saati uygulaması veya seyahat nedeniyle gün uzunluklarındaki değişkenliği hesaba katar. Her veri noktası hem fiziksel bir UTC zaman damgası hem de etkinlik sırasında etkin olan UTC farkıyla birlikte depolanır. Bu sayede sistem:

• Etkinliği belirli bir fiziksel ana eşleyin.
• Toplama için saati kullanıcının yerel bağlamına göre düzeltin.

Yaz saati uygulaması

Yaz saati uygulaması sona erdiğinde "kış saatine geçiş" nedeniyle 25 saatlik bir gün oluşur ve o tarihe ait toplayıcıda 25 saatlik veri bulunur. "İleriye alma" işlemi, saatin Standart Saat'e geri alındığı 23 saatlik bir sivil günle sonuçlanır.

Seyahat

Saat dilimleri arasında seyahat etmek, tek bir sivil günün fiziksel süresinde daha da önemli değişikliklere neden olabilir.

Saat dilimi farklılıklarını uzlaştırmak için dailyRollUp uç noktasını kullanın. Verileri, kullanıcının yerel saatine göre kaydedildiği takvim gününe otomatik olarak atar. Bu sayede, saat dilimi değişikliklerine rağmen günü etkili bir şekilde "birleştirir".