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 एंडपॉइंट को पोल करने के बजाय, इन वेबहुक सूचनाओं के जवाब में क्लाइंट-साइड डैशबोर्ड को डाइनैमिक तरीके से अपडेट करें. सदस्यताएं सेट अप करने के तरीके के बारे में जानने के लिए, वेबबुक सदस्यताएं लेख पढ़ें.

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

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

इससे, इनके बीच अंतर करने में मदद मिलती है:

• डिवाइस को पहने हुए, एक ही जगह पर बैठे या खड़े रहने की अवधि: उपयोगकर्ता ने डिवाइस पहना हुआ है, लेकिन वह चल नहीं रहा है. इससे count प्रॉपर्टी के बिना रिकॉर्ड दिखते हैं. इसका मतलब है कि कोई कदम नहीं चला गया.
• डिवाइस को हाथ में न पहनने की अवधि: जब उपयोगकर्ता ने डिवाइस को हाथ में नहीं पहना होता है. इससे कोई रिकॉर्ड नहीं मिलता. इसलिए, डेटा में काफ़ी अंतर दिखता है.

ज़्यादा जानकारी के लिए, डेटा की मौजूदगी और सही शून्य गाइड देखें.