Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

منظم الحراره

التحكم في الترموستات

إن Nest Learning Thermostat ™ عبارة عن جهاز متصل بالإنترنت بديهي وسهل الاستخدام ، ويتعرف باستمرار على أنماط الاستخدام في المنزل لتحسين الراحة وتوفير الطاقة. يمكن للمستخدمين التحكم في التدفئة والتبريد في أي مكان لديهم اتصال بالإنترنت.

يتطلب دعم هذه الميزات نظام تحكم معقدًا يتجاوز البرامج البسيطة القائمة على نقطة محددة. يوفر Nest مجموعة واسعة من الخوارزميات (مثل Early On و True Radiant و Airwave ™ ) التي تتطلب قدرًا كبيرًا من الطاقة الحسابية مقارنة بمعظم منظمات الحرارة. يمتلك Nest Thermostat القدرة اللازمة لتوفير هذه الميزات المتقدمة.

تم تصميم Nest API للسماح للمنتجات بالتحكم في نظام HVAC دون تعطيل خوارزميات Nest أو مفاجأة المستخدم بسلوكيات غير متوقعة. توفر الوصول إلى البيانات التالية لـ Nest Thermostat:

  • اسم الهيكل والجهاز "حيث الاسم" (الموقع في المنزل)
  • تسمية ترموستات مخصصة
  • حالة الاتصال ومعلومات الاتصال الأخيرة
  • درجات الحرارة الحالية والمستهدفة
  • وضع درجة الحرارة
  • درجات الحرارة البيئية
  • الوقت لدرجة الحرارة
  • مقياس درجة الحرارة (مجموعة F / C)
  • حالة قفل درجة الحرارة ، وإذا تم قفلها ، فإن قيم درجة الحرارة القصوى / القصوى المقفلة
  • مدة مؤقت المروحة ووضع التكييف
  • رطوبة
  • كريم واقي شمس

أذونات الحرارة

للوصول للقراءة إلى جميع قيم بيانات Thermostat API ، حدد إذن قراءة Thermostat لعميلك.

للوصول للقراءة إلى جميع قيم بيانات Thermostat API والوصول الإضافي للكتابة لتحديد القيم ، حدد إذن Thermostat للقراءة / الكتابة لعميلك. يسمح لك مستوى الإذن هذا بتحديث ما يلي:

  • درجة الحرارة المستهدفة
  • وضع HVAC
  • مؤقتات المروحة

بدءًا من Thermostat للقراءة / الكتابة الإصدار 5 ، يمكنك أيضًا تحديث ما يلي:

  • مقياس درجة الحرارة
  • تسمية ترموستات

معرّفات الترموستات

جهاز

يتم إدراج أجهزة Nest حسب النوع كمصفوفة من المعرفات ، والتي يمكن استخدامها لتعريف الجهاز بشكل فريد عبر مسار الجهاز. لذا فإن معرّف الترموستات لـ "peyiJNo..." يعني أنه يمكنك تحميل طراز جهاز الترموستات على devices/thermostats/peyiJNo... عبر واجهة برمجة التطبيقات.

عند توصيل جهاز بمنتجات متعددة ، سيرى كل مطور معرفًا مختلفًا لهذا الجهاز. بالنسبة للجهاز الذي قام بتثبيت العديد من المنتجات من نفس المطور ، سيرى المطور نفس المعرّف.

اسم

يتم توفير سمتين اسم. يتم عرض سمة name الأقصر في تسميات واجهة المستخدم ، بينما يتم استخدام name_long في نص طويل.

name

في هذه الأمثلة ، يكون name "Hallway" أو "Hallway (West)".

اسماسم طويل

name_long

في هذا المثال ، name_long هو "Office (Upstairs)".

الاسم طويل في الرسالة

ضع الكلمة المناسبة

أين الاسم (التسمية)
أين الاسم (التسمية)

بدءًا من الإصدار 5 من الأذونات ، يمكنك إضافة تصنيف ترموستات مخصص من خلال واجهة برمجة التطبيقات. في تطبيق Nest ، يظهر التصنيف بين قوسين ، بعد اسم المكان.

بدءًا من الإصدار 6 من الأذونات ، يمكنك أيضًا قراءة تصنيف Thermostat.

أين

