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™是一種互聯網連接的設備,直觀易用,可不斷學習家庭使用方式,以優化舒適度並節省能源。用戶可以在任何可以訪問Internet連接的地方控制其加熱和冷卻。

要支持這些功能,就需要一個複雜的控制系統,該系統必須超越簡單的基於設定點的程序。 Nest提供了多種算法(例如Early OnTrue RadiantAirwave™ ),與大多數恆溫器相比,它們需要大量的計算能力。 Nest Thermostat具有提供這些高級功能所需的功能。

Nest API旨在允許產品控制HVAC系統,而不會中斷Nest算法或使用戶感到意外行為。他們可以訪問Nest Thermostat的以下數據:

  • 結構名稱和設備“位置名稱”(家庭中的位置)
  • 自定義恆溫器標籤
  • 聯機狀態和上次連接信息
  • 當前溫度和目標溫度
  • 溫度模式
  • 生態溫度
  • 到達溫度
  • 溫度標度(設定F / C)
  • 溫度鎖定狀態,如果已鎖定,則為最小/最大鎖定溫度值
  • 風扇計時器持續時間和HVAC模式
  • 濕度
  • 防曬霜

溫控器權限

要對所有恆溫器API數據值進行讀取訪問, 為您的客戶端選擇恆溫器讀取權限。

要對所有恆溫器API數據值進行讀取訪問,並對選擇值進行其他寫入訪問, 為客戶端選擇恆溫器讀/寫權限。此權限級別使您可以更新以下內容:

  • 目標溫度
  • 暖通空調模式
  • 風扇計時器

從恆溫器讀/寫v5開始,您還可以更新以下內容:

  • 溫標
  • 溫控器標籤

恆溫器標識符

設備

嵌套設備按類型列出為ID數組,可用於通過設備路徑唯一標識設備。因此,恆溫器ID為"peyiJNo..."意味著您可以通過API在devices/thermostats/peyiJNo...加載恆溫器設備模型。

當設備連接到多個產品時,每個開發人員將看到該設備的不同ID。對於已安裝來自同一開發人員的多個產品的設備,開發人員將看到相同的ID。

名稱

提供了兩個名稱屬性。較短的name屬性顯示在用戶界面標籤中,而name_long用於長格式文本。

name

在這些示例中, name為“走廊”或“走廊(西)”。

名稱名字長

name_long

在此示例中, name_long是“辦公室(樓上)”。

在消息中長名稱

標籤

姓名(標籤)
姓名(標籤)

權限版本v5開始,您可以通過API添加自定義恆溫器標籤。在Nest應用中,標籤會在where名稱後的括號中顯示。

權限版本v6開始,您還可以閱讀恆溫器標籤。

哪裡

where_id

  • 由Nest生成的唯一標識符,代表name
  • where_id是只讀的,並且會在調用中自動創建以創建自定義where name

詳細了解Nest ThermostatsNest ProtectsNest Cams的名稱

where_name

選擇任何恆溫器權限時 ,可以從設備對象( devices/thermostats )訪問設備where_name

其他元數據

除非另有說明,否則所有數據值都是只讀的。

資料值描述
locale 分配給此設備的語言和國家/地區代碼
software_version 代表設備當前安裝的固件的字符串
structure_id 一個唯一表示此結構的字符串;這是設備與之配對的結構
last_connection 上次成功連接Nest服務的時間戳
is_online 聯機狀態。這是由Nest使用last_connection時間和特定於設備的預期重新連接窗口確定的。

溫控器功能

溫控器模式

HVAC系統具有四個“打開”狀態( heatcoolheat-cooleco )和一個“關閉”狀態( off )。我們使用這些狀態通過hvac_mode和溫度數據值來管理舒適度和節能。

  • 選擇“加熱”或“冷卻”模式(“ heat ,“ cool )時,恆溫器會將房屋調節到目標溫度。
  • 選擇“加熱• heat-cool模式(“ heat-cool )時,溫控器將在理想的溫度範圍內保持居家舒適。
  • 選擇“ 環保溫度” (eco Temperatures )時,恆溫器將應用節能算法,以保持房屋舒適並減少能源消耗。在此模式下的恆溫器顯示ECO。

