Google is committed to advancing racial equity for Black communities. See how.

दूर और ईटीए

दूर

नेस्ट एपीआई में, "होम" या "अवे" की अवधारणा का नेस्ट की ऊर्जा बचत और सुविधा सुविधाओं के व्यवहार पर एक शक्तिशाली प्रभाव पड़ता है।

होम एंड अवे कैसे काम करता है

घर में इंसान की मौजूदगी का पता लगाने के लिए Nest कई तरह के सिग्नल का इस्तेमाल करता है। अगर Nest को लंबे समय तक कोई मौजूदगी नहीं मिलती है, तो वह अपने आप होम को दूर पर सेट कर देता है। जब यह मानव उपस्थिति का पता लगाता है, तो यह संरचना को गृह राज्य में वापस कर देता है।

होम/अवे स्थिति में परिवर्तनों पर प्रतिक्रिया करने से आपके उत्पादों के लिए व्यापक अवसर खुलते हैं। उदाहरण के लिए, आपके उत्पाद कर सकते हैं:

  • जब घर ऊर्जा बचाने के लिए दूर में जाता है तो लाइट बंद कर दें
  • घर के दूर होने पर गैरेज का दरवाजा खुला होने पर सूचना भेजें
  • घर के होम में स्विच होने पर संगीत बजाएं

ईटीए कैसे काम करता है

कुछ मामलों में, उपयोगकर्ताओं के पास एक तृतीय-पक्ष ऐप होता है जो नेस्ट एपीआई को अनुमानित आगमन समय (ईटीए) डेटा प्रदान करने के लिए जीपीएस का उपयोग करता है। अन्य मामलों में, उपयोगकर्ता अपने ईटीए को मैन्युअल रूप से दर्ज करने के लिए ऐप का उपयोग कर सकता है। या हो सकता है कि ईटीए की गणना उपयोगकर्ता के नियमित कार्यक्रम के आधार पर की जाती है।

नेस्ट थर्मोस्टेट के साथ एकीकृत ईटीए ऐप्स के कारण थर्मोस्टैट उपयोगकर्ता के आने से पहले घर को गर्म या ठंडा करना शुरू कर देता है।

जब उपयोगकर्ता के खाते में ईटीए/थर्मोस्टेट एकीकरण मौजूद होता है, तो ईटीए डेटा अन्य वर्क्स विद नेस्ट डेवलपर्स के लिए उनके वर्क्स विद नेस्ट एकीकरण में उपयोग करने के लिए उपलब्ध होता है।

ईटीए के नेस्ट सेवा में इनपुट होने के बाद, नेस्ट एकीकरण के साथ एक अन्य वर्क्स इसे उपयोगकर्ता के आगमन के लिए घर तैयार करने के लिए सिग्नल के रूप में उपयोग कर सकता है।

  1. ईटीए लिखने केवल का उपयोग कर एक घोंसला डेवलपर ने लिखा है PUT eta API कॉल
  2. Nest Thermostat इस डेटा का इस्तेमाल करता है।
  3. अन्य डेवलपर्स इसका उपयोग करना चाहते हैं, तो भी, वे रीड-ओनली उपयोग कर सकते हैं GET eta_begin API कॉल
ईटीए डेटा

ध्यान में रखने वाली महत्वपूर्ण बात यह है कि ईटीए डेटा किसी तृतीय पक्ष द्वारा इनपुट किया जाना चाहिए। Nest वर्तमान में ETA डेटा प्रदान नहीं करता है। यदि ETA डेटा नहीं लिखा गया है, तो Nest API डिफ़ॉल्ट "1970-01-01T00:00:00.000Z" मान लौटाता है।

मान लीजिए, उदाहरण के लिए, कि आप एक प्रकाश विक्रेता हैं। आप ईटीए/थर्मोस्टेट एकीकरण द्वारा प्रदान किया गया ईटीए डेटा प्राप्त कर सकते हैं और इसे रोशनी चालू करने के लिए सिग्नल के रूप में उपयोग कर सकते हैं।

इस तरह, न केवल तापमान आरामदायक होता है, बल्कि उपयोगकर्ता के घर आने पर भी रोशनी होती है।

ईटीए स्थिति में बदलाव पर प्रतिक्रिया करने से आपके उत्पादों के लिए व्यापक अवसर खुलते हैं। उदाहरण के लिए, आपके उत्पाद कर सकते हैं:

  • जैसे ही उपयोगकर्ता घर पहुंचता है टीवी चालू करें
  • जब उपयोगकर्ता लगभग घर पर हो तो गैरेज का दरवाजा खोलें
  • जब उपयोगकर्ता घर लौटता है तो संगीत पहले से चल रहा हो

दूर की अनुमति

निम्नलिखित पहुँच अनुमति स्तर के लिए उपलब्ध हैं दूर से संबंधित डेटा मान :



पहुंच

दूर पढ़ें
दूर पढ़ें/लिखें

ईटीए पढ़ें

ईटीए पढ़ें / लिखें

धुआं + सीओ अलार्म पढ़ें
थर्मोस्टेट पढ़ें
थर्मोस्टेट पढ़ें / लिखें
away हाँ हाँ हाँ
eta_begin (रीड ओनली) हाँ हाँ
eta वस्तु (लिखने के लिये) हाँ

अधिक जानकारी के लिए, देखें अनुमतियां अवलोकन

दूर सुविधाएँ

घर और वहां से दूर

away नेस्ट सोचता है कि अगर संरचना कब्जे में है डेटा मान आप बता सकते हैं। संभावित मान हैं:

