API del termostato

L'API Nest funziona con tutti i modelli di Nest Learning Thermostat™, ad eccezione di Thermostat E con Heat Link nell'UE.

Gli utenti possono aggiungere più termostati nido per l' devices/thermostats di gruppo, fino al massimo per la struttura . Quando effettui una chiamata a questa posizione dati, puoi accedere ai dati del termostato Nest (valori dei dati per i dispositivi nella struttura).

Tutti i valori di seguito si trovano sotto ogni devices/thermostats/ device_id nel documento JSON.

ID del dispositivo

Identificatore univoco del termostato Nest.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
ritorna	string Esempio: "peyiJNo0IldT2YlIVtYaGQ"
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

locale

Specifica la lingua e la regione (o paese).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /locale
ritorna	string Esempi: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

versione software

Versione software.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
ritorna	string Esempio: "4.0"
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

id_struttura

Identificatore univoco della struttura.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
ritorna	string Esempio: "VqFabWH21nw..."
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

nome

Visualizza il nome del dispositivo. Può essere qualsiasi nome di stanza da un elenco che forniamo o un nome personalizzato.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /name
ritorna	string Esempio: "Corridoio"
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

nome_lungo

Nome visualizzato lungo del dispositivo. Include un personalizzato (etichetta), creata dall'utente, o tramite wheres .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
ritorna	string Esempio: "Termostato corridoio (piano superiore)"
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

ultima_connessione

Timestamp dell'ultima interazione con successo con il servizio nido, in ISO 8601 formato.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
ritorna	string Esempio: "2016-12-31T23:59:59.000Z"
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

è in linea

Stato della connessione del dispositivo con il servizio Nest.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
ritorna	boolean Valori: vero, falso
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

can_cool

Capacità del sistema di raffreddare (ha AC).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
ritorna	boolean Valori: vero, falso
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

can_heat

Capacità del sistema di riscaldare.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
ritorna	boolean Valori: vero, falso
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

is_using_emergency_heat

Stato di Emergenza Riscaldamento in impianti con pompe di calore per raffrescamento.

Quando il riscaldamento di emergenza è attivo:

• L'utente può regolare la temperatura target sul dispositivo, ma non può cambiare la modalità fino a quando il riscaldamento di emergenza non viene disattivato
• Il hvac_mode può ancora essere modificata tramite l'API

Vedi di Cosa calore di emergenza? per ulteriori informazioni su come il termostato Nest supporta il riscaldamento di emergenza.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
ritorna	boolean Valori: vero, falso
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

has_fan

Possibilità del sistema di controllare il ventilatore indipendentemente dal riscaldamento o dal raffreddamento.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
ritorna	boolean Valori: vero, falso
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

fan_timer_active