結構具有與狀態相關的兩個狀態:“歸屬”或“離開”。當房屋中沒有感覺到運動時,結構將從“家”變為“家”,並且家中的恆溫器將自動啟用“環保溫度”。

hvac_mode和溫度值如何一起工作

根據hvac_mode的值,只能在API中訪問某些溫度數據值:

暖通空調模式您可以訪問的溫度數據值
heatcool target_temperature_ftarget_temperature_c
heat-cool target_temperature_low_ftarget_temperature_high_f
要么
target_temperature_low_ctarget_temperature_high_c
eco eco_temperature_low_feco_temperature_high_f
要么
eco_temperature_low_ceco_temperature_high_c
off 沒有

在某些情況下,圍繞更改hvac_mode有一些特殊規則:

情境可以更改hvac_mode嗎?
溫度鎖定已啟用
緊急關閉處於活動狀態沒有
啟用緊急加熱 沒有
can_coolcan_heat值為false 沒有

生態溫度

生態溫度可讓用戶節省能源,無論他們是否在家。在產品中實現節能行為時,請考慮將hvac_mode切換為eco

在Nest API中,可從恆溫器讀取權限和讀取/寫入v6權限開始使用Eco Temperature端點

在環保和非環保模式之間切換

您的產品無需在Eco模式下直接管理目標溫度。當房屋設置為離開時,基於用戶選擇,不顯示目標溫度,而是在內部設定目標溫度。當恆溫器設置為OFF時,則不會觀察到目標溫度。

如果絕對必須直接更改目標溫度,請確保在兩個單獨的調用中進行更改:

  1. hvac_mode更改為eco以外的任何其他值
  2. 修改適當的target_temperature數據值

從恆溫器讀取和讀取/寫入v6權限開始,您可以通過API來訪問previous_hvac_mode ,以協助進行HVAC模式轉換。 previous_hvac_mode用於在過渡到“ eco”之前存儲設備的hvac_mode

例如,如果Nest Thermostat使用的是環保溫度( hvac_mode = "eco" ),則previous_hvac_mode可用,並且您希望產品設置target_temperature ,則必須首先:

  1. 獲取previous_hvac_mode
  2. hvac_mode設置為previous_hvac_mode
  3. 確認hvac_mode不再設置為“ eco”

完成這些步驟後,適當設置目標溫度。

根據hvac_mode值,這是previous_hvac_mode變化方式:

hvac_mode狀態為... 然後, previous_hvac_mode可以是...
eco heatcoolheat-cooloff
heatcoolheat-cooloff 空白/空

目標溫度

目標溫度是HVAC系統最重要的值-這是所需的溫度,通常由用戶設置。大多數行動和決定都基於此。通過API,與Nest產品一起使用可以將目標溫度寫入更大的過程中。

打開系統電源時,始終會設置目標溫度。

  • 當加熱或冷卻模式( heatcool被選擇),一個單一的target_temperature是集
  • 當熱•冷模式( heat-cool被選擇),兩個target_temperature值被設定,表示目標範圍,一個更高的用於冷卻和加熱一個較低
  • 選擇Eco模式( eco )時,在內部設置目標溫度範圍

還有一些安全溫度可作為後盾,以防止管道凍結或房屋內溫度過高。

當恆溫器關閉時,不會設置目標溫度。

到達溫度

溫度變化使您可以訪問HVAC系統的以下數據值:

  • time_to_target結構達到目標溫度time_to_target的時間(以分鐘為單位)
  • time_to_target_training
    • 培訓狀況
    • 當恆溫器了解HVAC系統的響應方式時,它會調整估算值以達到目標溫度
    • 當恆溫器有足夠的把握確保達到目標溫度所需的時間時,狀態會從training變為ready

環境溫度

在恆溫器附近測得的溫度。顯示與用戶首選的溫度標度相對應的值。

溫標

環境溫度和目標溫度變量按攝氏度或華氏度來組織。根據用戶的喜好, temperature_scale屬性將為“ F”或“ C”。此屬性由每個恆溫器設置,因此,在單個結構中,用戶可能有兩個恆溫器,每個溫度範圍一個。在顯示溫度值時,請記住用戶的偏好

權限版本v5開始,您可以通過API更改溫度範圍。

“目標溫度”和“環境溫度”字段具有_f_c變體,以適應顯示溫度時的四捨五入。

溫度顯示

