הסכימה של ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

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

שדות

שדה תיאור סוג הנתונים
heatCelsius טמפרטורת היעד במעלות צלזיוס במצבי HEAT ו-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, התרמוסטט צריך להיות קודם במצב HEAT:

מצב פקודה שדות
HEAT SetHeat heatCelsius
COOL SetCool coolCelsius
HEATCOOL SetRange heatCelsius, coolCelsius

חשוב לזכור שהפקודות של נקודת היעד מקבלות רק מעלות צלזיוס כפרמטר, אבל 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 חלק מדגמי התרמוסטט לא תומכים בשינוי מצב החיסכון כשמצב התרמוסטט מושבת, בהתאם למאפיין ThermostatMode . צריך לשנות את מצב התרמוסטט ל-HEAT,‏ COOL או HEATCOOL לפני שמחליפים את מצב החיסכון.
הערך של הקירור חייב להיות גדול מהערך של החימום. INVALID_ARGUMENT חשוב לוודא שהשדה heatCelsius קטן מהשדה coolCelsius בפקודה.
לא ניתן להשתמש בפקודה כשהתרמוסטט במצב MANUAL_ECO. FAILED_PRECONDITION אי אפשר להגדיר את נקודת היעד של הטמפרטורה כשהתרמוסטט נמצא במצב חיסכון ידני.

הרשימה המלאה של קודי השגיאה של ה-API מופיעה בחומר העזר בנושא קוד שגיאה של API.