הסכימה של ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

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

שדות

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

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

בקשה ותגובה של 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.