where_id

  • معرّف فريد من نوعه يتم إنشاؤه بواسطة Nest يمثل name
  • where_id للقراءة فقط ، ويتم إنشاؤه تلقائيًا في المكالمة لإنشاء name مخصص

تعرف على مزيد من المعلومات حول مكان أسماء Nest Thermostats و Nest Protects و Nest Cams .

where_name

عند اختيار أي من أذونات الترموستات ، يمكنك الوصول إلى الجهاز حيث where_name من كائن الجهاز ( devices/thermostats ).

البيانات الوصفية الأخرى

جميع قيم البيانات للقراءة فقط ، ما لم ينص على خلاف ذلك.

قيمة البيانات وصف
locale اللغة ورمز البلد المخصص لهذا الجهاز
software_version سلسلة تمثل البرامج الثابتة المثبتة حاليًا على الجهاز
structure_id سلسلة تمثل هذه البنية بشكل فريد ؛ هذا هو الهيكل الذي يتم إقران الجهاز به
last_connection الطابع الزمني لآخر اتصال ناجح بخدمة Nest
is_online الموجودين. يتم تحديد ذلك بواسطة Nest باستخدام وقت last_connection ونافذة إعادة الاتصال المتوقعة الخاصة بالجهاز.

ميزات ترموستات

أوضاع الترموستات

تحتوي أنظمة التدفئة والتهوية والتكييف (HVAC) على أربع حالات "تشغيل" ( heat ، cool ، cool heat-cool ، eco ) ، وحالة "إيقاف" واحدة ( off ). نستخدم هذه الحالات لإدارة الراحة وتوفير الطاقة من خلال hvac_mode وقيم بيانات درجة الحرارة.

  • عند تحديد وضع التدفئة أو التبريد ( heat ، cool ) ، يقوم منظم الحرارة بضبط المنزل على درجة الحرارة المستهدفة.
  • عند اختيار وضع heat-cool • التبريد ( heat-cool ) ، سيحافظ الترموستات على راحة المنزل ، ضمن نطاق درجة حرارة مفضل.
  • عند اختيار درجات الحرارة البيئية (eco) ، سيطبق جهاز الترموستات خوارزميات موفرة للطاقة للحفاظ على راحة المنزل وتقليل استخدام الطاقة. ترموستات في هذا الوضع تعرض ECO.

الهياكل لها حالتان تتعلقان بالوجود: المنزل أو بالخارج. عندما لا يتم استشعار أي حركة في المنزل ، سيتغير الهيكل من المنزل إلى الخارج ، وسيتيح الترموستات في المنزل تمكين درجات الحرارة البيئية تلقائيًا.

كيف تعمل قيم hvac_mode ودرجة الحرارة معًا

اعتمادًا على قيمة hvac_mode ، يمكن الوصول إلى قيم معينة فقط لبيانات درجة الحرارة في واجهة برمجة التطبيقات:

وضع HVAC قيم بيانات درجة الحرارة التي يمكنك الوصول إليها
heat أو cool target_temperature_f أو target_temperature_c
heat-cool target_temperature_low_f و target_temperature_high_f
أو
target_temperature_low_c و target_temperature_high_c
eco eco_temperature_low_f و eco_temperature_high_f
أو
eco_temperature_low_c و eco_temperature_high_c
off لا شيء

في بعض السيناريوهات ، هناك قواعد خاصة حول تغيير hvac_mode :

سيناريو هل يمكن تغيير hvac_mode ؟
تم تمكين قفل درجة الحرارة نعم
إغلاق الطوارئ نشط لا
تم تمكين حرارة الطوارئ لا
can_cool أو can_heat قيمة غير false لا

درجات الحرارة البيئية

تسمح درجات الحرارة البيئية للمستخدم بتوفير الطاقة ، سواء كان في المنزل أم لا. ضع في اعتبارك تبديل hvac_mode إلى eco عند تنفيذ السلوكيات الموفرة للطاقة في منتجك.

تتوفر نقاط نهاية Eco Eco في واجهة برمجة تطبيقات Nest بدءًا بأذونات Thermostat للقراءة والقراءة / الكتابة الإصدار 6.

التبديل بين الوضعين الاقتصادي وغير البيئي

