ساختار

سازه های

ساختارهای آشیانه نشان دهنده ساختارهای فیزیکی در دنیای واقعی هستند. معمولاً خانه کاربر، آنها به عنوان یک نقطه سازماندهی برای دستگاه ها عمل می کنند و داده هایی را ذخیره می کنند که برای کل خانه اعمال می شود.

Nest API بسته به سطح مجوزهای داده شده، دسترسی به داده‌های سطح ساختار زیر را فراهم می‌کند:

  • نام ساختار و دستگاه "where name" (مکان در خانه)
  • لیست دستگاه های موجود در خانه
  • وضعیت رویداد انرژی ( ساعت شلوغی انرژی )
  • حالت دور
  • ETA کاربر
  • حالت امنیتی
  • کد پستی یا پستی

برخی از ویژگی‌های سطح ساختار در راهنمای API جداگانه و دقیق‌تری پوشش داده شده‌اند:

مجوزهای ساختار

برای دسترسی به ... انتخاب کنید...
بیشتر مقادیر داده در structures شیء هستند مجوزهای Away ، ETA ، Energy ، یا کد پستی
مقدار داده name در شی structures اجازه خواندن/نوشتن ساختار

نحوه عملکرد مجوزها در مرجع API تعاملی را ببینید.

شناسه های ساختار

نام

نام ساختار پیش‌فرض روی «Home» است، اما می‌تواند هر رشته‌ای باشد که کاربر انتخاب می‌کند. وقتی مجوز خواندن/نوشتن ساختار را انتخاب می‌کنید، می‌توانید name ساختار را تغییر دهید.

کجاها

wheres یک شی مجموعه روی یک ساختار است که حاوی شناسه‌های Where ( where_id و name ) است. از wheres یا دسترسی به نام های استاندارد Where استفاده کنید.

دسترسی به جسم wheres به مجوزهای دوربین ، زنگ دود+CO یا ترموستات نیاز دارد.

where_id

  • یک شناسه منحصربه‌فرد ایجاد شده توسط Nest که نشان‌دهنده name
  • where_id فقط خواندنی است و به طور خودکار در تماس ایجاد می‌شود تا یک مکان سفارشی ایجاد name

name

  • نام نمایشی دستگاه؛ می‌تواند هر نام اتاقی از فهرستی که ارائه می‌کنیم، یا نام سفارشی باشد
  • برای ایجاد یک name جا سفارشی، یک فراخوانی POST برای نوشتن یک name سفارشی Where انجام دهید. where_id در تماس برگردانده می شود
  • ملاحظات
    • name را نمی توان پس از ایجاد ویرایش یا حذف کرد
    • name باید در ساختار منحصر به فرد باشد
    • اگر دستگاهی با یک ساختار جفت شده باشد، name سفارشی مرتبط با دستگاه از مسیر /structures/ قابل دسترسی است.
    • برای انتقال یک دستگاه با یک name سفارشی به ساختاری دیگر، دستگاه را لغو جفت کنید و سپس دستگاه را با نام دلخواه دوباره جفت کنید.

درباره نام‌های Nest Thermostats ، Nest Protects و Nest Cams بیشتر بیاموزید.

سایر ابرداده ها

همه مقادیر داده فقط خواندنی هستند، مگر اینکه خلاف آن مشخص شده باشد.

ارزش داده شرح
structure_id رشته ای که به طور منحصر به فرد این ساختار را نشان می دهد. هر توسعه‌دهنده‌ای یک شناسه متفاوت برای یک ساختار می‌بیند، اما چندین محصول از یک توسعه‌دهنده همان شناسه را خواهند دید
country_code یک کد کشور ISO 3166-1 آلفا-2 که به مکان ثبت شده سازه نقشه می‌دهد
postal_code کد پستی یا پستی بسته به کشور
time_zone یک رشته منطقه زمانی IANA که به منطقه زمانی سازه نگاشت می شود

ویژگی های ساختار

هشدار دود و CO

وقتی مجوز خواندن Smoke+CO را انتخاب می‌کنید، می‌توانید به smoke_alarm_state و co_alarm_state در شی structures دسترسی داشته باشید. همین مقادیر داده در شیء دستگاه نیز موجود است ( devices/smoke_co_alarms ).

برای اطلاعات بیشتر در مورد این حالت ها راهنمای هشدار دود + CO را ببینید.

بسیاری از مقادیر داده با هم کار می کنند تا نحوه عملکرد دستگاه ها در یک ساختار را تعیین کنند.

  • هنگامی که یک حالت away away می شود، کلمه "ECO" در Nest Thermostat به زبان دلخواه کاربر نمایش داده می شود.
  • هنگامی که یک حالت دور از ساختار روی away تنظیم می away ، می توانید:
    • fan_timer_active را تنظیم کنید
    • target_temperature_f یا target_temperature_c را تغییر دهید
  • وقتی یک حالت away ساختار روی home تنظیم می شود، می توانید:
    • برقراری تماس ETA (تنظیم شناسه سفر و پنجره ورود)
  • وقتی خاموشی اضطراری فعال است، نمی‌توانید fan_timer_active را تنظیم کنید
  • وقتی گرمای اضطراری فعال است، نمی‌توانید ساختار را روی away تنظیم کنید

ساختارهای متعدد

ممکن است یک کاربر بیش از یک ساختار متصل به حساب Nest خود داشته باشد، بنابراین محصول شما باید ابزاری را برای کاربر ارائه دهد تا از بین ساختارهای موجود انتخاب کند (یک انتخابگر ساختار).

انتخابگر ساختار

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

بیاموزید که کاربران چگونه دستگاه ها را در چندین ساختار مدیریت می کنند .

حداکثر دستگاه

محدودیت‌هایی برای تعداد دستگاه‌هایی که Nest در یک ساختار پشتیبانی می‌کند وجود دارد.

نوع وسیله حداکثر در هر ساختار
Nest Thermostat 20
دوربین های Nest 10
Nest Protect 18

پیغام خطا

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