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

Détecteur de fumée + CO

Détecteur de fumée + CO

Nest Protect est conçu pour détecter la fumée et de monoxyde de carbone (CO) dans un environnement résidentiel, avec de multiples capteurs pour l' aider à comprendre ce qui se passe dans la maison.

L' API Nest permet d' accéder aux données suivantes sur NEST PROTECT:

  • État de l'alarme de fumée ou de monoxyde de carbone (CO)
  • État de santé de la batterie
  • État et horodatage du dernier test manuel
  • Statut en ligne et informations sur la dernière connexion
  • Nom de la structure et appareil "où nom" (emplacement dans la maison)

Autorisations Smoke+CO

Pour un accès en lecture à tous + CO fumée valeurs de données API d'alarme, sélectionnez la fumée + CO lu l' autorisation de votre client.

Aucune autorisation d'écriture n'est disponible pour l'API d'alarme Smoke+CO.

Identifiants fumée+CO

Appareil

Les appareils Nest sont répertoriés par type sous la forme d'un tableau d'ID, qui peut être utilisé pour identifier de manière unique un appareil via le chemin de l'appareil. Donc , une fumée + co alarme ID "RTMTKxs..." signifie que vous pouvez charger la fumée + modèle de dispositif d'alarme de co à des devices/smoke_co_alarms/RTMTKxs... via l'API.

Lorsqu'un appareil est connecté à plusieurs produits, chaque développeur verra un ID différent pour cet appareil. Pour un appareil qui a installé plusieurs produits du même développeur, le développeur verra le même ID.

Nom

Deux attributs de nom sont fournis. Le plus court name attribut est affiché dans les étiquettes de l' interface utilisateur, alors que name_long est utilisé dans le texte de forme longue.

name

Dans cet exemple, le name est « Nest Protect ».

Nom

name_long

Dans cet exemple, name_long est « Sous - sol Nest Protect ».

Nom long

where_id

  • Un identificateur unique, généré Nest qui représente le name
  • where_id est en lecture seule, et est automatiquement créé dans l'appel pour créer une coutume où le name

En savoir plus sur où les noms pour Nest Thermostats ,Nest Protect et Nest en direct .

where_name

Lorsque vous choisissez la fumée + CO lire la where_name devices/smoke_co_alarms permission , vous pouvez accéder au périphérique where_name de l'objet (dispositif devices/smoke_co_alarms ).

Autres métadonnées

Toutes les valeurs de données sont en lecture seule, sauf indication contraire.

Valeur des données La description
locale La langue et le code de pays attribués à cet appareil
software_version Une chaîne qui représente le firmware actuellement installé sur l'appareil
structure_id Une chaîne qui représente de manière unique cette structure ; il s'agit de la structure avec laquelle l'appareil est associé
last_connection L'horodatage de la dernière connexion réussie au service Nest
is_online Statut en ligne. Ceci est déterminé par Nest en utilisant le last_connection temps et une fenêtre de rebranchement prévu qui est spécifique à l' appareil.

Fonctionnalités Fumée+CO

Santé de la batterie

Utilisez le battery_health champ pour afficher l'état de santé de la batterie.

Valeur La description
ok Niveau de batterie ok
replace Niveau de batterie faible, doit être remplacée

Avertisseur de monoxyde de carbone

Utilisez le co_alarm_state champ pour afficher l'état d'alarme de CO.

Valeur La description
ok Fonctionnement normal
warning Détection des niveaux de CO en hausse
emergency Niveaux de CO trop élevés, l'utilisateur doit quitter la maison

Détecteur de fumé

Utilisez le smoke_alarm_state champ pour afficher l'état d'alarme de fumée.

Valeur La description
ok Fonctionnement normal
warning Détection des niveaux de fumée en hausse
emergency Niveaux de fumée trop élevés, l'utilisateur doit quitter la maison

Essai manuel

Utilisez ces champs pour vérifier si un test manuel de fumée ou de CO est actuellement actif et la dernière fois qu'un test de fumée ou de CO réussi a été effectué.

État de la couleur de l'interface utilisateur

Pour le rendre plus facile à concevoir une interface utilisateur multi-produits cohérente, nous avons fourni le ui_color_state champ, ce qui donne une indication de haut niveau de l'état général du NEST PROTECT. Il est dérivé de is_online , battery_health , co_alarm_state et smoke_alarm_state , fournissant une condition globale qui reflète les indicateurs de couleurs réelles affichées dans l' application Nest .

Messages d'erreur

Pour plus d' informations sur ce que les erreurs d'appel de l' API signifient et comment les gérer, voir les messages d'erreur .