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

دور و هم زمان

دور

در Nest API ، مفهوم "Home" یا "Away" تأثیر مهمی در رفتارهای صرفه جویی در انرژی و ویژگی های راحتی Nest دارد.

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

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

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

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

نحوه کار ETA

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

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

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

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

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

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

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

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

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

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

مجوزهای دور

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



دسترسی

دور بخون
دور بخوانید / بنویسید

ETA خوانده شده است

ETA خواندن / نوشتن

دود + دزدگیر CO خوانده شده است
ترموستات را خواند
ترموستات بخوانید / بنویسید
away آره آره آره
eta_begin (فقط خواندنی) آره آره
eta شی (نوشتن تنها) آره

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

ویژگی های دور

خانه و دور

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

مقدار شرح
home شخصی در ساختار وجود دارد. این حالت را می توان تنظیم کرد:
• اگر Nest اطمینان بالایی از داده های حسگر حرکت داشته باشد
• توسط کاربر از طریق برنامه Nest ، ترموستات آشیانه، و یا محصول خود را
• به صورت الگوریتمی از طریق ETA
away هیچ کس در ساختار وجود ندارد. کاربر با صراحت ساختار به مجموعه ای دور، یا از طریق برنامه Nest ، ترموستات آشیانه، و یا محصول خود را.
unknown اگر هیچ دستگاه ها با ساختار مرتبط باشد، دولت دور است unknown .

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

آگاه باشید که کاربران همیشه توانایی به صورت دستی تنظیم / دولت به دور خانه است.

اطلاعات بیشتر در مورد چگونه کاربران مجموعه خانه و کشورهای دور .

ETA

دور

ETA یک شی با زمینه های است که می تواند بر روی یک ساختار تنظیم است. این مورد برای آگاهی دادن به Nest استفاده می شود که انتظار می رود کاربری در ساعت مشخصی به خانه خود برگردد. هنگام تنظیم زمان رسیدن به مقصد، یک محصول منحصر به فرد تولید 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 به مقادیر داده زیر احتیاج دارد:

نام نوع شرح
trip_id رشته شناسه منحصر به فرد سفر ETA
estimated_arrival_window_begin رشته مهر زمان
باید بیشتر از باشد NOW ، در ISO 8601 فرمت
estimated_arrival_window_end رشته مهر زمان
باید بیشتر از باشد estimated_arrival_window_begin ، در ISO 8601 فرمت

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

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

یک تماس ETA با موفقیت 200 وضعیت کد 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

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

پیغام خطا

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