Termostat API

Nest API współpracuje ze wszystkimi modelami Nest Learning Thermostat ™, z wyjątkiem Termostatu E z Heat Link w UE.

Użytkownicy mogą dodawać wiele termostatów Nest do grupy devices/thermostats , do maksymalnej liczby na strukturę . Wykonując połączenie z tą lokalizacją danych, można uzyskać dostęp do danych termostatu Nest (wartości danych dla urządzeń w strukturze).

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

identyfikator urzadzenia

Unikalny identyfikator termostatu Nest.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
Zwroty	string Przykład: „peyiJNo0IldT2YlIVtYaGQ”
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

widownia

Określa preferencje dotyczące języka i regionu (lub kraju).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /locale
Zwroty	string Przykłady: „en-GB”, „en-US”, „es-US”, „fr-CA”, „fr-CA”, „nl-NL”
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

wersja oprogramowania

Wersja oprogramowania.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
Zwroty	string Przykład: „4,0”
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

identyfikator struktury

Niepowtarzalny identyfikator struktury.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
Zwroty	string Przykład: „VqFabWH21nw ...”
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

imię

Wyświetl nazwę urządzenia. Może to być dowolna nazwa pokoju z dostarczonej przez nas listy lub nazwa niestandardowa.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /name
Zwroty	string Przykład: „Przedpokój”
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

name_long

Długa wyświetlana nazwa urządzenia. Obejmuje niestandardową (etykietę), utworzoną przez użytkownika lub przez wheres .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
Zwroty	string Przykład: „Termostat w korytarzu (na piętrze)”
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

last_connection

Sygnatura czasowa ostatniej udanej interakcji z usługą Nest w formacie ISO 8601 .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
Zwroty	string Przykład: „2016-12-31T23: 59: 59.000Z”
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

jest online

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

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
Zwroty	boolean Wartości: prawda, fałsz
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

can_cool

Możliwość chłodzenia systemu (ma AC).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
Zwroty	boolean Wartości: prawda, fałsz
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

can_heat

Zdolność systemu do ogrzewania.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
Zwroty	boolean Wartości: prawda, fałsz
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

is_using_emergency_heat

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

Gdy ogrzewanie awaryjne jest włączone:

• Użytkownik może ustawić temperaturę docelową na urządzeniu, ale nie może zmienić trybu, dopóki ogrzewanie awaryjne nie zostanie wyłączone
• Tryb hvac_mode można nadal zmienić za pośrednictwem interfejsu API

Zobacz, czym jest nagrzewanie awaryjne? aby uzyskać więcej informacji o tym, jak termostat Nest obsługuje ogrzewanie awaryjne.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
Zwroty	boolean Wartości: prawda, fałsz
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

has_fan

Możliwość sterowania wentylatorem niezależnie od grzania lub chłodzenia.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
Zwroty	boolean Wartości: prawda, fałsz
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

fan_timer_active

Wskazuje, czy włączony jest zegar wentylatora; używany z fan_timer_duration do włączania wentylatora na (określony przez użytkownika) wstępnie ustawiony czas trwania.

Zobacz Zaawansowane sterowanie wentylatorem, aby uzyskać więcej informacji o tym, jak klienci ustawiają czas trwania wentylatora.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
Zwroty	boolean Wartości: prawda, fałsz
Dostęp	czytać / pisać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

fan_timer_timeout

Znacznik czasu pokazujący, kiedy licznik czasu wentylatora osiągnie 0 (czas zatrzymania), w formacie ISO 8601 .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
Zwroty	string Przykład: „2016-12-31T23: 59: 59.000Z”
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

has_leaf

Wyświetlany, gdy termostat jest ustawiony na temperaturę oszczędzającą energię.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
Zwroty	boolean Wartości: prawda, fałsz
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

skala_temperatury

Fahrenheit lub Celsjusz; używany z wyświetlaczem temperatury.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
Zwroty	string enum Wartości: „F”, „C”
Dostęp	czytać / pisać
Dostępne w	Czytać: Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6 Pisać: Termostat odczyt / zapis / v5-v6

temperatura_docelowa_f

Pożądana temperatura w pełnych stopniach Fahrenheita (1 ° F). Używane, gdy hvac_mode = heat lub cool .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
Zwroty	number Przykład: 72
Zasięg	50-90
Dostęp	czytać / pisać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

temperatura_docelowa_c

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

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
Zwroty	number Przykład: 21.5
Zasięg	9-32
Dostęp	czytać / pisać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

target_temperature_high_f

Maksymalna temperatura docelowa, wyświetlana w pełnych stopniach Fahrenheita (1 ° F). Używane, gdy hvac_mode = heat-cool (tryb Heat • Cool).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
Zwroty	number Przykład: 80
Dostęp	czytać / pisać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

temperatura_docelowa_wysoka_c

Maksymalna temperatura docelowa wyświetlana w pół stopni Celsjusza (0,5 ° C). Używane, gdy hvac_mode = heat-cool (tryb Heat • Cool).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
Zwroty	number Przykład: 24.5
Dostęp	czytać / pisać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

