Google Health API ile adım deneyimleri geliştirme

Google Health API, steps aralık veri türünü kullanarak kullanıcı adımlarını ve etkinlik verilerini izler. Adım sayısı, günlük fiziksel aktivitenin temel bir ölçüsüdür. Geliştiricilerin fitness ilerleme durumunu takip etmesine, enerji harcamasını hesaplamasına ve kullanıcılara yönelik günlük aktivite özetleri oluşturmasına yardımcı olur.

Kullanıcılarınıza en iyi deneyimi sunmak için uygulamanızdaki adım sayısı metriklerini nasıl okuyacağınızı ve yapılandıracağınızı öğrenin.

Desteklenen veri türleri

API, adım sayısını izlemek için aşağıdaki veri türünü destekler:

Tablo: Google Health API Adım veri türleri

Veri türü	Kullanılabilir işlemler	Kapsam
Adımlar dataType: steps filter parameter: steps Kayıt türü: Aralık Depolama çözünürlüğü: 1 dakika Webhook desteği Gerçek sıfır desteği Adım adım kılavuz Uyumlu cihazlar Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

Yönergeler

Adım takibini uygulamanıza entegre ederken aşağıdaki tasarım ve uygulama yönergelerine uyun.

Hız ve tempo hesaplama

Google Health API, hızı ve tempoyu hesaplamak için standart formüller kullanır:

• Hız = distance / time(hour)
• Tempo = time(seconds) / distance

İstekte belirtilen Accept-Language başlığı, mesafe birimini belirler.

Günlük özet

Seyahat, saat dilimi değişiklikleri veya yaz saati uygulaması sırasında günlük adım sayılarını doğru şekilde toplamak için istemci tarafında süre hesaplamaları yapmayın. Bunun yerine, UTC ofsetlerini kullanarak fiziksel veri boşluklarını otomatik olarak mutabık kılan dailyRollUp uç noktasını sorgulayın. Toplama işlemi, istenen gün için toplam birikmiş adımları temsil eden countSum alanını içeren bir StepsRollupValue döndürür. Ayrıntılar için Birleştirilmiş veri kılavuzundaki Takvim günleri genelinde birleştirme bölümüne bakın.

Kullanıcı arayüzlerini çizme (Mutabakat)

Adım verilerini görüntülemek için kullanıcı arayüzü öğeleri oluştururken reconcile uç noktasını kullanın. Birden fazla veri kaynağı (ör. akıllı saat ve cep telefonu) aynı anda adım kaydettiyse reconcile uç noktası, çakışmaları çözer ve akışları birleştirerek tek bir uzlaştırılmış veri akışı döndürür.

Bağlı cihaz senkronizasyonlarından kaynaklanan çakışan aralıkları ve zaman damgası değişkenliğini yönetme hakkında bilgi için Veri yönetimi kılavuzunu inceleyin.

Gün içi izleme ve histogramlar

Gün boyunca ayrıntılı kullanıcı etkinliğini (ör. grafikler ve tablolar) görüntülemek için:

• Saatlik veya dakikalık adım histogramları: windowSize parametresini kullanarak süreyi (ör. 1 dakika için 60s veya 1 saat için 3600s) belirterek rollUp uç noktasını sorgulayın. Adım verileri 1 dakikalık (60s) aralıklarla kaydedildiğinden windowSize değerini en az 60s olarak ayarlayın. Bir dakikadan kısa pencere boyutlarına (ör. 10s veya 30s) sahip istekler, her bir dakikanın toplamını bölmez ve tam dakikanın sayısını eşleşen ilk alt gruba yerleştirir. Ayrıntılar için Toplama penceresi ve depolama çözünürlüğü bölümünü inceleyin.
• Tüm adım kayıtları: En ayrıntılı, ham adım kayıtlarını almak için list uç noktasını kullanın.

rollUp, dailyRollUp ve reconcile uç noktaları, dataSourceFamily parametresini kabul ederek belirli kaynak gruplarından gelen verileri filtrelemenize olanak tanır. Daha fazla bilgi ve kullanım örnekleri için Verileri filtreleme kılavuzunun Veri kaynağı ailesine göre filtreleme bölümüne bakın.

Webhook'ları kullanarak anlık senkronizasyon

Yeni adım verileri içe aktarıldığında veya senkronize edildiğinde anlık olarak bildirim almak için steps veri türü koleksiyonuna abone olun. REST uç noktalarını sorgulamak yerine, bu webhook bildirimlerine yanıt olarak istemci tarafı kontrol panellerini dinamik olarak güncelleyin. Abonelikleri ayarlama hakkında ayrıntılı bilgi için Webhook abonelikleri başlıklı makaleyi inceleyin.