يجب ألا يحتاج منتجك لإدارة درجات الحرارة المستهدفة مباشرة في الوضع الاقتصادي. عندما يتم ضبط المنزل على مكان بعيد ، لا يتم عرض درجة الحرارة المستهدفة ، ولكن يتم ضبطها داخليًا ، بناءً على اختيار المستخدم. عند ضبط الترموستات على وضع إيقاف التشغيل ، فلن تتم ملاحظة أي درجات حرارة مستهدفة.

إذا كان يجب عليك مطلقًا تغيير درجات الحرارة المستهدفة مباشرةً ، فتأكد من إجراء التغيير في مكالمتين منفصلتين:

  1. قم بتغيير hvac_mode إلى أي قيمة أخرى باستثناء eco
  2. قم بتعديل قيم بيانات target_temperature المناسبة

بدءًا من أذونات Thermostat للقراءة والقراءة / الكتابة الإصدار 6 ، يمكنك الوصول إلى previous_hvac_mode خلال واجهة برمجة التطبيقات للمساعدة في انتقالات وضع HVAC. يُستخدَم previous_hvac_mode لتخزين hvac_mode للجهاز قبل أن ينتقل إلى "eco".

على سبيل المثال ، إذا كان Nest Thermostat يستخدم درجات حرارة Eco ( hvac_mode = "eco" ) ، target_temperature وضع target_temperature previous_hvac_mode متاحًا ، وتريد أن يقوم منتجك بتعيين target_temperature ، فيجب عليك أولاً:

  1. الحصول على الوضع previous_hvac_mode
  2. قم بتعيين hvac_mode إلى قيمة previous_hvac_mode
  3. تأكيد لم يعد hvac_mode مضبوطًا على "eco"

بعد هذه الخطوات ، قم بتعيين درجات الحرارة المستهدفة حسب الاقتضاء.

بناءً على قيمة hvac_mode ، هذه هي الطريقة previous_hvac_mode يتغير بها الوضع previous_hvac_mode :

عندما hvac_mode حالة hvac_mode ... ثم، previous_hvac_mode يمكن أن يكون ...
eco heat ، cool ، heat-cool أو off
heat ، cool ، heat-cool أو off فارغ / فارغ

درجة الحرارة المستهدفة

درجة الحرارة المستهدفة هي أهم قيمة لنظام التدفئة والتهوية وتكييف الهواء - إنها درجة الحرارة المرغوبة ، التي يحددها المستخدم عادةً. تستند معظم الإجراءات والقرارات على ذلك. من API ، يمكن لـ Works with Nest كتابة درجة الحرارة المستهدفة كجزء من عملية أكبر.

هناك دائمًا درجة حرارة مستهدفة عند تشغيل النظام.

  • عند تحديد وضع heat أو cool ( heat ، cool ) ، يتم تعيين target_temperature
  • عند تحديد وضع التبريد • وضع heat-cool ( heat-cool ) ، يتم تعيين قيمتين target_temperature المستهدفة ، تدل على نطاق مستهدف ، نطاق أعلى للتبريد وآخر أقل للتدفئة
  • عند تحديد الوضع الاقتصادي ( eco ) ، يتم تعيين نطاق درجة الحرارة المستهدفة داخليًا

هناك أيضًا درجات حرارة آمنة تكون بمثابة دعامة لمنع تجمد الأنابيب أو درجات الحرارة المرتفعة بشكل مفرط في المنزل.

عند إيقاف تشغيل الترموستات ، لا يتم تعيين درجات حرارة مستهدفة.

الوقت لدرجة الحرارة

يمنحك الوقت إلى درجة الحرارة الوصول إلى قيم البيانات هذه لنظام HVAC:

  • time_to_target - الوقت بالدقائق الذي يستغرقه الهيكل للوصول إلى درجة الحرارة المستهدفة
  • time_to_target_training
    • حالة التدريب
    • بينما يتعلم الترموستات كيف يستجيب نظام التدفئة والتهوية وتكييف الهواء ، فإنه يعدل تقدير الوصول إلى درجة الحرارة المستهدفة
    • عندما يكون الترموستات متأكدًا بشكل معقول من تقدير الوقت للوصول إلى درجة الحرارة المستهدفة ، ستتغير الحالة من training إلى ready

درجة الحرارة المحيطة

