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

Trasferta & ETA

Lontano

Nell'API Nest, il concetto di "Casa" o "Fuori casa" ha un potente effetto sui comportamenti delle funzionalità di risparmio energetico e convenienza di Nest.

Come funzionano A casa e Fuori

Nest utilizza una serie di segnali per rilevare la presenza umana in una casa. Se Nest non rileva alcuna presenza per un periodo di tempo prolungato, imposta automaticamente la casa su Fuori. Quando rileva la presenza umana, riporta la struttura allo stato Home.

Reagire ai cambiamenti nello stato A casa/Fuori apre una vasta gamma di opportunità per i tuoi prodotti. Ad esempio, i tuoi prodotti possono:

  • Spegni le luci quando la casa va in Away per risparmiare energia
  • Invia una notifica se la porta del garage è aperta quando la casa è assente
  • Riproduci musica quando la casa passa a Home

Come funziona l'ETA

In alcuni casi, gli utenti dispongono di un'app di terze parti che utilizza il GPS per fornire dati sull'orario di arrivo stimato (ETA) all'API Nest. In altri casi, l'utente potrebbe utilizzare un'app per inserire manualmente il proprio ETA. O forse l'ETA viene calcolato in base al programma regolare dell'utente.

Le app ETA integrate con il termostato Nest fanno in modo che il termostato inizi a riscaldare o raffreddare la casa prima che arrivi l'utente.

Quando l'integrazione ETA/termostato esiste nell'account dell'utente, i dati ETA sono disponibili per altri sviluppatori Works with Nest da utilizzare nelle loro integrazioni Works with Nest.

Dopo che l'ETA è stata inserita nel servizio Nest, un'altra integrazione Works with Nest può utilizzarla come segnale per preparare la casa all'arrivo dell'utente.

  1. L'ETA è scritto da uno sviluppatore Nest utilizzando la sola scrittura PUT eta chiamata API .
  2. Il termostato Nest utilizza questi dati.
  3. Se altri sviluppatori vogliono usarlo, troppo, possono utilizzare l'sola lettura GET eta_begin chiamata API .
Dati ETA

Il punto importante da tenere a mente è che i dati ETA devono essere inseriti da una terza parte. Nest non fornisce attualmente i dati ETA. Se i dati ETA non sono stati scritti, l'API Nest restituisce il valore predefinito "1970-01-01T00:00:00.000Z".

Supponiamo, ad esempio, di essere un venditore di luci. È possibile ottenere i dati ETA forniti dall'integrazione ETA/termostato e utilizzarli come segnale per accendere le luci.

In questo modo, non solo la temperatura è confortevole, le luci sono accese anche quando l'utente arriva a casa.

Reagire ai cambiamenti nello stato ETA apre una vasta gamma di opportunità per i tuoi prodotti. Ad esempio, i tuoi prodotti possono:

  • Accendi la TV quando l'utente si avvicina a casa
  • Aprire la porta del garage quando l'utente è quasi a casa
  • Avere la musica già in riproduzione quando l'utente torna a casa

Autorizzazioni in trasferta

I seguenti livelli di autorizzazione di accesso sono disponibili per i valori dei dati Away-correlati :



Accesso

fuori lettura
Lettura/scrittura in trasferta

ETA letto

ETA lettura/scrittura

Lettura allarme fumo+CO
Lettura termostato
Lettura/scrittura termostato
away
eta_begin (sola lettura)
eta oggetto (solo scrittura)

Per ulteriori informazioni, vedere la Permessi Panoramica .

Caratteristiche in trasferta

A casa e fuori casa

La away valore di dati può dire se Nest pensa che la struttura è occupata. I valori possibili sono:

Valore Descrizione
home C'è qualcuno nella struttura. Questo stato può essere impostato:
• da Nest se ha un'elevata confidenza dai dati del sensore di movimento
• dall'utente tramite l' app Nest , il termostato Nest, o il vostro prodotto
• algoritmicamente tramite ETA
away Non c'è nessuno nella struttura. L'utente ha impostato in modo esplicito la struttura di via, sia attraverso l' app Nest , il termostato Nest, o il vostro prodotto.
unknown Se nessun dispositivo sono associati con la struttura, lo stato di distanza è unknown .

L'API Nest offre la possibilità di impostare direttamente A casa e Fuori, nonché di ascoltare le modifiche a questi stati. Tuttavia, quando si impostano Home and Away, dovrebbe essere fatto come l'app Nest fa: come il risultato di una richiesta esplicita dell'utente. Cercando di impostare algoritmicamente questo stato corre il rischio di creare un'user experience di confusione ed è vietato dalle norme di progettazione Nest .

Essere consapevoli del fatto che gli utenti hanno sempre la possibilità di impostare manualmente lo stato di Home / Lontano.

Ulteriori informazioni su come gli utenti impostati casa e gli stati fuori casa .

ETA

Lontano

ETA è un oggetto con i campi che possono essere impostate su una struttura. Viene utilizzato per far sapere a Nest che un utente dovrebbe tornare a casa a un'ora specifica. Quando si imposta l'ETA, un prodotto genera un unico trip_id e fornisce una finestra prevista di arrivo, specificata dai seguenti valori:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Poiché le circostanze intorno ai viaggi possono cambiare a causa del traffico, dei piani utente modificati e di altri eventi, i prodotti dovrebbero aggiornare l'ETA periodicamente durante il viaggio, fornendo a Nest un flusso di tempi di arrivo stimati (5 minuti è un intervallo ideale).

Più informazioni riceviamo, più possiamo essere sicuri dell'affidabilità degli input ETA, il che ci rende più fiduciosi quando agiamo per preparare la casa.

L'ETA è indipendente dallo stato di residenza. Se l'orario di arrivo di un ETA è in conflitto con un altro ETA, ha la precedenza il primo orario di arrivo.

Effettua una chiamata scritta ETA

La logica ETA è subordinata alla presenza di un Termostato nella struttura. Se nessun termostato esiste nella struttura, le chiamate effettuate verso l'oggetto ETA non con il "No abbinato dispositivi" messaggio di errore. Questo errore si verifica anche se nella struttura sono presenti altri tipi di dispositivi (ad esempio, una Nest Cam o un Nest Protect).

Valori dei dati

Una chiamata ETA richiede i seguenti valori di dati:

Nome genere Descrizione
trip_id corda Identificatore univoco del viaggio ETA
estimated_arrival_window_begin corda Timestamp
Deve essere maggiore di NOW , in ISO 8601 formato
estimated_arrival_window_end corda Timestamp
Deve essere maggiore di estimated_arrival_window_begin , in ISO 8601 formato

A causa della possibilità di interruzioni della connessione nelle comunicazioni GPS, suggeriamo un flusso di campioni, idealmente una volta ogni 5 minuti.

Ogni chiamata ETA deve includere un unico trip_id stringa che si definisce nella chiamata iniziale. Altri parametri possono cambiare con chiamate successive alla stessa trip_id .

Una chiamata ETA restituisce un codice di stato HTTP 200 OK in caso di successo.

Esempi

Arricciare
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..."

Annulla un ETA

Per annullare un ETA, inviare estimated_arrival_window_begin = 0 . Verifica di inviare un numero intero (0) in questa chiamata, non una stringa ("0"), altrimenti la chiamata avrà esito negativo.

Messaggio di errore

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