סכימה של Thermostat ThermostatSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

התכונה הזו שייכת לסוגי המכשירים של תרמוסטט שתומכים בהגדרה של טמפרטורת יעד וטווח טמפרטורות.

שדות

שדה תיאור סוג הנתונים
heatCelsius טמפרטורת יעד בצלזיוס למצבי חימום ו-HEATCOOL של התרמוסטט. number
דוגמה: 20.0
coolCelsius טמפרטורת יעד בצלזיוס למצבי COOL ו-HEATCOOL של התרמוסטט. number
דוגמה: 22.0

בקשה ותגובה לדוגמה של GET – חימום

בקשה

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 הפקודה, התרמוסטט חייב להיות במצב חימום קודם:

מצב פקודה שדות
חום SetHeat heatCelsius
מגניב SetCool coolCelsius
חימום SetRange heatCelsius, coolCelsius

שימו לב שפקודות setpoint משתמשות רק במעלות בצלזיוס כפרמטר, Google Nest Thermostat יכול להציג טמפרטורה במעלות צלזיוס או פרנהייט.

SetHeat

המדיניות הזו מגדירה את טמפרטורת היעד כשהתרמוסטט במצב חימום.

בקשת SetHeat ותגובה

בקשה

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

תשובה

{}

שדות הבקשה של SetHeat

שדה תיאור סוג הנתונים
heatCelsius טמפרטורת היעד שיש להגדיר כשהתרמוסטט במצב חימום. number
דוגמה: 22.0

SetCool

המדיניות הזו מגדירה את טמפרטורת היעד כשהתרמוסטט במצב קירור.

בקשת SetCool ותגובה

בקשה

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

תשובה

{}

שדות הבקשה של SetCool

שדה תיאור סוג הנתונים
coolCelsius טמפרטורת היעד שצריך להגדיר כשהתרמוסטט במצב קירור number
דוגמה: 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
דוגמה: 20.0
coolCelsius טמפרטורת היעד המקסימלית שצריך להגדיר כשהתרמוסטט במצב HEATCOOL. number
דוגמה: 22.0

שגיאות

יכול להיות שיוחזר קודי השגיאה הבאים בקשר לתכונה הזו:

הודעת שגיאה הכנסה לקליק פתרון בעיות
אי אפשר להשתמש בפקודה במצב התרמוסטט הנוכחי. FAILED_PRECONDITION בדגמים מסוימים של התרמוסטט אין תמיכה בשינוי מצב 'חיסכון' כשמצב התרמוסטט כבוי, בהתאם לשיטת התרמוסטטמצב . יש לשנות את מצב התרמוסטט ל'חימום', 'קירור' או 'חימום חימום' לפני שמשנים את המצב 'חיסכון'.
ערך הקירור חייב להיות גדול מערך החימום. INVALID_ARGUMENT צריך לוודא שהשדה heatCelsius קטן מהשדה coolCelsius בפקודה.
הפקודה לא מותרת כשהתרמוסטט במצב MANUAL_ECO. FAILED_PRECONDITION לא ניתן להגדיר את הטמפרטורה הקבועה כשהתרמוסטט נמצא במצב חיסכון ידני.

מידע נוסף זמין בחומר העזר בנושא קוד שגיאה של API את הרשימה המלאה של קודי השגיאה של ה-API.