मूल्य विवरण
home संरचना में कोई है। यह राज्य सेट किया जा सकता है:
• Nest द्वारा यदि उसे मोशन सेंसर डेटा से उच्च विश्वास है
• के माध्यम से उपयोगकर्ता द्वारा Nest ऐप , नेस्ट थर्मोस्टेट, या अपने उत्पाद
• एल्गोरिथम के माध्यम से ETA
away संरचना में कोई नहीं है। उपयोगकर्ता स्पष्ट रूप से दूर करने के लिए संरचना की स्थापना की है, या तो के माध्यम से Nest ऐप , नेस्ट थर्मोस्टेट, या अपने उत्पाद।
unknown कोई डिवाइस संरचना के साथ जुड़े रहे हैं, तो दूर राज्य है unknown

Nest API होम और अवे को सीधे सेट करने की क्षमता प्रदान करता है, साथ ही इन राज्यों में होने वाले परिवर्तनों को भी सुनता है। हालांकि, जब घर की स्थापना और दूर, यह के रूप में किया जाना चाहिए Nest ऐप यह करता है: एक स्पष्ट उपयोगकर्ता अनुरोध के परिणाम के रूप में। एल्गोरिदम रूप से इस राज्य स्थापित करने के लिए कोशिश कर रहा एक भ्रामक उपयोगकर्ता अनुभव बनाने के जोखिम को चलाता है और द्वारा निषिद्ध है नेस्ट डिजाइन नीतियों

जागरूक उपयोगकर्ताओं को हमेशा क्षमता मैन्युअल घर / दूर राज्य स्थापित करने के लिए कर रखी है।

बारे में और जानें कैसे उन होम एंड अवे राज्यों सेट

ईटा

दूर

ईटीए क्षेत्रों एक संरचना पर सेट किया जा सकता है कि के साथ एक वस्तु है। इसका उपयोग नेस्ट को यह बताने के लिए किया जाता है कि उपयोगकर्ता के एक विशिष्ट समय पर घर लौटने की उम्मीद है। जब ईटीए की स्थापना, एक उत्पाद के लिए एक अनूठा उत्पन्न trip_id और आगमन का उम्मीद खिड़की, निम्न मान द्वारा निर्दिष्ट प्रदान करता है:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

क्योंकि ट्रैफ़िक, बदली हुई उपयोगकर्ता योजनाओं और अन्य घटनाओं के कारण यात्राओं के आसपास की परिस्थितियाँ बदल सकती हैं, उत्पादों को समय-समय पर ईटीए अपडेट करना चाहिए क्योंकि यात्रा आगे बढ़ती है, नेस्ट को अनुमानित आगमन समय की एक धारा प्रदान करता है (5 मिनट एक आदर्श अंतराल है)।

हमें जितनी अधिक जानकारी मिलती है, हम ईटीए इनपुट की विश्वसनीयता में उतने ही अधिक आश्वस्त हो सकते हैं, जो हमें घर तैयार करने के लिए कार्रवाई करते समय और अधिक आश्वस्त करता है।

ईटीए गृह राज्य से स्वतंत्र है। यदि किसी ईटीए के आगमन का समय दूसरे ईटीए के साथ विरोध करता है, तो जल्द से जल्द आगमन समय को प्राथमिकता दी जाती है।

ईटीए राइट कॉल करें

ईटीए तर्क संरचना में थर्मोस्टेट की उपस्थिति पर निर्भर है। कोई थर्मोस्टेट संरचना में मौजूद है, ईटीए वस्तु में की गई कॉल के साथ विफल "कोई युग्मित उपकरणों के" त्रुटि संदेश। यह त्रुटि तब भी होती है, जब संरचना में अन्य प्रकार के उपकरण मौजूद होते हैं (उदाहरण के लिए, नेस्ट कैम या नेस्ट प्रोटेक्ट)।

डेटा मान

ETA कॉल के लिए निम्न डेटा मानों की आवश्यकता होती है:

नाम प्रकार विवरण
trip_id तार अद्वितीय ईटीए यात्रा पहचानकर्ता
estimated_arrival_window_begin तार समय-चिह्न
से अधिक होना चाहिए NOW में, 8601 आईएसओ प्रारूप
estimated_arrival_window_end तार समय-चिह्न
से अधिक होना चाहिए estimated_arrival_window_begin में, 8601 आईएसओ प्रारूप

जीपीएस संचार में कनेक्शन छोड़ने की संभावना के कारण, हम नमूने की एक धारा का सुझाव देते हैं, आदर्श रूप से हर 5 मिनट में एक बार।

हर ईटीए कॉल के लिए एक अनूठा शामिल करना चाहिए trip_id स्ट्रिंग है कि आप प्रारंभिक कॉल में परिभाषित करते हैं। अन्य मापदंडों एक ही करने के लिए लगातार कॉल के साथ बदल सकते हैं trip_id

एक ईटीए कॉल सफलता पर 200 ओके एचटीटीपी स्थिति कोड देता है।

उदाहरण

कर्ल
curl --location-trusted -X PUT -d \
  '{"trip_id":"sample-trip-id","estimated_arrival_window_begin":"2014-10-31T22:42:00.000Z","estimated_arrival_window_end":"2014-10-31T23:59:59.000Z"}' \
  "http://developer-api.nest.com/structures/5af48890-b516-11e3-9eff-123139166438/eta.json?auth=c.VG6bfzyOxAltaih6P4v..."

एक ईटीए रद्द करें

एक ईटा रद्द करने के लिए भेज estimated_arrival_window_begin = 0 । जांचें कि आप इस कॉल में एक पूर्णांक (0) भेज रहे हैं, न कि एक स्ट्रिंग ("0"), या कॉल विफल हो जाएगी।

त्रुटि संदेश

API कॉल त्रुटियों क्या मतलब है और उन्हें कैसे संभाल करने के लिए, को देखने के बारे में जानकारी के लिए त्रुटि संदेश