تم قياس درجة الحرارة بالقرب من منظم الحرارة. اعرض القيمة التي تتوافق مع مقياس درجة الحرارة المفضل للمستخدم.

مقياس درجة الحرارة

يتم تنظيم متغيرات درجة الحرارة المحيطة والهدف بواسطة مقياس مئوية أو فهرنهايت. ستكون السمة temperature_scale إما "F" أو "C" ، حسب تفضيل المستخدم. يتم تعيين هذه الخاصية بواسطة كل ترموستات ، لذلك من الممكن أنه في هيكل واحد ، قد يكون لدى المستخدم ترموستاتين ، واحد في كل مقياس درجة حرارة. ضع في الاعتبار تفضيلات المستخدم عند عرض قيم درجة الحرارة.

بدءًا من الإصدار 5 من الأذونات ، يمكنك تغيير مقياس درجة الحرارة من خلال واجهة برمجة التطبيقات.

الهدف والمحيط الحقول درجة الحرارة لها _f و _c المتغيرات لاستيعاب التقريب ثابت عند عرض درجات الحرارة.

عرض درجة الحرارة

منظم الحراره

عند عرض معلومات درجة حرارة الهدف ، ضع في اعتبارك القيم الثلاث التالية: temperature_scale و hvac_mode وحالة away البنية.

تعمل العديد من قيم البيانات معًا لتحديد ما هو معروض على شاشة Nest Thermostat وكيفية تصرفها.

  • عندما يتم ضبط hvac_mode على heat-cool ، يعرض Nest Thermostat hvac_mode المنخفضة والعالية مفصولة برمز نقطي (•) ، وإلا فإن Nest Thermostat يعرض فقط درجة الحرارة المستهدفة
  • عند hvac_mode على وضع off ، يتم عرض كلمة "إيقاف" في Nest Thermostat باللغة المفضلة للمستخدم
  • عند hvac_mode على eco ، يتم عرض كلمة "ECO" على Nest Thermostat باللغة المفضلة للمستخدم

يعتمد تنسيق درجة حرارة العرض أيضًا على مقياس درجة الحرارة المحدد (F / C).

يتم عرض درجات حرارة فهرنهايت كأرقام صحيحة:

  • درجة الحرارة المستهدفة: 55 درجة فهرنهايت
  • درجة الحرارة المحيطة: 62 درجة فهرنهايت

يتم عرض درجات الحرارة المئوية كرقم صحيح أو قيمة عشرية ، مع تعيين الرقم الأخير على ".5":

  • درجة الحرارة المستهدفة: 12 درجة مئوية
  • درجة الحرارة المحيطة: 16.5 درجة مئوية

ورقة الشجر

عندما تظهر أيقونة الورقة في مقدمة الترموستات ، يتم ضبط الترموستات على درجة حرارة موفرة للطاقة ، و has_leaf = true .

ورقة الشجر

قفل درجة الحرارة

يمكن للمستخدمين قفل Nest Thermostat بحيث لا يمكن ضبطه إلا في نطاق درجة حرارة محدودة. بدءًا من الإصدار 5 من الأذونات ، يمكنك معرفة ما إذا تم تمكين قفل درجة الحرارة عن طريق التحقق من وضع is_locked ، وإذا كان كذلك ، يمكنك قراءة قيم الحد الأدنى / الأقصى لقفل درجة الحرارة من خلال واجهة برمجة التطبيقات:

يجب تحديد درجات حرارة القفل في أزواج ، is_locked ، ولا يمكن كتابتها إلا إذا كانت is_locked = true .

رطوبة

يتم قياس الرطوبة ، في شكل نسبة مئوية (٪) عند الجهاز ، إلى أقرب 5٪.

كريم واقي شمس

تقوم تقنية Sunblock تلقائيًا بضبط درجة الحرارة على Nest Thermostat لتعويض ارتفاعات الحرارة التي تحدث من أشعة الشمس المباشرة على الوحدة.

ستخبرك قيم البيانات هذه إذا تم تمكين Sunblock و / أو تصحيح درجة الحرارة بنشاط.

  • sunlight_correction_enabled
    • منطقية ، ترجع true إذا تم تمكين Sunblock
  • sunlight_correction_active - قيمة منطقية ، ترجع true إذا كان Sunblock نشطًا ، مشيرة إلى أن منظم الحرارة يقع في ضوء الشمس المباشر

