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

Absent et ETA

Un moyen

Dans l'API Nest, le concept de « Chez » ou « Absent » a un effet puissant sur les comportements des fonctionnalités d'économie d'énergie et de commodité de Nest.

Comment fonctionne Chez moi et Absent

Nest utilise divers signaux pour détecter la présence humaine dans une maison. Si Nest ne détecte aucune présence pendant une période prolongée, il règle automatiquement la maison sur Absent. Lorsqu'il détecte une présence humaine, il ramène la structure à l'état Home.

Réagir aux changements de statut Chez moi/Absent ouvre un large éventail d'opportunités pour vos produits. Par exemple, vos produits peuvent :

  • Éteignez les lumières lorsque la maison passe en mode Absence pour économiser l'énergie
  • Envoyer une notification si la porte du garage est ouverte lorsque la maison est absente
  • Jouer de la musique lorsque la maison passe à la maison

Comment fonctionne l'ETA

Dans certains cas, les utilisateurs disposent d'une application tierce qui utilise le GPS pour fournir des données d'heure d'arrivée estimée (ETA) à l'API Nest. Dans d'autres cas, l'utilisateur peut utiliser une application pour saisir manuellement son ETA. Ou peut-être que l'ETA est calculé en fonction de l'horaire régulier de l'utilisateur.

Les applications ETA intégrées au thermostat Nest font que le thermostat commence à chauffer ou à refroidir la maison avant l'arrivée de l'utilisateur.

Lorsque l'intégration ETA/thermostat existe dans le compte de l'utilisateur, les données ETA sont disponibles pour que d'autres développeurs Works with Nest les utilisent dans leurs intégrations Works with Nest.

Une fois l'ETA entré dans le service Nest, une autre intégration Works with Nest peut l'utiliser comme signal pour préparer la maison à l'arrivée de l'utilisateur.

  1. L'ETA est écrit par un développeur Nest en utilisant l'écriture seule PUT eta appel API .
  2. Le thermostat Nest utilise ces données.
  3. Si d' autres développeurs veulent l' utiliser aussi, ils peuvent utiliser la lecture seule GET eta_begin API appel .
Données ETA

Le point important à garder à l'esprit est que les données ETA doivent être saisies par un tiers. Nest ne fournit actuellement pas de données ETA. Si les données ETA n'ont pas été écrites, l'API Nest renvoie la valeur par défaut "1970-01-01T00:00:00.000Z".

Supposons, par exemple, que vous soyez un fournisseur d'éclairage. Vous pouvez obtenir les données ETA fournies par l'intégration ETA/thermostat et les utiliser comme signal pour allumer les lumières.

De cette façon, non seulement la température est confortable, mais les lumières sont également allumées lorsque l'utilisateur arrive à la maison.

Réagir aux changements de statut ETA ouvre un large éventail d'opportunités pour vos produits. Par exemple, vos produits peuvent :

  • Allumez le téléviseur lorsque l'utilisateur s'approche de la maison
  • Ouvrir la porte du garage lorsque l'utilisateur est presque à la maison
  • Avoir déjà de la musique en cours de lecture lorsque l'utilisateur rentre chez lui

Autorisations d'absence

Les niveaux d'autorisation d'accès suivants sont disponibles pour les valeurs de données loin LIES :



Accès

Lire à l'extérieur
Lecture/écriture absente

ETA lu

ETA lecture/écriture

Lecture d'alarme fumée+CO
Thermostat lu
Thermostat lecture/écriture
away Oui Oui Oui
eta_begin (lecture seule) Oui Oui
eta objet (écriture seulement) Oui

Pour plus d' informations, consultez la Présentation des autorisations .

Fonctionnalités d'absence

À la maison et à l'extérieur

La away valeur de données peut vous dire si Nest pense la structure est occupée. Les valeurs possibles sont :