target_temperature_low_f

Minimalna temperatura docelowa, wyświetlana w pełnych stopniach Fahrenheita (1 ° F). Używane, gdy hvac_mode = heat-cool (tryb Heat • Cool).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
Zwroty	number Przykład: 65
Dostęp	czytać / pisać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

target_temperature_low_c

Minimalna temperatura docelowa wyświetlana w pół stopni Celsjusza (0,5 ° C). Używane, gdy hvac_mode = heat-cool (tryb Heat • Cool).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
Zwroty	number Przykład: 19.5
Dostęp	czytać / pisać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

eco_temperature_high_f

Maksymalna temperatura ekonomiczna, wyświetlana w pełnych stopniach Fahrenheita (1 ° F). Używane, gdy hvac_mode = eco .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
Zwroty	number Przykład: 80
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v6 Odczyt / zapis termostatu / v6

eco_temperature_high_c

Maksymalna temperatura eko, wyświetlana w pół stopni Celsjusza (0,5 ° C). Używane, gdy hvac_mode = eco .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_c
Zwroty	number Przykład: 24.5
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v6 Odczyt / zapis termostatu / v6

eco_temperature_low_f

Minimalna temperatura ekonomiczna, wyświetlana w pełnych stopniach Fahrenheita (1 ° F). Używane, gdy hvac_mode = eco .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
Zwroty	number Przykład: 65
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v6 Odczyt / zapis termostatu / v6

eco_temperature_low_c

Minimalna temperatura eko, wyświetlana w pół stopni Celsjusza (0,5 ° C). Używane, gdy hvac_mode = eco .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_c
Zwroty	number Przykład: 19.5
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v6 Odczyt / zapis termostatu / v6

away_temperature_high_f (DEPRECATED)

Maksymalna temperatura poza domem, wyświetlana w pełnych stopniach Fahrenheita (1 ° F).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
Zwroty	number Przykład: 80
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

away_temperature_high_c (DEPRECATED)

Maksymalna temperatura poza domem, wyświetlana w pół stopni Celsjusza (0,5 ° C).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
Zwroty	number Przykład: 24.5
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

away_temperature_low_f (DEPRECATED)

Minimalna temperatura poza domem, wyświetlana w pełnych stopniach Fahrenheita (1 ° F).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
Zwroty	number Przykład: 65
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

away_temperature_low_c (DEPRECATED)

Minimalna temperatura poza domem, wyświetlana w pół stopni Celsjusza (0,5 ° C).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
Zwroty	number Przykład: 19.5
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

hvac_mode

Wskazuje tryby ogrzewania / chłodzenia systemu HVAC, takie jak Ogrzewanie • Chłodzenie dla systemów z wydajnością ogrzewania i chłodzenia lub Temperatury Eco dla oszczędności energii.

• hvac_mode można zmienić, jeśli termostat jest zablokowany
• target_temperature_f i target_temperature_c nie można zmienić, jeśli hvac_mode = off lub eco

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
Zwroty	string enum Wartości: „heat”, „cool”, „heat-cool”, „eco”, „off”
Dostęp	czytać / pisać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

ambient_temperature_f

Temperatura mierzona na urządzeniu, w pełnych stopniach Fahrenheita (1 ° F).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
Zwroty	number Przykład: 72
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

temperatura_otoczenia_c

Temperatura mierzona na urządzeniu w pół stopni Celsjusza (0,5 ° C).

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
Zwroty	number Przykład: 21.5
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v1-v6 Termostat odczyt / zapis / v1-v6

wilgotność

Wilgotność, w formacie procentowym (%), zmierzona na urządzeniu, zaokrąglona do najbliższych 5%.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
Zwroty	number Przykład: 35
Zasięg	0-100
Dostęp	tylko czytać
Dostępne w	Termostat odczyt / v2-v6 Termostat odczyt / zapis / v2-v6

hvac_state

Wskazuje, czy system HVAC aktywnie grzeje, chłodzi czy jest wyłączony. Użyj tej wartości, aby wskazać stan aktywności HVAC.

Gdy jest off , system HVAC nie ogrzewa ani nie chłodzi aktywnie. hvac_state jest niezależne od pracy wentylatora.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
Zwroty	string enum Wartości: „ogrzewanie”, „chłodzenie”, „wył.”
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v3-v6 Termostat odczyt / zapis / v3-v6

gdzie_id

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

Dowiedz się więcej o nazwach termostatów Nest, zabezpieczeń Nest i kamer Nest .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
Zwroty	string Przykład: „d6reb_OZTM ...”
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v4-v6 Termostat odczyt / zapis / v4-v6

jest zamknięte

Stan blokady termostatu. Gdy prawda, funkcja blokady termostatu jest włączona i ogranicza zakres temperatur do następujących wartości min / max: locked_temp_min_f , locked_temp_max_f , locked_temp_min_c i locked_temp_max_c .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
Zwroty	boolean Wartości: prawda, fałsz
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / V5-V6 Termostat odczyt / zapis / v5-v6

