Termostat API

Interfejsy Nest API działają ze wszystkimi modelami urządzeń Nest Learning ThermostatTM – z wyjątkiem termostatu E z funkcją Heat Link w Unii Europejskiej.

Użytkownicy mogą dodać wiele urządzeń Nest Thermostat do grupy devices/thermostats do maksymalnej struktury. Wykonując połączenie z tą lokalizacją, masz dostęp do danych Nest Thermostat (wartości danych dla urządzeń w strukturze).

Wszystkie podane poniżej wartości znajdują się pod każdym polem devices/thermostats/device_id w dokumencie JSON.

identyfikator_urządzenia

Unikalny identyfikator Nest Thermostat.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/device_id
Zwrotystring
Przykład: „peyiJNo0IldT2YlIVtYaGQ”
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

język

Określa ustawienie języka i regionu (lub kraju).

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/locale
Zwrotystring
Przykłady: „en-GB”, „en-US”, „es-US”, „fr-CA”, „fr-CA”, „nl-NL”
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

wersja oprogramowania

Wersja oprogramowania.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/software_version
Zwrotystring
Przykład: „4.0”
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

identyfikator_struktury

Unikalny identyfikator struktury.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/structure_id
Zwrotystring
Przykład: „VqFabWH21nw...”
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

nazwa

Wyświetlana nazwa urządzenia. Może to być dowolna nazwa pokoju z dostępnej przez nas listy lub nazwa niestandardowa.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/name
Zwrotystring
Przykład: „korytarz”
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

nazwa_długiego

Długa nazwa wyświetlana urządzenia. Zawiera niestandardowy atrybut (etykieta), utworzony przez użytkownika, lub przez wheres.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/name_long
Zwrotystring
Przykład: „Termostat do przedpokoju” (na piętrze)
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

ostatnie_połączenie

Sygnatura czasowa ostatniej pomyślnej interakcji z usługą Nest w formacie ISO 8601.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/last_connection
Zwrotystring
Przykład: „2016-12-31T23:59:59.000Z”
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

jest_online

Stan połączenia urządzenia z usługą Nest.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/is_online
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

puszka

Możliwość chłodzenia (z klimatyzacją).

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/can_cool
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

can_heat

Możliwość ogrzewania systemu.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/can_heat
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

is_using_emergency_heat

Stan ogrzewania awaryjnego w systemach z pompami ciepła do chłodzenia.

Gdy ogrzewanie awaryjne jest włączone:

  • Użytkownik może dostosować temperaturę docelową na urządzeniu, ale nie może zmienić trybu, dopóki nie wyłączysz ogrzewania awaryjnego.
  • hvac_mode nadal można edytować za pomocą interfejsu API

Więcej informacji o tym, jak Nest Thermostat obsługuje ogrzewanie awaryjne, znajdziesz w sekcji Co jest trybem alarmowym?

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/is_using_emergency_heat
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

has_fan

System może sterować wentylatorem niezależnie od ogrzewania lub chłodzenia.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/has_fan
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

wentylator_aktywny

Wskazuje, czy minutnik wentylatora jest włączony. używany z fan_timer_duration do włączania wentylatora na określony czas określony przez użytkownika.

Więcej informacji o tym, jak klienci ustawiają czas trwania wentylatora, znajdziesz w sekcji Zaawansowane funkcje sterowania wentylatorem.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_active
Zwrotyboolean
Wartości: true, false
Dostępodczyt/zapis
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

limit_czasu_wentylatora

Sygnatura czasowa wskazująca czas wyświetlania wentylatora na 0 (czas zakończenia), podany w formacie ISO 8601.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_timeout
Zwrotystring
Przykład: „2016-12-31T23:59:59.000Z”
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

ma_liść

Wyświetlany, gdy termostat jest ustawiony na tryb oszczędzania energii.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/has_leaf
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

skala_temperatury