Indica se è attivo il timer del ventilatore; utilizzato con fan_timer_duration per accendere il ventilatore per un (specificato dall'utente) periodo predefinito.

Vedere avanzato Fan Control per maggiori informazioni su come i clienti impostare la durata della ventola.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
ritorna	boolean Valori: vero, falso
Accesso	leggere scrivere
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

fan_timer_timeout

Timestamp mostra quando il timer arriva a 0 ventola (tempo di arresto), in ISO 8601 formato.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
ritorna	string Esempio: "2016-12-31T23:59:59.000Z"
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

has_leaf

Visualizzato quando il termostato è impostato su una temperatura a risparmio energetico.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
ritorna	boolean Valori: vero, falso
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

temperatura_scala

Fahrenheit o Celsius; utilizzato con visualizzazione della temperatura.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
ritorna	string enum Valori: "F", "C"
Accesso	leggere scrivere
Disponibile in	Leggere: Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6 Scrivi: Lettura/scrittura termostato / v5-v6

target_temperature_f

Temperatura desiderata, in gradi Fahrenheit (1°F). Utilizzato quando hvac_mode = heat o di cool .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
ritorna	number Esempio: 72
Gamma	50-90
Accesso	leggere scrivere
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

target_temperature_c

Temperatura desiderata, in mezzi gradi Celsius (0,5°C). Utilizzato quando hvac_mode = heat o di cool .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
ritorna	number Esempio: 21.5
Gamma	9-32
Accesso	leggere scrivere
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

target_temperature_high_f

Temperatura target massima, visualizzata in gradi Fahrenheit interi (1°F). Utilizzato quando hvac_mode = heat-cool (calore • Modalità di raffreddamento).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
ritorna	number Esempio: 80
Accesso	leggere scrivere
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

target_temperature_high_c

Temperatura target massima, visualizzata in mezzi gradi Celsius (0,5 °C). Utilizzato quando hvac_mode = heat-cool (calore • Modalità di raffreddamento).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
ritorna	number Esempio: 24,5
Accesso	leggere scrivere
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

target_temperature_low_f

Temperatura target minima, visualizzata in gradi Fahrenheit interi (1°F). Utilizzato quando hvac_mode = heat-cool (calore • Modalità di raffreddamento).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
ritorna	number Esempio: 65
Accesso	leggere scrivere
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

target_temperature_low_c

Temperatura target minima, visualizzata in mezzi gradi Celsius (0,5 °C). Utilizzato quando hvac_mode = heat-cool (calore • Modalità di raffreddamento).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
ritorna	number Esempio: 19,5
Accesso	leggere scrivere
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

eco_temperature_high_f

Temperatura Eco massima, visualizzata in gradi Fahrenheit interi (1°F). Utilizzato quando hvac_mode = eco .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
ritorna	number Esempio: 80
Accesso	sola lettura
Disponibile in	Lettura termostato / v6 Lettura/scrittura termostato / v6

eco_temperature_high_c

Temperatura Eco massima, visualizzata in mezzi gradi Celsius (0,5°C). Utilizzato quando hvac_mode = eco .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_c
ritorna	number Esempio: 24,5
Accesso	sola lettura
Disponibile in	Lettura termostato / v6 Lettura/scrittura termostato / v6

eco_temperature_low_f

Temperatura Eco minima, visualizzata in gradi Fahrenheit interi (1°F). Utilizzato quando hvac_mode = eco .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
ritorna	number Esempio: 65
Accesso	sola lettura
Disponibile in	Lettura termostato / v6 Lettura/scrittura termostato / v6

eco_temperature_low_c

Temperatura Eco minima, visualizzata in mezzi gradi Celsius (0,5°C). Utilizzato quando hvac_mode = eco .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_c
ritorna	number Esempio: 19,5
Accesso	sola lettura
Disponibile in	Lettura termostato / v6 Lettura/scrittura termostato / v6

away_temperature_high_f (DEPRECATO)

Temperatura massima esterna, visualizzata in gradi Fahrenheit interi (1°F).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
ritorna	number Esempio: 80
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

away_temperature_high_c (DEPRECATO)

Temperatura massima esterna, visualizzata in mezzi gradi Celsius (0,5 °C).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
ritorna	number Esempio: 24,5
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

away_temperature_low_f (OBBLIGATO)

Temperatura minima esterna, visualizzata in gradi Fahrenheit interi (1°F).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
ritorna	number Esempio: 65
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

away_temperature_low_c (OBBLIGATO)

Temperatura minima esterna, visualizzata in mezzi gradi Celsius (0,5 °C).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
ritorna	number Esempio: 19,5
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

hvac_mode

Indica le modalità di riscaldamento/raffreddamento del sistema HVAC, come Heat•Cool per sistemi con capacità di riscaldamento e raffreddamento o Temperature Eco per il risparmio energetico.

• hvac_mode può essere modificata se il termostato è bloccato
• target_temperature_f e target_temperature_c non può essere cambiato se hvac_mode = off o eco

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
ritorna	string enum Valori: "caldo", "freddo", "caldo-freddo", "eco", "spento"
Accesso	leggere scrivere
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

temperatura_ambiente_f

Temperatura, misurata sul dispositivo, in gradi Fahrenheit interi (1°F).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
ritorna	number Esempio: 72
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

temperatura_ambiente_c

Temperatura, misurata sul dispositivo, in mezzi gradi Celsius (0,5°C).

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
ritorna	number Esempio: 21.5
Accesso	sola lettura
Disponibile in	Lettura termostato / v1-v6 Lettura/scrittura termostato / v1-v6

umidità

Umidità, in formato percentuale (%), misurata sul dispositivo, arrotondata al 5% più vicino.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
ritorna	number Esempio: 35
Gamma	0-100
Accesso	sola lettura
Disponibile in	Lettura termostato / v2-v6 Lettura/scrittura termostato / v2-v6

hvac_state

Indica se il sistema HVAC sta attivamente riscaldando, raffreddando o è spento. Utilizzare questo valore per indicare lo stato di attività HVAC.

Quando off , il sistema HVAC non è attivamente riscaldamento o raffreddamento. hvac_state è indipendente funzionamento del ventilatore.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
ritorna	string enum Valori: "riscaldamento", "raffreddamento", "spento"
Accesso	sola lettura
Disponibile in	Lettura termostato / v3-v6 Lettura/scrittura termostato / v3-v6

dove_id

Un identificatore univoco del nido generato che rappresenta name , il nome di visualizzazione del dispositivo.

Scopri di più su dove nomi per Termostato Nest ,Nest Protegge e Nest erotiche .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
ritorna	string Esempio: "d6reb_OZTM..."
Accesso	sola lettura
Disponibile in	Lettura termostato / v4-v6 Lettura/scrittura termostato / v4-v6

è bloccato

Stato di blocco del termostato. Quando vero, il termostato di blocco funzione è abilitata, e limita l'intervallo di temperatura di questi valori min / max: locked_temp_min_f , locked_temp_max_f , locked_temp_min_c e locked_temp_max_c .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
ritorna	boolean Valori: vero, falso
Accesso	sola lettura
Disponibile in	Lettura termostato / v5-v6 Lettura/scrittura termostato / v5-v6

lock_temp_min_f

Minimo termostato di blocco della temperatura, visualizzata in gradi Fahrenheit interi (1 ° F). Utilizzato quando is_locked è true .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
ritorna	string Esempio: 65
Accesso	sola lettura
Disponibile in	Lettura termostato / v5-v6 Lettura/scrittura termostato / v5-v6

bloccato_temp_max_f

Massima termostato di blocco della temperatura, visualizzata in gradi Fahrenheit interi (1 ° F). Utilizzato quando is_locked è true .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
ritorna	string Esempio: 80
Accesso	sola lettura
Disponibile in	Lettura termostato / v5-v6 Lettura/scrittura termostato / v5-v6

lock_temp_min_c

Minimo termostato di blocco della temperatura, visualizzata in visualizzata in gradi Celsius e mezzo (0,5 ° C). Utilizzato quando is_locked è true .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_c
ritorna	string Esempio: 19,5
Accesso	sola lettura
Disponibile in	Lettura termostato / v5-v6 Lettura/scrittura termostato / v5-v6

bloccato_temp_max_c

Massima termostato Blocco temperatura, indicato in visualizzato in mezzi gradi Celsius (0,5 ° C). Utilizzato quando is_locked è true .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_c
ritorna	string Esempio: 24,5
Accesso	sola lettura
Disponibile in	Lettura termostato / v5-v6 Lettura/scrittura termostato / v5-v6

etichetta

Termostato etichetta personalizzata . Appare tra parentesi, dopo il nome where.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /label
ritorna	string Esempi: "Al piano superiore", "Stanza degli ospiti", "Stanza dei giochi"
Accesso	leggere scrivere
Disponibile in	Leggere: Lettura termostato / v6 Lettura/scrittura termostato / v6 Scrivi: Lettura/scrittura termostato / v5-v6

sun_correction_enabled

Stato di Sunblock abilitato. Utilizzato con sunlight_correction_active . Quando true , tecnologia Sunblock è abilitato, e il termostato sta regolando automaticamente alla luce solare diretta, la lettura e la regolazione della temperatura corretta.

Per ulteriori informazioni, vedere cosa è Sunblock?

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
ritorna	boolean Valori: vero, falso
Accesso	sola lettura
Disponibile in	Lettura termostato / v6 Lettura/scrittura termostato / v6

sun_correction_active

Stato attivo di Sunblock. Utilizzato con sunlight_correction_enabled . Quando true , indica che il termostato si trova in luce diretta del sole.

Per ulteriori informazioni, vedere cosa è Sunblock?

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
ritorna	boolean Valori: vero, falso
Accesso	sola lettura
Disponibile in	Lettura termostato / v6 Lettura/scrittura termostato / v6

dove_nome

Il nome visualizzato del dispositivo. Associato al termostato where_id . Può essere qualsiasi nome di stanza da un elenco che forniamo o un nome personalizzato. Scopri di più su dove nomi per Termostato Nest ,Nest Protegge e Nest erotiche .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
ritorna	string Esempio: "Corridoio"
Accesso	sola lettura
Disponibile in	Lettura termostato / v6 Lettura/scrittura termostato / v6

fan_timer_duration

Specifica il periodo di tempo (in minuti) per il quale la ventola è impostata per funzionare.

Il fan_timer_active impostazione si accende il ventilatore. Il fan_timer_timeout valore indica il timestamp quando fan_timer_duration è impostata fine.

Per informazioni su come i clienti di impostare il timer della ventola, vedere Timer Durata .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
ritorna	int Valori: 15, 30, 45, 60, 120, 240, 480, 720
Accesso	leggere scrivere
Disponibile in	Leggere: Lettura termostato / v6 Lettura/scrittura termostato / v6 Scrivi: Lettura/scrittura termostato / v6

time_to_target

Il tempo, in minuti, che impiegherà la struttura a raggiungere la temperatura target.

Vedere Time-to-temperatura per ulteriori informazioni.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
ritorna	string enum Valori: "~0", "<5", "~15", "~90", "120"
Accesso	sola lettura
Disponibile in	Lettura termostato / v6 Lettura/scrittura termostato / v6

time_to_target_training

Quando è in modalità allenamento, il termostato Nest apprende il sistema HVAC e scopre quanto tempo impiega per raggiungere la temperatura target. Quando il termostato dispone di informazioni sufficienti per fare una stima ragionevole del tempo per raggiungere la temperatura target, questo valore cambierà da training a ready .

Vedere Time-to-temperatura per ulteriori informazioni.

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
ritorna	string enum Valori: "formazione", "pronto"
Accesso	sola lettura
Disponibile in	Lettura termostato / v6 Lettura/scrittura termostato / v6

modalità_hvac_precedente

Consente di visualizzare l'ultimo selezionato hvac_mode . Utilizzato quando si passa dalla hvac_mode = eco su un dispositivo con firmware obsoleto.

Per ulteriori informazioni sul passaggio betwen modalità non-Eco Eco e, consultare la Guida termostato .

Dettagli
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
ritorna	string Valori: "caldo", "freddo", "caldo-freddo", "off", vuoto (nessun valore)
Accesso	sola lettura
Disponibile in	Lettura termostato / v6 Lettura/scrittura termostato / v6