دور & amp؛ ETA

در API Nest ، مفهوم "خانه" یا "Away" تأثیر قدرتمندی در رفتارهای پس انداز انرژی و ویژگی های راحتی لانه دارد.

چگونه خانه و دوری کار می کند

Nest با استفاده از انواع مختلفی از سیگنال ها ، حضور انسان را در یک خانه تشخیص می دهد. اگر Nest برای مدت طولانی عدم حضور را تشخیص دهد ، به طور خودکار خانه را از بین می برد. هنگامی که حضور انسان را تشخیص می دهد ، ساختار را به حالت Home باز می گرداند.

واکنش به تغییر در وضعیت Home / Away طیف گسترده ای از فرصت ها را برای محصولات شما باز می کند. به عنوان مثال ، محصولات شما می توانند:

• برای صرفه جویی در مصرف انرژی ، چراغ را خاموش کنید
• در صورت باز بودن درب خانه ، درب گاراژ هشدار دهید
• هنگام تغییر خانه به Home ، موسیقی پخش کنید

نحوه کار ETA

در بعضی موارد ، کاربران یک برنامه شخص ثالث دارند که از GPS برای ارائه زمان تخمینی ورود (ETA) داده ها به API Nest استفاده می کند. در موارد دیگر ، کاربر ممکن است از یک برنامه برای ورود دستی ETA خود استفاده کند. یا شاید ETA براساس برنامه منظم کاربر محاسبه شود.

برنامه های ETA که با Nest Thermostat یکپارچه شده اند باعث می شود که ترموستات قبل از رسیدن کاربر ، گرم کردن یا خنک کردن خانه را آغاز کند.

هنگامی که ETA / ترموستات ادغام در حساب کاربر وجود داشته باشد ، داده های ETA برای سایر آثار با توسعه دهندگان Nest برای استفاده در آثارشان با ادغام های Nest در دسترس است.

پس از ورود ETA به سرویس Nest ، کارهای دیگری با ادغام Nest می توانند از آن به عنوان سیگنال برای تهیه خانه برای ورود کاربر استفاده کنند.

1. ETA توسط یک توسعه دهنده Nest با استفاده از تماس فقط PUT eta API نوشته شده است .
2. Nest Termostat از این داده ها استفاده می کند.
3. اگر سایر توسعه دهندگان مایل به استفاده از آن هستند ، می توانند از تماس API فقط GET eta_begin استفاده کنند .

نکته مهمی که باید در نظر داشته باشید این است که داده های ETA باید توسط شخص ثالث وارد شوند. Nest در حال حاضر داده های ETA را ارائه نمی دهد. اگر داده های ETA نوشته نشده باشد ، Nest API مقدار پیش فرض "1970-01-01T00: 00: 00.000Z" را برمی گرداند.

مثلاً فرض کنید که شما یک فروشنده روشنایی هستید. می توانید داده های ETA تهیه شده توسط ETA / ترموستات ادغام شده را دریافت کنید و از آن به عنوان سیگنال برای روشن کردن چراغ ها استفاده کنید.

به این ترتیب نه تنها دمای هوا راحت است بلکه هنگام ورود کاربر به خانه ، چراغ ها نیز روشن می شوند.

واکنش به تغییر در وضعیت ETA طیف گسترده ای از فرصت ها را برای محصولات شما باز می کند. به عنوان مثال ، محصولات شما می توانند:

• با نزدیک شدن کاربر به خانه ، تلویزیون را روشن کنید
• هنگامی که کاربر تقریباً در خانه است ، درب گاراژ را باز کنید
• هنگام بازگشت کاربر به خانه ، از قبل موسیقی پخش کنید

مجوزهای دور

سطوح اجازه دسترسی زیر برای مقادیر داده های مربوط به Away در دسترس هستند :

برای اطلاعات بیشتر ، به اجمالی مجوزها مراجعه کنید.

ویژگی های دور

خانه و دور

اگر داده فکر می کند ساختار اشغال شده است ، مقدار داده های away می تواند به شما بگوید. مقادیر ممکن عبارتند از:

Nest API امکان تنظیم مستقیم Home و Away و همچنین گوش دادن به تغییرات در این حالت ها را فراهم می کند. با این حال ، هنگام تنظیم Home و Away ، باید همانطور که برنامه Nest انجام می دهد انجام شود: در نتیجه یک درخواست صریح کاربر. تلاش برای تنظیم الگوریتمی این حالت ، خطر ایجاد تجربه کاربر گیج کننده را به همراه دارد و با خط مشی های طراحی Nest ممنوع است.

توجه داشته باشید که کاربران همیشه توانایی تنظیم دستی حالت Home / Away را دارند.

در مورد چگونگی تنظیم وضعیت "صفحه اصلی و دور" اطلاعات بیشتری کسب کنید.

ETA

ETA یک شی با زمینه هایی است که می توانند روی یک ساختار تنظیم شوند. این مورد برای آگاه سازی Nest است که انتظار می رود کاربر در زمان مشخصی به خانه برگردد. هنگام تنظیم ETA ، یک محصول یک trip_id منحصر به فرد trip_id می کند و یک پنجره مورد انتظار برای ورود ، فراهم می کند که با مقادیر زیر مشخص شده است:

• estimated_arrival_window_begin
• estimated_arrival_window_end

از آنجا که شرایط در سفر ممکن است به دلیل ترافیک ، برنامه های تغییر یافته کاربر و سایر رویدادها تغییر کند ، محصولات باید ETA را به طور دوره ای با پیشرفت سفر به روز کنند ، و یک جریان از زمان ورود تخمین زده شده را به Nest (5 دقیقه یک فاصله ایده آل) ارائه دهید.

هرچه اطلاعات بیشتری دریافت کنیم اطمینان بیشتری به اطمینان از ورودی های ETA خواهیم داشت و همین امر باعث می شود در هنگام اقدام برای تهیه خانه اطمینان بیشتری به دست آوریم.

ETA مستقل از کشور وطن است. اگر زمان ورود ETA با ETA دیگر مغایرت داشته باشد ، زودترین زمان ورود تقدم دارد.

تماس تلفنی با ETA برقرار کنید

منطق ETA به حضور ترموستات در ساختار بستگی دارد. اگر ترموستات در سازه وجود نداشته باشد ، تماس های ارسالی به شیء ETA با پیام خطایی "بدون دستگاه های زوجی" انجام نمی شوند . این خطا حتی در صورت وجود انواع دیگر دستگاه ها در ساختار (به عنوان مثال ، Nest Cam یا Nest Protect) رخ می دهد.

مقادیر داده

تماس ETA به مقادیر داده زیر نیاز دارد:

به دلیل امکان قطع ارتباط در ارتباطات GPS ، ما یک نمونه از نمونه ها را به طور ایده آل هر 5 دقیقه یک بار پیشنهاد می کنیم.

هر تماس ETA باید شامل یک رشته trip_id منحصر به فرد باشد که شما در تماس اولیه تعریف می کنید. پارامترهای دیگر با تماس های پی در پی به همان trip_id می توانند تغییر trip_id .

تماس ETA موفقیت 20000 کد HTTP HTTP را برمی گرداند.

مثال ها

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..."

ETA را لغو کنید

برای لغو یک eta ، ارزیابی_arrival_window_begin estimated_arrival_window_begin = 0 . بررسی کنید که در این تماس یک عدد صحیح (0) ارسال می کنید ، نه یک رشته ("0") یا اینکه تماس قطع نمی شود.

پیغام خطا

برای اطلاعات در مورد معنی خطاهای تماس API و نحوه رسیدگی به آنها ، به پیامهای خطا مراجعه کنید.