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ım verisi 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
Adımlar   steps   steps	Aralık	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

Aşağıdaki bölümlerde, REST gösterim örnekleri ve entegrasyon yönergeleri de dahil olmak üzere steps veri türüyle ilgili teknik ayrıntılar verilmektedir.

Gerekli kapsamlar

Bu veri türüne erişmek için uygulamanızın aşağıdaki OAuth kapsamlarını istemesi gerekir:

• Okuma: https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
• Yazma: https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly

Yönergeler

Adım izlemeyi uygulamanıza entegre ederken aşağıdaki tasarım ve uygulama yönergelerini uygulayın.

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.

Hem rollUp hem de reconcile uç noktaları, dataSourceFamily sorgu parametresini kabul ederek belirli kaynak gruplarındaki verileri filtrelemenize olanak tanır.

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. Kullanıcı etkinse veya takip cihazı takıyorsa ancak yürümüyorsa takip cihazı, count olan açık adım aralıkları yazar."0" Bu sayede, kullanıcının cihazı takarken hiç adım atmadığı dönemlerle cihazı hiç takmadığı dönemleri ayırt edebilirsiniz. Daha fazla bilgi için Veri varlığı ve gerçek sıfırlar kılavuzuna bakın.