L'API Nest funziona con tutti i modelli di Nest Learning ThermostatTM, ad eccezione di Thermostat E con Heat Link nell'Unione Europea.
Gli utenti possono aggiungere più termostati Nest al gruppo devices/thermostats
, fino al numero massimo per struttura.
Quando effettui una chiamata a questa posizione, puoi accedere ai dati di Nest Thermostat (valori dei dati per i dispositivi nella struttura).
Tutti i valori riportati di seguito si trovano sotto
devices/thermostats/device_id
nel documento JSON.
ID dispositivo
Identificatore univoco di Nest Thermostat.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/device_id |
|
Resi | string Esempio: "peyiJNo0IldT2YlIVtYaGQ" |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
locale
Specifica la lingua e l'area geografica (o il paese).
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locale |
|
Resi | string Esempi: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL" |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
versione_software
Versione software
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/software_version |
|
Resi | string Esempio: "4.0" |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
struttura_id
Identificatore univoco della struttura.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/structure_id |
|
Resi | string Esempio: "VqFabWH21nw..." |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
nome
Nome visualizzato del dispositivo. Può essere qualsiasi nome di stanza virtuale da un elenco fornito da noi o un nome personalizzato.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/name |
|
Resi | string Esempio: "Corridoio" |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
nome_lungo
Nome visualizzato lungo del dispositivo. Include un'etichetta personalizzata (etichettata), creata dall'utente
o tramite wheres
.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/name_long |
|
Resi | string Esempio: "Termostato corridoio (piano superiore)" |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
ultima_connessione
Timestamp dell'ultima interazione con il servizio Nest, in formato ISO 8601.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/last_connection |
|
Resi | string Esempio: "2016-12-31T23:59:59.000Z" |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
è_online
Stato della connessione del dispositivo al servizio Nest.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/is_online |
|
Resi | boolean Valori: true, false |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
can_cool
Capacità del sistema di raffreddamento (con CA).
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/can_cool |
|
Resi | boolean Valori: true, false |
Accesso | sola lettura |
Disponibile in | Lettura del 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 |
|
Resi | boolean Valori: true, false |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
is_using_emergency_heat
Stato di riscaldamento di emergenza in impianti con pompe di calore per il raffreddamento.
Quando il riscaldamento di emergenza è acceso:
- L'utente può regolare la temperatura ottimale sul dispositivo, ma non può cambiare la modalità finché l'impianto di riscaldamento di emergenza non viene spento
- Il
hvac_mode
può comunque essere modificato tramite l'API
Vedi Che cos'è il riscaldamento 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 |
|
Resi | boolean Valori: true, false |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
has_fan
Capacità del sistema di controllare la ventola indipendentemente dal riscaldamento o dal raffreddamento.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/has_fan |
|
Resi | boolean Valori: true, false |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
fan_timer_attivo
Indica se il timer della ventola è coinvolto; utilizzata con
fan_timer_duration
per attivare la ventola
per una durata predefinita specificata dall'utente.
Consulta Controllo avanzato dei fan per ulteriori informazioni su come i clienti impostano la durata del ventilatore.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_active |
|
Resi | boolean Valori: true, false |
Accesso | lettura/scrittura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
timeout_timer
Timestamp che mostra quando il timer della ventola raggiunge 0 (ora di fine), in formato ISO 8601.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_timeout |
|
Resi | string Esempio: "2016-12-31T23:59:59.000Z" |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
has_leaf
Viene mostrato quando il termostato è impostato su una temperatura di risparmio energetico.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/has_leaf |
|
Resi | boolean Valori: true, false |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
temperatura_scala
Fahrenheit o Celsius; utilizzato con il display della temperatura.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/temperature_scale |
|
Resi | string enum Valori: "F", "C" |
Accesso | lettura/scrittura |
Disponibile in | Lettura: Lettura del termostato / v1-v6 Lettura/scrittura del termostato / v1-v6 Scrittura: lettura del termostato/scrittura / v5-v6 |
temperatura_target_f
Temperatura richiesta, in gradi Fahrenheit (1 °F). Utilizzato quando
hvac_mode
= heat
o cool
.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_f |
|
Resi | number Esempio: 72 |
Intervallo | 50-90 |
Accesso | lettura/scrittura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
temperatura_target_c
Temperatura richiesta, in mezzo grado Celsius, 0,5°C. Utilizzato quando
hvac_mode
= heat
o cool
.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_c |
|
Resi | number Esempio: 21.5 |
Intervallo | 9-32 |
Accesso | lettura/scrittura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
target_temperature_high_f
Temperatura ottimale massima, visualizzata in gradi interi (1° F).
Utilizzato quando hvac_mode
= heat-cool
(modalità Caldo • Freddo).
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_f |
|
Resi | number Esempio: 80 |
Accesso | lettura/scrittura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
target_temperature_high_c
Temperatura ottimale massima, visualizzata in mezzo grado Celsius (0,5 °C). Utilizzato
quando hvac_mode
= heat-cool
(modalità Caldo
Freddo).
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_c |
|
Resi | number Esempio: 24.5 |
Accesso | lettura/scrittura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
target_temperature_low_f
Temperatura ottimale minima, visualizzata in gradi Fahrenheit (1 °F).
Utilizzato quando hvac_mode
= heat-cool
(modalità Caldo • Freddo).
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_f |
|
Resi | number Esempio: 65 |
Accesso | lettura/scrittura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
target_temperature_low_c
Temperatura ottimale minima, visualizzata in mezzo grado (0,5 °C). Utilizzato
quando hvac_mode
= heat-cool
(modalità Caldo
Freddo).
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_c |
|
Resi | number Esempio: 19.5 |
Accesso | lettura/scrittura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
eco_temperature_high_f
Temperatura Eco massima, visualizzata in gradi Fahrenheit (1° F). Utilizzato
quando hvac_mode
= eco
.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_f |
|
Resi | number Esempio: 80 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v6 Lettura/scrittura/termostato/v6 |
eco_temperature_high_c
Temperatura Eco massima, visualizzata in mezzo grado Celsius (0,5°C). Utilizzato
quando hvac_mode
= eco
.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_c |
|
Resi | number Esempio: 24.5 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v6 Lettura/scrittura/termostato/v6 |
eco_temperature_low_f
Temperatura Eco minima visualizzata in gradi Fahrenheit (1 °F). Utilizzato
quando hvac_mode
= eco
.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_f |
|
Resi | number Esempio: 65 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v6 Lettura/scrittura/termostato/v6 |
eco_temperature_low_c
Temperatura Eco minima, visualizzata in mezzo grado Celsius (0,5°C). Utilizzato
quando hvac_mode
= eco
.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_c |
|
Resi | number Esempio: 19.5 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v6 Lettura/scrittura/termostato/v6 |
away_temperature_high_f (DEPRECATO)
Temperatura massima fuori casa, visualizzata in gradi Fahrenheit (1 °F).
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_f |
|
Resi | number Esempio: 80 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
away_temperature_high_c (DEPRECATO)
Temperatura massima assente, visualizzata in mezzo Celsius (0,5 °C).
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_c |
|
Resi | number Esempio: 24.5 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
away_temperature_low_f (DEPRECATO)
Temperatura minima totale, visualizzata in gradi interi (1° F).
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_f |
|
Resi | number Esempio: 65 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
away_temperature_low_c (DEPRECATO)
Temperatura minima minima, visualizzata in gradi Celsius a 0,5 °C.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_c |
|
Resi | number Esempio: 19.5 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
modalità_HVAC
Indica le modalità Riscaldamento/raffreddamento dell'impianto HVAC, ad esempio Caldo • Freddo per impianti con capacità di riscaldamento e raffreddamento o Temperature Eco per il risparmio energetico.
hvac_mode
può essere modificato se il termostato è bloccatotarget_temperature_f
etarget_temperature_c
non possono essere modificati sehvac_mode
=off
oeco
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode |
|
Resi | string enum Valori: "heat", "cool", "heat-cool", "eco", "off" |
Accesso | lettura/scrittura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
ambiente_temperatura_f
Temperatura misurata sul dispositivo, in gradi Fahrenheit.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_f |
|
Resi | number Esempio: 72 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
ambiente_temperatura_c
Temperatura, misurata al dispositivo, in mezzo gradi Celsius (0,5 °C).
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_c |
|
Resi | number Esempio: 21.5 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v1-v6 Lettura/scrittura/termostato/v1-v6 |
umidità
Umidità, in percentuale (%), misurata al dispositivo, arrotondata al 5% più vicino.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/humidity |
|
Resi | number Esempio: 35 |
Intervallo | 0-100 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato / v2-v6 Lettura/scrittura del termostato / v2-v6 |
stato_hvac
Indica se l'impianto HVAC è in fase di riscaldamento, raffreddamento o è spento. Utilizza questo valore per indicare lo stato dell'attività HVAC.
Quando off
, l'impianto HVAC non è attivo per il riscaldamento o il raffreddamento. hvac_state
non dipende dal funzionamento della ventola.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/hvac_state |
|
Resi | string enum Valori: "riscaldamento", "raffreddamento", "off" |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v3-v6 Lettura/scrittura/termostato/v3-v6 |
Dove_id
Un identificatore univoco generato da Nest che rappresenti
name
, il nome visualizzato del dispositivo.
Scopri di più sui nomi di Nest Thermostat, Nest Protect e Nest Cam.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/where_id |
|
Resi | string Esempio: "d6reb_OZTM..." |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v4-v6 Lettura/scrittura/termostato/v4-v6 |
è_bloccato
Stato di blocco del termostato. Se impostato su vero, la funzionalità Blocco
termostato
è attivata e limita l'intervallo di temperature a 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 |
|
Resi | boolean Valori: true, false |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v5-v6 Lettura/scrittura/termostato/v5-v6 |
bloccata_temp_min_f
Temperatura minima di blocco del termostato, visualizzata in gradi interi (1°F). Utilizzato quando
is_locked
è true
.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_f |
|
Resi | string Esempio: 65 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v5-v6 Lettura/scrittura/termostato/v5-v6 |
bloccata_temp_max_f
Temperatura massima di blocco del termostato, visualizzata in gradi interi (1°F). Utilizzato quando
is_locked
è true
.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_f |
|
Resi | string Esempio: 80 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v5-v6 Lettura/scrittura/termostato/v5-v6 |
bloccata_temp_min_c
Temperatura minima di blocco del termostato, visualizzata in mezzo grado Celsius (0,5 °C). Utilizzato
quando is_locked
è true
.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_c |
|
Resi | string Esempio: 19.5 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v5-v6 Lettura/scrittura/termostato/v5-v6 |
bloccata_temp_max_c
Temperatura massima di blocco del termostato, visualizzata in mezzo grado Celsius (0,5 °C). Utilizzato
quando is_locked
è true
.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_c |
|
Resi | string Esempio: 24.5 |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v5-v6 Lettura/scrittura/termostato/v5-v6 |
etichetta
Etichetta personalizzata del termostato. Viene visualizzato tra parentesi, dopo il nome del luogo.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/label |
|
Resi | string Esempi: "Piano superiore", "Stanza", "Stanza" |
Accesso | lettura/scrittura |
Disponibile in | Lettura: Lettura del termostato / v6 Lettura/scrittura del termostato / v6 Scrittura: lettura/scrittura del termostato / v5 -v6 |
luce_corretta_attivata
Stato abilitato per Sunblock. Utilizzato con
sunlight_correction_active
.
Quando la funzionalità true
, la funzionalità Sunblock è attivata e il termostato si regola automaticamente per la luce diretta del sole, legge e imposta la temperatura corretta.
Per ulteriori informazioni, consulta la pagina relativa a Sunblock.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_enabled |
|
Resi | boolean Valori: true, false |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v6 Lettura/scrittura/termostato/v6 |
luce_corretta_attiva
Stato attivo di Sunblock. Utilizzato con
sunlight_correction_enabled
.
Se true
, indica che il termostato si trova alla luce diretta del sole.
Per ulteriori informazioni, consulta la pagina relativa a Sunblock.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_active |
|
Resi | boolean Valori: true, false |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v6 Lettura/scrittura/termostato/v6 |
nome_dove
Il nome visualizzato del dispositivo. Associata al termostato
where_id
. Può essere il nome di una stanza virtuale
da un elenco fornito da noi o un nome personalizzato. Scopri di più sui nomi di Nest Thermostat, Nest Protect e Nest Cam.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/where_name |
|
Resi | string Esempio: "Corridoio" |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v6 Lettura/scrittura/termostato/v6 |
fan_timer_duration
Specifica il periodo di tempo (in minuti) in cui il ventilatore è impostato per l'esecuzione.
L'impostazione fan_timer_active
attiva la ventola. Il valore fan_timer_timeout
indica il timestamp impostato su fan_timer_duration
per la fine.
Per informazioni su come i clienti impostano il timer della ventola, vedi Durata del timer.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_duration |
|
Resi | int Valori: 15, 30, 45, 60, 120, 240, 480, 720 |
Accesso | lettura/scrittura |
Disponibile in | Lettura: Lettura del termostato / v6 Lettura/scrittura del termostato / v6 Scrittura: lettura/scrittura del termostato / v6 |
ora_target
Il tempo, in minuti, necessario alla struttura per raggiungere la temperatura ottimale.
Per ulteriori informazioni, consulta Tempo per raggiungimento temperatura.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target |
|
Resi | string enum Valori: "~0", "<5", "~15", "~90", "120" |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v6 Lettura/scrittura/termostato/v6 |
tempo_di_formazione_target
In modalità di addestramento, Nest Thermostat apprende l'impianto HVAC e
rileva il tempo necessario per raggiungere la temperatura ottimale. Quando il termostato dispone di informazioni sufficienti a fare una stima ragionevole del tempo per raggiungere la temperatura ottimale, questo valore cambierà da training
a ready
.
Per ulteriori informazioni, consulta Tempo per raggiungimento temperatura.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target_training |
|
Resi | string enum Valori: "training", "ready" |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v6 Lettura/scrittura/termostato/v6 |
previous_hvac_mode
Mostra l'ultimo elemento hvac_mode
selezionato. Utilizzato quando si passa da hvac_mode
= eco
su un dispositivo con firmware obsoleto.
Per scoprire di più sul passaggio tra le modalità Eco e non Eco, consulta la Guida al termostato.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/previous_hvac_mode |
|
Resi | string Valori: "heat", "cool", "heat-cool", "off", vuoto (nessun valore) |
Accesso | sola lettura |
Disponibile in | Lettura del termostato/v6 Lettura/scrittura/termostato/v6 |