Google s'est engagé à promouvoir l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Loin & amp; ETA

Une façon

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

Fonctionnement de la maison et de l'extérieur

Nest utilise une variété de 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 définit automatiquement la maison sur Absent. Lorsqu'il détecte la présence humaine, il ramène la structure à l'état d'origine.

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 est en mode absence pour économiser l'énergie
  • Envoyer une notification si la porte du garage est ouverte lorsque la maison est absente
  • Écouter de la musique lorsque la maison passe à la maison

Comment fonctionne 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 entrer manuellement son ETA. Ou peut-être que l'ETA est calculée 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ée 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 rédigé par un développeur Nest à l'aide de l' appel d'API PUT eta écriture seule.
  2. Le thermostat Nest utilise ces données.
  3. Si d'autres développeurs souhaitent également l'utiliser, ils peuvent utiliser l' appel d'API GET eta_begin lecture seule.
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 à l'approche de la maison
  • Ouvrez la porte du garage lorsque l'utilisateur est presque à la maison
  • Avoir de la musique déjà 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 liées à l'absence :



Accès

Lecture à l'extérieur
Lecture / écriture absent

ETA lire

ETA lecture / écriture

Lecture alarme fumée + CO
Lecture du thermostat
Lecture / écriture du thermostat
away Oui Oui Oui
eta_begin (lecture seule) Oui Oui
objet eta (écriture seule) Oui

Pour plus d'informations, consultez la vue d'ensemble des autorisations .

Fonctionnalités d'absence

À la maison et à l'extérieur

La valeur des données d' away peut vous indiquer si Nest pense que 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 est très fiable à 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 défini la structure comme étant absent, soit via l' application Nest , le thermostat Nest ou votre produit.
unknown Si aucun périphérique n'est associé à la structure, l'état d'absence est unknown .

L'API Nest offre la possibilité de définir directement Chez moi et Absent, ainsi que d'écouter les modifications apportées à ces états. Cependant, lorsque vous définissez Chez moi et Absent, vous devez le faire comme l' application Nest : à la suite d'une demande explicite de l'utilisateur. Essayer de définir cet état de manière algorithmique risque de créer une expérience utilisateur déroutante et est interdit par les politiques de conception Nest .

Sachez que les utilisateurs ont toujours la possibilité de définir manuellement l'état Chez moi / Absent.

En savoir plus sur la manière dont les utilisateurs définissent les états Chez moi et Absent .

ETA

Une façon

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

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Étant donné que les circonstances entourant les voyages peuvent changer en raison de la circulation, de la modification des plans utilisateur 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 des 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.

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

Passer un appel d'écriture ETA

La logique ETA dépend de la présence d'un thermostat dans la structure. Si aucun thermostat n'existe dans la structure, les appels effectués vers l'objet ETA échouent avec le message d'erreur "Aucun appareil couplé" . 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 des données

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

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

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

Chaque appel ETA doit inclure une chaîne trip_id unique que vous définissez dans l'appel initial. D'autres paramètres peuvent changer avec des appels successifs au 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 un ETA, envoyez estimated_arrival_window_begin = 0 . Vérifiez que vous envoyez un entier (0) dans cet appel et non une chaîne ("0"), sinon l'appel échouera.

Messages d'erreur

Pour plus d'informations sur la signification des erreurs d'appel d'API et sur la manière de les gérer, consultez Messages d'erreur .