Fahrenheita lub Celsjusza. używany z wyświetlaczem temperatury.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/temperature_scale
Zwrotystring enum
Wartości: „F”, „C”
Dostępodczyt/zapis
Dostępność:Odczyt:
odczyt termostatu / v1-v6
odczyt/zapis termostatu / v1-v6
Zapis:
odczyt termostatu/write / v5-v6

docelowa_temperatura_f

temperatureądana temperatura w stopniach Fahrenheita (1°F). Używana, gdy hvac_mode = heat lub cool.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_f
Zwrotynumber
Przykład: 72
Zakres50-90
Dostępodczyt/zapis
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

docelowa_temperatura_c

Pożądana temperatura, w połowie stopni Celsjusza (0,5°C). Używana, gdy hvac_mode = heat lub cool.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_c
Zwrotynumber
Przykład: 21.5
Zakres9-32
Dostępodczyt/zapis
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

docelowa_temperatura_wysoka_f

Maksymalna temperatura docelowa wyświetlana w stopniach Fahrenheita (1°F). Tej opcji należy użyć, gdy hvac_mode = heat-cool (tryb grzania/chłodzenia).

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_f
Zwrotynumber
Przykład: 80
Dostępodczyt/zapis
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

docelowa_temperatura_wysoka_c

Maksymalna temperatura docelowa wyświetlana w połowie stopni Celsjusza (0, 5°C). Używana, gdy hvac_mode = heat-cool (tryb grzania/chłodzenia).

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_c
Zwrotynumber
Przykład: 24,5
Dostępodczyt/zapis
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

docelowa_temperatura_niska_f

Minimalna temperatura docelowa wyświetlana w stopniach Fahrenheita (1°F). Tej opcji należy użyć, gdy hvac_mode = heat-cool (tryb grzania/chłodzenia).

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_f
Zwrotynumber
Przykład: 65
Dostępodczyt/zapis
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

docelowa_temperatura_niska_c

Minimalna temperatura docelowa wyświetlana w połowie stopni Celsjusza (0, 5°C). Używana, gdy hvac_mode = heat-cool (tryb grzania/chłodzenia).

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_c
Zwrotynumber
Przykład: 19,5
Dostępodczyt/zapis
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

eko_temperatura_wysoka_f

Maksymalna temperatura w trybie Eko wyświetlana w stopniach Fahrenheita (1°F). Używana, gdy hvac_mode = eco.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_f
Zwrotynumber
Przykład: 80
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v6
Odczyt/zapis termostatu / v6

eko_temperatura_wysoka_c

Maksymalna temperatura w trybie Eko wyświetlana w półstopniach Celsjusza (0, 5°C). Używana, gdy hvac_mode = eco.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_c
Zwrotynumber
Przykład: 24,5
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v6
Odczyt/zapis termostatu / v6

eko_temperatura_niska_f

Minimalna temperatura w trybie Eko jest wyświetlana w stopniach Fahrenheita (1°F). Używana, gdy hvac_mode = eco.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_f
Zwrotynumber
Przykład: 65
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v6
Odczyt/zapis termostatu / v6

eko_temperatura_niska_c

Minimalna temperatura w trybie Eko wyświetlana w półstopniach Celsjusza (0, 5°C). Używana, gdy hvac_mode = eco.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_c
Zwrotynumber
Przykład: 19,5
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v6
Odczyt/zapis termostatu / v6

out_temperature_high_f (WYCOFANO)

Maksymalna temperatura na zewnątrz, wyświetlana w stopniach Fahrenheita (1°F).

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_f
Zwrotynumber
Przykład: 80
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

min_temperature_high_c (WYCOFANO)

Maksymalna temperatura na zewnątrz, wyświetlana w połowie stopni Celsjusza (0,5°C).

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_c
Zwrotynumber
Przykład: 24,5
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

out_temperature_low_f (WYCOFANO)

Minimalna temperatura na zewnątrz, wyrażona w stopniach Fahrenheita (1°F).

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_f
Zwrotynumber
Przykład: 65
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

out_temperature_low_c (WYCOFANO)

