Google Health API की मदद से, Steps Experiences डेवलप करना

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

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

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

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

टेबल: Google Health API के चरणों के डेटा टाइप

डेटा टाइप   dataType   filter पैरामीटर	Record type	उपलब्ध कार्रवाइयां	दायरा	वेबबुक support	ट्रू ज़ीरो की सुविधा
तरीका   steps   steps	इंटरवल	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

यहां दिए गए सेक्शन में, steps डेटा टाइप की तकनीकी जानकारी दी गई है. इसमें REST के उदाहरण और इंटिग्रेशन के दिशा-निर्देश शामिल हैं.

ज़रूरी स्कोप

इस डेटा टाइप को ऐक्सेस करने के लिए, आपके ऐप्लिकेशन को OAuth के इन स्कोप का अनुरोध करना होगा:

• पढ़ें: https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
• लिखें: https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly

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

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

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

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

यूज़र इंटरफ़ेस बनाना (मिलान करना)

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

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

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

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

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

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

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

शून्य वैल्यू को मैनेज करना

Google Health API, लंबे समय तक एक ही जगह पर बैठे रहने की समस्या को हल करने के लिए, सही ज़ीरो लागू करता है. अगर कोई उपयोगकर्ता ऐक्टिव है या उसने ट्रैकर पहना है, लेकिन वह चल नहीं रहा है, तो ट्रैकर "0" के count के साथ, कदमों के इंटरवल की जानकारी लिखता है. इससे आपको यह पता चलता है कि उपयोगकर्ता ने डिवाइस को पहनकर कोई गतिविधि नहीं की या उसने डिवाइस को पहना ही नहीं. ज़्यादा जानकारी के लिए, डेटा की मौजूदगी और सही ज़ीरो गाइड देखें.