Valeur La description
home Il y a quelqu'un dans la structure. Cet état peut être défini :
• par Nest s'il a une confiance élevée à partir des données du capteur de mouvement
• par l'utilisateur via l' application Nest , le thermostat Nest, ou votre produit
• algorithmiquement via ETA
away Il n'y a personne dans la structure. L'utilisateur a explicitement mis la structure à distance, que ce soit via l' application Nest , le thermostat Nest, ou votre produit.
unknown Si aucun périphérique sont associés à la structure, l'état est loin unknown .

L'API Nest offre la possibilité de définir directement les modes Chez moi et Absent, ainsi que d'écouter les modifications apportées à ces états. Cependant, lors de la mise à domicile et ailleurs, cela devrait être fait que l' application Nest le fait: à la suite d'une demande explicite de l' utilisateur. Essayer de mettre algorithmiquement cet état court le risque de créer une expérience utilisateur et la confusion est interdite par les politiques de conception Nest .

Sachez que les utilisateurs ont toujours la possibilité de régler manuellement la maison / état loin.

En savoir plus sur la façon dont les utilisateurs RÉGLER et états à l' extérieur .

ETA

Un moyen

ETA est un objet avec des champs qui peuvent être réglés sur une structure. Il est utilisé pour informer Nest qu'un utilisateur doit rentrer chez lui à une heure précise. Lors du réglage de l'ETA, un produit unique , génère un trip_id et fournit une fenêtre d'arrivée prévue, indiquée par les valeurs suivantes:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Étant donné que les circonstances entourant les déplacements peuvent changer en raison de la circulation, des plans des utilisateurs modifiés et d'autres événements, les produits doivent mettre à jour l'ETA périodiquement au fur et à mesure que le voyage progresse, fournissant à Nest un flux d'heures d'arrivée estimées (5 minutes est un intervalle idéal).

Plus nous recevons d'informations, plus nous pouvons être confiants dans la fiabilité des entrées ETA, ce qui nous rend plus confiants lorsque nous prenons des mesures pour préparer la maison.

L'ETA est indépendant de l'État d'origine. Si l'heure d'arrivée d'un ETA entre en conflit avec un autre ETA, l'heure d'arrivée la plus proche prévaut.

Faire un appel d'écriture ETA

La logique ETA dépend de la présence d'un thermostat dans la structure. Si aucun thermostat existe dans la structure, les appels à fait l'objet d'ETA échouer avec le « non apparié dispositifs » message d'erreur. Cette erreur se produit même si d'autres types d'appareils existent dans la structure (par exemple, une Nest Cam ou un Nest Protect).

Valeurs de données

Un appel ETA nécessite les valeurs de données suivantes :

Nom Taper La description
trip_id chaîne Identifiant de voyage ETA unique
estimated_arrival_window_begin chaîne Horodatage
Doit être supérieur à NOW , dans ISO 8601 Format
estimated_arrival_window_end chaîne Horodatage
Doit être supérieur à estimated_arrival_window_begin , dans ISO 8601 Format

En raison de la possibilité d'interruptions de connexion dans les communications GPS, nous suggérons un flux d'échantillons, idéalement une fois toutes les 5 minutes.

Chaque appel de l' ETA doit inclure une expérience unique trip_id chaîne que vous définissez dans l'appel initial. D' autres paramètres peuvent changer avec des appels successifs à la même trip_id .

Un appel ETA renvoie un code d'état HTTP 200 OK en cas de succès.

Exemples

Boucle
curl --location-trusted -X PUT -d \
  '{"trip_id":"sample-trip-id","estimated_arrival_window_begin":"2014-10-31T22:42:00.000Z","estimated_arrival_window_end":"2014-10-31T23:59:59.000Z"}' \
  "http://developer-api.nest.com/structures/5af48890-b516-11e3-9eff-123139166438/eta.json?auth=c.VG6bfzyOxAltaih6P4v..."

Annuler un ETA

Pour annuler une eta, envoyez estimated_arrival_window_begin = 0 . Vérifiez que vous envoyez un entier (0) dans cet appel, pas une chaîne ("0"), sinon l'appel échouera.

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 .