Minimalna temperatura na zewnątrz.Wyświetlana w połowie stopni Celsjusza (0, 5°C).

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_c
Zwrotynumber
Przykład: 19,5
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

hvac_mode,

Wskazuje tryby ogrzewania/chłodzenia w systemie ogrzewania/wentylacji/klimatyzacji, na przykład ogrzewanie • chłodzenie w systemach z możliwością ogrzewania i chłodzenia lub tryb Eko temperatury, który pozwala oszczędzać energię.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode
Zwrotystring enum
Wartości: „heat”, „cool”, „heat-cool”, „eco”, „off”
Dostępodczyt/zapis
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

Temperatura otoczenia

Temperatura urządzenia, mierzona w stopniach Fahrenheita (1°F).

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_f
Zwrotynumber
Przykład: 72
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

Temperatura otoczenia

Temperatura urządzenia, mierzona w połowie stopni Celsjusza (0, 5°C).

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_c
Zwrotynumber
Przykład: 21.5
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v1-v6
Odczyt/zapis termostatu / v1-v6

wilgotność

Wilgotność w procentach (%) mierzona w odniesieniu do urządzenia i zaokrąglona do 5%.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/humidity
Zwrotynumber
Przykład: 35
Zakres0-100
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v2-v6
Odczyt/zapis termostatu / v2-v6

hvac_state

Wskazuje, czy system ogrzewania/wentylacji/klimatyzacji jest aktywnie ogrzewany, chłodzony lub wyłączony. Ta wartość wskazuje stan aktywności ogrzewania/wentylacji/klimatyzacji.

Kiedy off, system ogrzewania/wentylacji/klimatyzacji nie jest aktywnie ogrzewany ani chłodzący. hvac_state jest niezależny od pracy wentylatora.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/hvac_state
Zwrotystring enum
Wartości: „ogrzewanie”, „chłodzenie”, „wyłączenie”
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v3-v6
Odczyt/zapis termostatu / v3-v6

Gdzie_identyfikator

Unikalny identyfikator wygenerowany przez Nest, który reprezentuje nazwę name i wyświetlaną nazwę urządzenia.

Dowiedz się więcej o miejscach, w których można znaleźć urządzenia Nest Thermostat, Nest Protect i Nest Cam.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/where_id
Zwrotystring
Przykład: „d6reb_OZTM...”
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v4-v6
Odczyt/zapis termostatu / v4-v6

jest zablokowany

Stan blokady termostatu. Jeśli ustawisz w tym polu wartość „prawda”, funkcja Termostat zostanie włączona, a zakres temperatury zostanie ograniczony do tych wartości minimalnej i maksymalnej: locked_temp_min_f locked_temp_max_f, locked_temp_min_c i locked_temp_max_c.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/is_locked
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v5-v6
Odczyt/zapis termostatu / v5-v6

zablokowana_temp_min_f

Minimalna temperatura Termostatu jest wyświetlana w stopniach Fahrenheita (1°F). Używana, gdy is_locked to true.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_f
Zwrotystring
Przykład: 65
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v5-v6
Odczyt/zapis termostatu / v5-v6

blocked_temp_max_f

Maksymalna temperatura Termostatu wyświetlana w stopniach Fahrenheita (1°F). Używana, gdy is_locked to true.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_f
Zwrotystring
Przykład: 80
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v5-v6
Odczyt/zapis termostatu / v5-v6

zablokowana_temp_min_c

Minimalna temperatura Termostatu jest wyświetlana w połowie stopni Celsjusza (0, 5°C). Używana, gdy is_locked to true.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_c
Zwrotystring
Przykład: 19,5
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v5-v6
Odczyt/zapis termostatu / v5-v6

zablokowana_temp_maksymalna_c

Maksymalna temperatura Termostatu wyświetlana w połowie stopni Celsjusza (0, 5°C). Używana, gdy is_locked to true.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_c
Zwrotystring
Przykład: 24,5
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v5-v6
Odczyt/zapis termostatu / v5-v6