معجب

تحتوي العديد من أنظمة التدفئة والتهوية وتكييف الهواء على مراوح مدمجة ، مما يعني أنه لا يمكن التحكم في المروحة بشكل مستقل . لا يوجد وضع إيقاف تشغيل للمراوح المدمجة ، لأن المروحة تحتاج إلى التشغيل عند تشغيل التدفئة أو التبريد.

ومع ذلك ، إذا كان نظام التدفئة والتهوية وتكييف الهواء (HVAC) متوافقًا ، فيمكن تشغيل المروحة بشكل صريح عبر واجهة برمجة التطبيقات ، من أجل جعل شاغليها أكثر راحة ، دون إشراك نظام HVAC الكامل.

إذا كان من الممكن التحكم في المروحة بشكل مستقل ، فسيتم تعيين has_fan على true ، ويمكن تعيين قيم البيانات التالية باستخدام أذونات القراءة / الكتابة Thermostat:

  • fan_timer_active - قيمة منطقية ، تُرجع true إذا تم تشغيل مؤقت المروحة لمدة مبرمجة مسبقًا
  • fan_timer_duration - int ، طول الفترة الزمنية (بالدقائق) التي تم ضبط المروحة على تشغيلها

استخدم هذه القيم معًا لبدء مؤقت المروحة (قم بتشغيل المروحة) لفترة زمنية محددة. يمكنك أيضًا استخدام قيمة fan_timer_timeout لتحديد الطابع الزمني لتعيين المروحة على إيقاف التشغيل.

لاحظ أنه يمكنك دائمًا تغيير fan_timer_duration - فهي مستقلة عن hvac_mode أو حالة شغل الهيكل (بعيدًا).

يمكنك توقع هذه الردود على النجاح أو الفشل:

  • 200 حسنا
  • 400 طلب سىء

إذا لم ينتج عن الأمر تشغيل المروحة النتيجة المتوقعة ، فقد يرجع ذلك إلى أن المروحة مشغولة بالفعل (إما يدويًا من قبل المستخدم ، أو وفقًا لجدول زمني ، أو بسبب حرارة / دورة تبريد HVAC).

تحديد المعدل

نطبق تحديد المعدل للحماية من المكالمات الزائدة للأجهزة ، مما قد يؤثر على أداء النظام أو البطارية. في الظروف العادية ، تقوم أجهزة Nest بشحن البطارية من أسلاك الجهد المنخفض في نظام التدفئة والتبريد. ولكن إذا تم إجراء مكالمات زائدة في فترة زمنية قصيرة وانخفض مستوى البطارية ، فسيقوم Nest Thermostat بإيقاف تشغيل Wi-Fi للحفاظ على الطاقة.

من الناحية العملية ، هذا يعني أننا نقصر عدد المكالمات التي يمكن إجراؤها على جهاز خلال فترة زمنية محددة. إذا تجاوزت هذا الحد ، فستتلقى استجابة خطأ ورسالة تشير إلى أنك تجاوزت حدك.

لمزيد من المعلومات ، راجع حدود معدل البيانات .

قيود الطاقة

في بعض الحالات ، قد لا يمتلك الترموستات طاقة بطارية كافية لخدمة طلب تعديل. في هذه الحالة ، ستتلقى استجابة خطأ ورسالة تشير إلى أن الجهاز لا يمكنه خدمة الطلب في الوقت الحالي. إذا حدث ذلك ، امنح البطارية بعض الوقت لإعادة الشحن قبل إعادة المحاولة.

تعرّف على مزيد من المعلومات حول ظروف انخفاض طاقة البطارية في Nest Learning Thermostat .

رسائل خاطئة

بعض الدول تجعل وظائف معينة غير متوفرة. هذه القواعد موجودة للحفاظ على الطاقة أو توفير الراحة والأمان.

للحصول على معلومات حول معنى أخطاء مكالمات API وكيفية معالجتها ، راجع رسائل الخطأ .

مشكلة اتصال Wi-Fi /

إذا كان الجهاز غير متصل بالإنترنت ، فلا يُسمح بإجراء تعديلات. يمكنك ملاحظة حالة الاتصال بالإنترنت للجهاز في نموذج البيانات وعرض واجهة المستخدم بشكل مناسب.