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ünü temsil eder. Geliştiricilerin fitness ilerlemesini izlemesine, enerji harcamasını hesaplamasına ve kullanıcıya 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 okuyup 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ımlar veri türleri

Veri türü	Kullanılabilir işlemler	Kapsam
Adımlar dataType: steps filter parameter: steps Kayıt türü: Aralık 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 izlemeyi uygulamanıza entegre ederken aşağıdaki tasarım ve uygulama yönergelerini uygulayın.

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 farklarını kullanarak fiziksel veri boşluklarını otomatik olarak uzlaştıran 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.

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

Adım verilerini göstermek 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ı giderir ve tek bir uzlaştırılmış veri akışı döndürmek için akışları birleştirir.

Gün içi izleme ve histogramlar

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

• Saatlik adım histogramları: rollUp uç noktasını sorgulayın ve windowSize parametresini kullanarak süreyi (ör. 1 saat için 3600s) belirtin.
• Tüm adım kayıtları: En ayrıntılı ve işlenmemiş adım kayıtlarını getirmek için list uç noktasını kullanın.

rollUp, dailyRollUp ve reconcile uç noktaları, dataSourceFamily parametresini kabul eder. Bu sayede, belirli kaynak gruplarından gelen verileri filtreleyebilirsiniz. Daha fazla bilgi ve kullanım örnekleri için Endpoints kılavuzunun Veri kaynağı ailesine göre filtreleme ve toplama 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 anında bildirim almak için steps veri türü koleksiyonuna abone olun. REST uç noktalarını yoklamak yerine, bu webhook bildirimlerine yanıt olarak istemci tarafı kontrol panellerini dinamik bir şekilde güncelleyin. Abonelikleri ayarlama hakkında ayrıntılı bilgi için Webhook abonelikleri başlıklı makaleyi inceleyin.

Gerçek sıfırları işleme

Google Health API, hareketsiz aralıkları çözmek için gerçek sıfırları uygular. Bir kullanıcı belirli bir dönemde takip cihazı takıyor ancak yürümüyorsa API, normal veri kaynağını ve zaman damgası meta verilerini içeren ancak count özelliğini içermeyen bir kayıt döndürür.

Bu sayede şunlar arasında ayrım yapabilirsiniz:

• Bilekte hareketsiz kalma süreleri: Kullanıcı cihazı takıyor ancak yürümüyor. Bu, count özelliği olmayan kayıtları (sıfır adım olarak yorumlanır) döndürür.
• Bilekte olmadığı dönemler: Kullanıcı cihazı takmıyordur. Bu durumda kayıt döndürülmez ve büyük veri boşlukları oluşur.

Daha fazla bilgi için Veri varlığı ve gerçek sıfırlar kılavuzuna bakın.