etykieta

Etykieta własna termostatu. Pojawia się ona w nawiasach po nazwie.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/label
Zwrotystring
Przykłady: „na piętrze”, „pokój dla gości”, „pokój zabaw”
Dostępodczyt/zapis
Dostępność:Odczyt:
odczyt termostatu / v6
odczyt/zapis termostatu / v6
zapis:
odczyt/zapis termostatu / 5 -v6

włączona_korekta_słoneczna

Stan włączenia blokady UV. Używana z sunlight_correction_active. Gdy funkcja true jest włączona, termostat jest automatycznie dostosowywany do światła słonecznego, podczas czytania i ustawiania prawidłowej temperatury.

Więcej informacji znajdziesz w artykule Co to jest Sunblock?.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_enabled
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v6
Odczyt/zapis termostatu / v6

korekta_słoneczna_aktywna

Stan aktywności Sunblock. Używana z sunlight_correction_enabled. true oznacza, że termostat jest w pełnym słońcu.

Więcej informacji znajdziesz w artykule Co to jest Sunblock?.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_active
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v6
Odczyt/zapis termostatu / v6

Gdzie_nazwa

Wyświetlana nazwa urządzenia. Powiązano z termostatem where_id. Może to być dowolna nazwa z listy podanej przez nas lub nazwa niestandardowa. Dowiedz się więcej o miejscach, w których można znaleźć urządzenia Nest Thermostat, Nest Protect i Nest Cam.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/where_name
Zwrotystring
Przykład: „korytarz”
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v6
Odczyt/zapis termostatu / v6

fan_timer_duration

Określa czas (w minutach) pracy wentylatora.

Ustawienie fan_timer_active włącza wentylator. Wartość fan_timer_timeout wskazuje sygnaturę czasową, gdy parametr fan_timer_duration jest ustawiony na koniec.

Aby dowiedzieć się, jak klienci ustawiają minutnik, zobacz Czas minutnika.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_duration
Zwrotyint
Wartości: 15, 30, 45, 60, 120, 240, 480, 720
Dostępodczyt/zapis
Dostępność:Odczyt:
odczyt termostatu / v6
odczyt/zapis termostatu / v6
zapis:
odczyt/zapis termostatu / v6

Czas_do_celu

Czas potrzebny obiektowi (w minutach) na osiągnięcie docelowej temperatury.

Więcej informacji znajdziesz w sekcji Czas do osiągnięcia temperatury.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target
Zwrotystring enum
Wartości: „~0”, „<5”, „~15”, „~90”, „120”
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v6
Odczyt/zapis termostatu / v6

time_to_target_training [czas_do_kierowania_docelowego]

W trybie treningu Nest Thermostat uczy się na podstawie systemu ogrzewania/wentylacji/klimatyzacji oraz wykrywa czas potrzebny do osiągnięcia temperatury docelowej. Gdy termostat osiągnie wystarczającą ilość informacji, by przewidzieć szacunkowy czas osiągnięcia temperatury docelowej, wartość ta zmieni się z training na ready.

Więcej informacji znajdziesz w sekcji Czas do osiągnięcia temperatury.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target_training
Zwrotystring enum
Wartości: „szkolenie”, „gotowy”
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v6
Odczyt/zapis termostatu / v6

poprzedni_tryb_hvac

Wyświetla ostatnią wybraną opcję hvac_mode. Używana przy przechodzeniu z hvac_mode = eco na urządzeniu z nieaktualnym oprogramowaniem.

Więcej informacji o przełączaniu trybów Eko i innego niż Eko znajdziesz w przewodniku po termostacie.

Szczegóły
https://developer-api.nest.com/devices/thermostats/device_id/previous_hvac_mode
Zwrotystring
Wartości: „heat”, „cool”, „heat-cool”, „off”, „blank” (bez wartości)
Dostęptylko do odczytu
Dostępność:Odczyt termostatu / v6
Odczyt/zapis termostatu / v6