Google Health API की मदद से, कदमों से जुड़े अनुभव डेवलप करना

Google Health API, steps इंटरवल डेटा टाइप का इस्तेमाल करके, उपयोगकर्ता के कदमों की संख्या और गतिविधि का डेटा ट्रैक करता है. कदमों की संख्या, रोज़ाना की जाने वाली शारीरिक गतिविधि का एक बुनियादी माप है. इससे डेवलपर, फ़िटनेस की प्रोग्रेस को ट्रैक कर सकते हैं, खर्च की गई ऊर्जा का हिसाब लगा सकते हैं, और उपयोगकर्ताओं के लिए रोज़ाना की गतिविधि की खास जानकारी तैयार कर सकते हैं.

अपने ऐप्लिकेशन में कदमों की संख्या से जुड़ी मेट्रिक को पढ़ने और उन्हें व्यवस्थित करने का तरीका जानें, ताकि उपयोगकर्ताओं को बेहतर अनुभव दिया जा सके.

डेटा टाइप, जो इस्तेमाल किए जा सकते हैं

यह एपीआई, कदमों की संख्या को ट्रैक करने के लिए, इस डेटा टाइप के साथ काम करता है:

टेबल: Google Health API में मौजूद, कदमों से जुड़े डेटा टाइप

डेटा टाइप	उपलब्ध कार्रवाइयां	दायरा
तरीका dataType: steps filter parameter: steps रिकॉर्ड टाइप: इंटरवल स्टोरेज से जुड़ी समस्या हल होने में लगने वाला समय: एक मिनट वेबहुक की सुविधा ट्रू ज़ीरो की सुविधा सिलसिलेवार निर्देश संगत डिवाइस 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

दिशा-निर्देश

अपने ऐप्लिकेशन में कदमों की संख्या को ट्रैक करने की सुविधा को इंटिग्रेट करते समय, डिज़ाइन और लागू करने से जुड़े इन दिशा-निर्देशों का पालन करें.

स्पीड और पेस का कैलकुलेशन

Google Health API, रफ़्तार और पेस का हिसाब लगाने के लिए स्टैंडर्ड फ़ॉर्मूले इस्तेमाल करता है:

• स्पीड = distance / time(hour)
• रफ़्तार = time(seconds) / distance

अनुरोध में बताया गया Accept-Language हेडर, दूरी की इकाई तय करता है.

हर दिन की खास जानकारी

यात्रा, टाइम ज़ोन में बदलाव या डेलाइट सेविंग के दौरान, हर दिन के कदमों की संख्या को सटीक तरीके से इकट्ठा करने के लिए, क्लाइंट-साइड पर अवधि का हिसाब न लगाएं. इसके बजाय, dailyRollUp एंडपॉइंट को क्वेरी करें. यह यूटीसी ऑफ़सेट का इस्तेमाल करके, फ़िज़िकल डेटा के गैप को अपने-आप ठीक करता है. रोलअप, StepsRollupValue दिखाता है. इसमें countSum फ़ील्ड होता है, जो अनुरोध किए गए दिन के लिए कुल कदमों की संख्या दिखाता है. ज़्यादा जानकारी के लिए, कुल डेटा की गाइड में कैलेंडर के दिनों के हिसाब से कुल डेटा देखें.

यूज़र इंटरफ़ेस ड्रॉ करना (रीकंसलिएशन)

कदमों की संख्या का डेटा दिखाने के लिए यूज़र इंटरफ़ेस एलिमेंट बनाते समय, reconcile एंडपॉइंट का इस्तेमाल करें. अगर कई डेटा सोर्स (जैसे, स्मार्टवॉच और मोबाइल फ़ोन) ने एक ही समय पर कदमों की संख्या रिकॉर्ड की है, तो reconcile एंडपॉइंट, डेटा के बीच होने वाले टकराव को हल करता है. साथ ही, स्ट्रीम को मर्ज करके एक ही डेटा स्ट्रीम दिखाता है.

कनेक्ट किए गए डिवाइसों के सिंक होने से ओवरलैप होने वाले इंटरवल और टाइमस्टैंप में बदलाव करने के बारे में जानकारी पाने के लिए, डेटा मैनेजमेंट गाइड देखें.

इंट्राडे ट्रैकिंग और हिस्टोग्राम

दिन भर की उपयोगकर्ता गतिविधि की ज़्यादा जानकारी दिखाने के लिए (जैसे कि चार्ट और ग्राफ़):

• हर घंटे या मिनट के हिसाब से हिस्टोग्राम: rollUp एंडपॉइंट से क्वेरी करें. इसके लिए, windowSize पैरामीटर का इस्तेमाल करके, अवधि (जैसे, एक मिनट के लिए 60s या एक घंटे के लिए 3600s) की जानकारी दें. कदमों की जानकारी देने वाला डेटा, एक मिनट (60s) के अंतराल पर रिकॉर्ड किया जाता है. इसलिए, windowSize को कम से कम 60s पर सेट करें. एक मिनट से कम समय वाली विंडो साइज़ (जैसे, 10s या 30s) के अनुरोध, हर मिनट के कुल डेटा को अलग-अलग नहीं करते. इसके बजाय, वे पूरे मिनट की गिनती को पहले मैच होने वाले सब-बकेट में डाल देते हैं. ज़्यादा जानकारी के लिए, रोलअप विंडो और स्टोरेज रिज़ॉल्यूशन देखें.
• कदमों की संख्या से जुड़ा पूरा डेटा: कदमों की संख्या से जुड़ा पूरा और रॉ डेटा फ़ेच करने के लिए, list एंडपॉइंट का इस्तेमाल करें.

rollUp, dailyRollUp, और reconcile एंडपॉइंट, dataSourceFamily पैरामीटर को स्वीकार करते हैं. इससे आपको सोर्स के खास ग्रुप से डेटा फ़िल्टर करने की सुविधा मिलती है. ज़्यादा जानकारी और इस्तेमाल के उदाहरणों के लिए, डेटा फ़िल्टर करने की गाइड का डेटा सोर्स फ़ैमिली के हिसाब से फ़िल्टर करें सेक्शन देखें.

वेबहुक का इस्तेमाल करके रीयल-टाइम में सिंक करना

steps डेटा टाइप कलेक्शन की सदस्यता लें, ताकि नया डेटा इंपोर्ट या सिंक होने पर, आपको रीयल टाइम में सूचना मिले. REST एंडपॉइंट को पोल करने के बजाय, इन वेबहुक सूचनाओं के जवाब में क्लाइंट-साइड डैशबोर्ड को डाइनैमिक तौर पर अपडेट करें. सदस्यताएं सेट अप करने के बारे में ज़्यादा जानने के लिए, वेबहुक सदस्यताएं देखें.