溫控器

顯示目標溫度信息時,請考慮以下三個相關值: temperature_scalehvac_mode和結構的away狀態。

許多數據值可以共同確定Nest Thermostat顯示屏上顯示的內容以及其行為。

  • 如果將hvac_mode設置為heat-cool ,則Nest Thermostat會顯示上下限設定值,並以項目符號(•)分隔,否則Nest Thermostat只會顯示目標溫度
  • hvac_mode設置為off ,Nest Thermostat上將以用戶首選的語言顯示“ OFF”字樣
  • hvac_mode設置為eco ,Nest Thermostat上將以用戶首選的語言顯示“ ECO”字樣

顯示溫度格式還取決於所選的溫度標度(F / C)。

華氏溫度以整數形式顯示:

  • 目標溫度:55°F
  • 環境溫度:62°F

攝氏溫度顯示為整數或十進制值,最後一位設置為“ .5”:

  • 目標溫度:12°C
  • 環境溫度:16.5°C

當葉子圖標顯示在恆溫器的正面時,恆溫器將設置為節能溫度,並且has_leaf = true

葉

溫度鎖

用戶可以鎖定Nest Thermostat,以便只能在有限的溫度範圍內對其進行調節。從權限版本v5開始,您可以通過檢查is_locked來查看是否啟用了溫度鎖定 ,如果已啟用,則可以通過API讀取溫度鎖定的最小值/最大值:

鎖溫度必須成對地指定為最大值和最小值,並且只有在is_locked = true才能寫入。

濕度

在設備上測量的以百分比(%)格式表示的濕度四捨五入到最接近的5%。

防曬霜

Sunblock技術會自動調節Nest Thermostat上的溫度,以補償由於陽光直射在設備上而產生的熱量峰值。

這些數據值將告訴您是否啟用了Sunblock和/或正在主動校正溫度。

風扇

許多HVAC系統都集成了風扇,這意味著無法獨立控制風扇 。集成風扇沒有關閉模式,因為在加熱或冷卻打開時風扇需要運行。

但是,如果兼容HVAC系統,則可以通過API顯式打開風扇,以使乘員更舒適,而無需使用整個HVAC系統。

如果可以獨立控制風扇,則has_fan將設置為true ,並可以通過恆溫器讀/寫權限設置以下數據值:

  • fan_timer_active布爾值,如果使用了風扇定時器達預編程的持續時間,則返回true
  • fan_timer_duration -int,風扇設置為運行的時間長度(以分鐘為單位)

將這些值一起使用可啟動風扇計時器(打開風扇)達特定時間。您還可以使用fan_timer_timeout值來確定將風扇設置為停止運行的時間戳。

請注意,您始終可以更改fan_timer_duration它與hvac_mode或結構佔用狀態(離開)無關。

您可以期望這些響應成功或失敗:

  • 200 OK
  • 400錯誤的要求

如果打開風扇的命令未產生預期的結果,則可能是因為風扇已被使用(用戶手動或按計劃進行,或者是由於HVAC的加熱/冷卻循環)。

限速

我們應用速率限制來防止過度呼叫設備,這可能會影響系統或電池性能。在正常情況下,Nest設備會通過加熱和冷卻系統上的低壓電線為電池充電。但是,如果在短時間內撥打過多電話且電池電量不足,則Nest Thermostat會關閉Wi-Fi以節省電量。

實際上,這意味著我們限制了在定義的時間段內可以撥打設備的電話數量。如果超過此限制,您將收到錯誤響應和一條消息,指出您已超過限制。

有關更多信息,請參見數據速率限制

功率限制

在某些情況下,恆溫器可能沒有足夠的電池電量來滿足修改請求。在這種情況下,您將收到錯誤響應和一條消息,指示設備此時無法處理請求。如果發生這種情況,請在再次嘗試之前給電池充電一段時間。

在Nest Learning Thermostat中了解有關電池電量不足的更多信息。

錯誤訊息

有些狀態使某些功能不可用。這些規則是為了節約能源或提供舒適性和安全性而製定的。

有關什麼是API調用錯誤的含義以及如何處理錯誤的信息 ,請參見錯誤消息

WLAN /連接問題

如果設備離線,則不允許進行修改。您可以在數據模型中觀察設備的在線狀態,並適當顯示UI。