O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Alarme de fumaça + CO

Alarme de fumaça + CO

Nest Protect é projetado para detectar fumaça e monóxido de carbono (CO) em um ambiente residencial, com vários sensores para ajudar a entender o que está acontecendo na casa.

A API Nest fornece acesso aos seguintes dados sobre Nest Protect:

  • Status de alarme de fumaça ou monóxido de carbono (CO)
  • Estado de saúde da bateria
  • Último status de teste manual e carimbo de data / hora
  • Status online e última informação de conexão
  • Nome da estrutura e dispositivo "onde nome" (localização na casa)

Permissões de fumaça + CO

Para acesso de leitura a todos os valores de dados de alarme API + CO fumo, selecione o Smoke + CO ler permissão para o seu cliente.

Não há permissões de gravação disponíveis para a API de alarme Smoke + CO.

Identificadores de fumaça + CO

Dispositivo

Os dispositivos Nest são listados por tipo como uma série de IDs, que podem ser usados ​​para identificar exclusivamente um dispositivo por meio do caminho do dispositivo. Então a + co ID alarme de fumo de "RTMTKxs..." significa que você pode carregar o + co modelo de dispositivo de alarme de fumaça em devices/smoke_co_alarms/RTMTKxs... por meio da API.

Quando um dispositivo é conectado a vários produtos, cada desenvolvedor verá um ID diferente para aquele dispositivo. Para um dispositivo que instalou vários produtos do mesmo desenvolvedor, o desenvolvedor verá o mesmo ID.

Nome

Dois atributos de nome são fornecidos. Quanto mais curto name atributo é exibido em etiquetas de interface do usuário, enquanto name_long é utilizado em longo texto formulário.

name

Neste exemplo, name é "Nest Protect".

Nome

name_long

Neste exemplo, name_long é "Basement Nest Protect".

Nome longo

Onde

where_id

  • Um identificador exclusivo, gerado-Nest que representa name
  • where_id é só de leitura, e é criado automaticamente na chamada para criar um personalizado, onde name

Saiba mais sobre onde nomes para termostatos Ninho ,Ninho Protege e ninho de webcams .

where_name

Quando você escolhe o Smoke + CO permissão de leitura , você pode acessar o dispositivo where_name do objeto de dispositivo ( devices/smoke_co_alarms ).

Outros metadados

Todos os valores de dados são somente leitura, a menos que seja especificado de outra forma.

Valor de Dados Descrição
locale O idioma e o código do país atribuídos a este dispositivo
software_version Uma string que representa o firmware atualmente instalado no dispositivo
structure_id Uma string que representa exclusivamente esta estrutura; esta é a estrutura com a qual o dispositivo está emparelhado
last_connection O carimbo de data / hora da última conexão bem-sucedida com o serviço Nest
is_online Status online. Isto é determinado pelo ninho usando o last_connection tempo e de uma janela de religação esperado que é específico do dispositivo.

Recursos do Smoke + CO

Saúde da bateria

Use o battery_health campo para ver o estado de saúde da bateria.

Valor Descrição
ok Nível de bateria ok
replace Nível de bateria baixo, deve ser substituído

Alarme CO

Use o co_alarm_state campo para ver o estado de alarme CO.

Valor Descrição
ok Operação normal
warning Detecção de níveis crescentes de CO
emergency Níveis de CO muito altos, o usuário deve sair de casa

Alarme de fumo

Use o smoke_alarm_state campo para ver o estado de alarme de fumaça.

Valor Descrição
ok Operação normal
warning Detecção de níveis crescentes de fumaça
emergency Níveis de fumaça muito altos, o usuário deve sair de casa

Teste manual

Use esses campos para verificar se um teste manual de fumaça ou CO está ativo no momento e a última vez que um teste de fumaça ou CO foi realizado com sucesso.

Estado da cor da IU

Para torná-lo mais fácil de projetar uma interface entre produtos coerente, nós fornecemos o ui_color_state campo, o que dá uma indicação de alto nível do estado geral do Nest Protect. É derivado de is_online , battery_health , co_alarm_state e smoke_alarm_state , proporcionando uma condição de agregado que reflete os indicadores de cor reais exibidos no app Nest .

Mensagens de erro

Para obter informações sobre o que os erros de chamadas API significa e como lidar com eles, ver mensagens de erro .