Locked_temp_min_f

Minimalna temperatura blokady termostatu , wyświetlana w pełnych stopniach Fahrenheita (1 ° F). Używane, gdy is_locked ma wartość true .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
Zwroty	string Przykład: 65
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / V5-V6 Termostat odczyt / zapis / v5-v6

Locked_temp_max_f

Maksymalna temperatura blokady termostatu , wyświetlana w pełnych stopniach Fahrenheita (1 ° F). Używane, gdy is_locked ma wartość true .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
Zwroty	string Przykład: 80
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / V5-V6 Termostat odczyt / zapis / v5-v6

Locked_temp_min_c

Minimalna temperatura blokady termostatu , wyświetlana w pół stopni Celsjusza (0,5 ° C). Używane, gdy is_locked ma wartość true .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_c
Zwroty	string Przykład: 19.5
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / V5-V6 Termostat odczyt / zapis / v5-v6

Locked_temp_max_c

Maksymalna temperatura blokady termostatu , wyświetlana w pół stopni Celsjusza (0,5 ° C). Używane, gdy is_locked ma wartość true .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_c
Zwroty	string Przykład: 24.5
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / V5-V6 Termostat odczyt / zapis / v5-v6

etykieta

Niestandardowa etykieta termostatu. Pojawia się w nawiasach, po nazwie miejsca.

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /label
Zwroty	string Przykłady: „Na piętrze”, „Pokój gościnny”, „Pokój zabaw”
Dostęp	czytać / pisać
Dostępne w	Czytać: Odczyt termostatu / v6 Odczyt / zapis termostatu / v6 Pisać: Termostat odczyt / zapis / v5-v6

sunlight_correction_enabled

Status włączonej blokady przeciwsłonecznej. Używany z sunlight_correction_active . Gdy true , technologia Sunblock jest włączona, a termostat automatycznie dostosowuje się do bezpośredniego światła słonecznego, odczytując i ustawiając prawidłową temperaturę.

Aby uzyskać więcej informacji, zobacz Co to jest krem ​​z filtrem przeciwsłonecznym?

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
Zwroty	boolean Wartości: prawda, fałsz
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v6 Odczyt / zapis termostatu / v6

sunlight_correction_active

Status aktywnego kremu z filtrem. Używane z sunlight_correction_enabled . Jeśli true , oznacza, że ​​termostat znajduje się w bezpośrednim świetle słonecznym.

Aby uzyskać więcej informacji, zobacz Co to jest krem ​​z filtrem przeciwsłonecznym?

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
Zwroty	boolean Wartości: prawda, fałsz
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v6 Odczyt / zapis termostatu / v6

gdzie_nazwa

Wyświetlana nazwa urządzenia. Powiązane z termostatem where_id . Może to być dowolna nazwa pokoju z dostarczonej przez nas listy lub nazwa niestandardowa. Dowiedz się więcej o nazwach termostatów Nest, zabezpieczeń Nest i kamer Nest .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
Zwroty	string Przykład: „Przedpokój”
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v6 Odczyt / zapis termostatu / v6

fan_timer_duration

Określa czas (w minutach), w którym wentylator ma pracować.

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

Aby dowiedzieć się, jak klienci ustawiają licznik czasu wentylatora, zobacz Czas trwania licznika .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
Zwroty	int Wartości: 15, 30, 45, 60, 120, 240, 480, 720
Dostęp	czytać / pisać
Dostępne w	Czytać: Odczyt termostatu / v6 Odczyt / zapis termostatu / v6 Pisać: Odczyt / zapis termostatu / v6

time_to_target

Czas w minutach, w jakim konstrukcja osiągnie docelową temperaturę.

Aby uzyskać więcej informacji, patrz Czas do uzyskania temperatury .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
Zwroty	string enum Wartości: „~ 0”, „<5”, „~ 15”, „~ 90”, „120”
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v6 Odczyt / zapis termostatu / v6

time_to_target_training

W trybie treningowym Nest Thermostat uczy się o systemie HVAC i odkrywa, ile czasu potrzeba, aby osiągnąć docelową temperaturę. Gdy termostat ma wystarczające informacje, aby dokonać rozsądnego oszacowania czasu do osiągnięcia temperatury docelowej, wartość ta zmieni się od training do ready .

Aby uzyskać więcej informacji, patrz Czas do uzyskania temperatury .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
Zwroty	string enum Wartości: „trening”, „gotowy”
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v6 Odczyt / zapis termostatu / v6

previous_hvac_mode

Wyświetla ostatnio wybrany hvac_mode . Używany podczas przełączania z hvac_mode = eco na urządzeniu z przestarzałym oprogramowaniem.

Aby dowiedzieć się więcej o przełączaniu między trybami Eco i non-Eco, zobacz Przewodnik po termostacie .

Detale
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
Zwroty	string Wartości: „heat”, „cool”, „heat-cool”, „off”, blank (brak wartości)
Dostęp	tylko czytać
Dostępne w	Odczyt termostatu / v6 Odczyt / zapis termostatu / v6