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.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Fumo + allarme CO

Fumo + allarme CO

Nest Protect è progettato per rilevare fumo e monossido di carbonio (CO) in un ambiente residenziale, con più sensori per aiutarlo a capire cosa sta succedendo in casa.

L' API Nest fornisce l'accesso ai seguenti dati su Nest Protect:

  • Stato di allarme fumo o monossido di carbonio (CO)
  • Stato di salute della batteria
  • Stato e data e ora dell'ultimo test manuale
  • Stato online e informazioni sull'ultima connessione
  • Nome struttura e dispositivo "dove nome" (posizione nella casa)

Fumo + autorizzazioni CO

Per l'accesso in lettura a tutti i valori dei dati dell'API di allarme Smoke + CO, selezionare l'autorizzazione di lettura Smoke + CO per il client.

Non sono disponibili autorizzazioni di scrittura per l'API di allarme Smoke + CO.

Identificatori di fumo + CO

Dispositivo

I dispositivi Nest sono elencati per tipo come una matrice di ID, che può essere utilizzata per identificare in modo univoco un dispositivo tramite il percorso del dispositivo. Quindi un ID allarme fumo + co di "RTMTKxs..." significa che è possibile caricare il modello del dispositivo di allarme smoke + co su devices/smoke_co_alarms/RTMTKxs... tramite l'API.

Quando un dispositivo è connesso a più prodotti, ogni sviluppatore vedrà un ID diverso per quel dispositivo. Per un dispositivo che ha installato più prodotti dallo stesso sviluppatore, lo sviluppatore vedrà lo stesso ID.

Nome

Sono forniti due attributi di nome. L'attributo del name più breve viene visualizzato nelle etichette dell'interfaccia utente, mentre name_long viene utilizzato nel testo in formato lungo.

name

In questo esempio, il name è "Nest Protect".

Nome

name_long

In questo esempio, name_long è "Basement Nest Protect".

Nome lungo

Dove

where_id

  • Un identificatore univoco, generato da Nest, che rappresenta il name
  • where_id è di sola lettura e viene creato automaticamente nella chiamata per creare un name dove personalizzato

Scopri di più sui nomi dei termostati Nest , Nest Protects e Nest Cams .

where_name

Quando si sceglie l' autorizzazione di lettura Smoke + CO , è possibile accedere al dispositivo where_name dall'oggetto dispositivo ( devices/smoke_co_alarms ).

Altri metadati

Tutti i valori dei dati sono di sola lettura, se non diversamente specificato.

Valore dei dati Descrizione
locale La lingua e il prefisso internazionale assegnati a questo dispositivo
software_version Una stringa che rappresenta il firmware attualmente installato sul dispositivo
structure_id Una stringa che rappresenta in modo univoco questa struttura; questa è la struttura a cui è associato il dispositivo
last_connection Il timestamp dell'ultima connessione riuscita al servizio Nest
is_online Stato online. Ciò viene determinato da Nest utilizzando l'ora last_connection e una finestra di riconnessione prevista specifica del dispositivo.

Caratteristiche di fumo + CO

Salute della batteria

Utilizzare il campo battery_health per visualizzare lo stato di battery_health della batteria.

Valore Descrizione
ok Livello batteria ok
replace Batteria scarica, dovrebbe essere sostituita

Allarme CO

Utilizzare il campo co_alarm_state per visualizzare lo stato di allarme CO.

Valore Descrizione
ok Operazione normale
warning Rilevamento di livelli di CO in aumento
emergency Livelli di CO troppo alti, l'utente dovrebbe uscire di casa

Allarme antincendio

Utilizzare il campo smoke_alarm_state per visualizzare lo stato dell'allarme fumo.

Valore Descrizione
ok Operazione normale
warning Rilevazione di livelli di fumo in aumento
emergency Livelli di fumo troppo alti, l'utente dovrebbe uscire di casa

Test manuale

Utilizzare questi campi per verificare se è attualmente attivo un test manuale del fumo o del CO e l'ultima volta che è stato eseguito con successo un test del fumo o del CO.

Stato del colore dell'interfaccia utente

Per semplificare la progettazione di un'interfaccia utente coerente tra prodotti, abbiamo fornito il campo ui_color_state , che fornisce un'indicazione di alto livello dello stato generale di Nest Protect. Deriva da is_online , battery_health , co_alarm_state e smoke_alarm_state , fornendo una condizione aggregata che riflette gli indicatori di colore effettivi visualizzati nell'app Nest .

Messaggio di errore

Per informazioni sul significato degli errori di chiamata API e su come gestirli, vedere Messaggi di errore .