Google is committed to advancing racial equity for Black communities. See how.

Allarme fumo+CO

Rilevatore di fumo + CO

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

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

  • Stato allarme fumo o monossido di carbonio (CO)
  • Stato di salute della batteria
  • Stato dell'ultimo test manuale e timestamp
  • Stato online e informazioni sull'ultima connessione
  • Nome struttura e dispositivo "where name" (posizione in casa)

Permessi Fumo+CO

Per l'accesso in lettura a tutti i valori di dati API rilevatore di fumo + CO, selezionare il fumo + CO leggere il permesso per il vostro cliente.

Non sono disponibili permessi di scrittura per l'API di allarme fumo+CO.

Identificatori di fumo+CO

Dispositivo

I dispositivi Nest sono elencati per tipo come una serie di ID, che possono essere utilizzati per identificare in modo univoco un dispositivo tramite il percorso del dispositivo. Così un fumo + co ID allarme "RTMTKxs..." significa che è possibile caricare il + co modello del dispositivo rilevatore di fumo a 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 dello stesso sviluppatore, lo sviluppatore vedrà lo stesso ID.

Nome

Vengono forniti due attributi del nome. Il più breve name attributo viene visualizzato nelle etichette dell'interfaccia utente, mentre name_long è usato in forma di testo lungo.

name

In questo esempio, name è "Nest Protect".

Nome

name_long

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

Nome lungo

Dove

where_id

  • Un unico, identificatore Nest-generato che rappresenta name
  • where_id è di sola lettura, e viene creato automaticamente nella chiamata per creare un costume in cui name

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

where_name

Quando si sceglie il fumo + CO permesso di lettura , è 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 codice del paese 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. Questo è determinato utilizzando il Nest last_connection tempo e una finestra riconnessione atteso che è un dispositivo specifico.

Caratteristiche Fumo+CO

Stato della batteria

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

Valore Descrizione
ok Livello della batteria ok
replace Batteria scarica, da sostituire

Allarme CO

Utilizzare il co_alarm_state campo per visualizzare lo stato di allarme di 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 lo smoke_alarm_state campo per visualizzare lo stato di allarme fumo.

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

Prova manuale

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

Stato del colore dell'interfaccia utente

Per rendere più facile progettare un coerente interfaccia utente cross-product, abbiamo fornito il ui_color_state campo, che dà un'indicazione di alto livello dello stato generale del Nest Protect. È derivato da is_online , battery_health , co_alarm_state e smoke_alarm_state , fornendo una condizione di aggregato che riflette gli indicatori di colore effettivi visualizzati in app nido .

Messaggio di errore

Per informazioni su quali errori chiamata API significano e come gestirli, vedere Messaggi di errore .