مخطط ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

تنتمي هذه السمة إلى أنواع أجهزة THERMOSTAT التي تتيح ضبط درجة الحرارة المستهدَفة ونطاق درجة الحرارة.

الحقول

الحقل الوصف نوع البيانات
heatCelsius درجة الحرارة المُثلى بالدرجة المئوية لوضعي التدفئة (HEAT) والتدفئة والتبريد (HEATCOOL) في الترموستات number
Example: 20.0
coolCelsius درجة الحرارة المُثلى بالدرجة المئوية لوضعي التبريد (COOL) والتدفئة والتبريد (HEATCOOL) في الترموستات number
Example: 22.0

نموذج لطلب استرداد بيانات باستخدام GET وردّ - التدفئة (HEAT)

طلب

GET /enterprises/project-id/devices/device-id

الردّ

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

نموذج لطلب استرداد بيانات باستخدام GET وردّ - التبريد (COOL)

طلب

GET /enterprises/project-id/devices/device-id

الردّ

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

نموذج لطلب استرداد بيانات باستخدام GET وردّ - التدفئة والتبريد (HEATCOOL)

طلب

GET /enterprises/project-id/devices/device-id

الردّ

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

الطلبات الصوتية

يجب أن يكون الترموستات في الوضع الذي يتطابق مع الأمر الذي يتم استدعاؤه قبل تغيير نقاط ضبط درجة الحرارة. يختلف الأمر والحقول اللازمة لتغيير نقاط الضبط حسب وضع الترموستات.

على سبيل المثال، لإصدار الأمر SetHeat ، يجب أولاً ضبط الترموستات على وضع التدفئة (HEAT):

الوضع الأمر الحقول
التدفئة (HEAT) SetHeat heatCelsius
COOL SetCool coolCelsius
التدفئة والتبريد (HEATCOOL) SetRange heatCelsius وcoolCelsius

يُرجى العِلم أنّ أوامر نقاط الضبط لا تقبل إلا الدرجات المئوية كمعلَمة، على الرغم من أنّ Google Nest Thermostat يمكنه عرض درجة الحرارة بالدرجات المئوية أو الفهرنهايتية.

SetHeat

يضبط درجة الحرارة المُثلى عندما يكون الترموستات في وضع التدفئة (HEAT).

طلب SetHeat والردّ

طلب

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat",
  "params" : {
    "heatCelsius" : 22.0
  }
}

الردّ

{}

حقول طلب SetHeat

الحقل الوصف نوع البيانات
heatCelsius درجة الحرارة المُثلى التي سيتم ضبطها عندما يكون الترموستات في وضع التدفئة (HEAT) number
Example: 22.0

SetCool

يضبط درجة الحرارة المُثلى عندما يكون الترموستات في وضع التبريد (COOL).

طلب SetCool والردّ

طلب

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool",
  "params" : {
    "coolCelsius" : 20.0
  }
}

الردّ

{}

حقول طلب SetCool

الحقل الوصف نوع البيانات
coolCelsius درجة الحرارة المُثلى التي سيتم ضبطها عندما يكون الترموستات في وضع التبريد (COOL) number
Example: 20.0

SetRange

يضبط الحد الأدنى والأقصى لدرجات الحرارة عندما يكون الترموستات في وضع التدفئة والتبريد (HEATCOOL).

طلب SetRange والردّ

طلب

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange",
  "params" : {
    "heatCelsius" : 20.0,
    "coolCelsius" : 22.0
  }
}

الردّ

{}

حقول طلب SetRange

الحقل الوصف نوع البيانات
heatCelsius الحد الأدنى لدرجة الحرارة المُثلى التي سيتم ضبطها عندما يكون الترموستات في وضع التدفئة والتبريد (HEATCOOL) number
Example: 20.0
coolCelsius الحد الأقصى لدرجة الحرارة المُثلى التي سيتم ضبطها عندما يكون الترموستات في وضع التدفئة والتبريد (HEATCOOL) number
Example: 22.0

الأخطاء

قد يتم عرض رموز الخطأ التالية فيما يتعلق بهذه السمة:

رسالة الخطأ متوسط عائد النقرة تحديد المشاكل وحلّها
لا يُسمح بهذا الأمر في وضع الترموستات الحالي. FAILED_PRECONDITION لا تتيح بعض طُرز الترموستات تغيير وضع "درجات حرارة اقتصادية" عندما يكون وضع الترموستات "إيقاف"، وفقًا لسمة ThermostatMode . يجب تغيير وضع الترموستات إلى "تدفئة" (HEAT) أو "تبريد" (COOL) أو "تدفئة وتبريد" (HEATCOOL) قبل تغيير وضع "درجات حرارة اقتصادية".
يجب أن تكون قيمة التبريد أكبر من قيمة التدفئة. INVALID_ARGUMENT تأكَّد من أنّ حقل heatCelsius أقل من حقل coolCelsius في طلبك.
لا يُسمح بهذا الأمر عندما يكون الترموستات في وضع "درجات حرارة اقتصادية" اليدوي. FAILED_PRECONDITION لا يمكن ضبط نقطة ضبط درجة الحرارة عندما يكون الترموستات في وضع "درجات حرارة اقتصادية" اليدوي.

يمكنك الاطّلاع على مرجع رموز الخطأ في واجهة برمجة التطبيقات للحصول على القائمة الكاملة بهذه الرموز.