Google si impegna a promuovere l'equità razziale per le comunità nere. Vedi come.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Away & amp; ETA

Lontano

Nell'API Nest, il concetto di "Casa" o "Lontano" ha un forte effetto sui comportamenti dei risparmi energetici e sulle caratteristiche di convenienza di Nest.

Come funziona Home and Away

Nest utilizza una varietà di segnali per rilevare la presenza umana in una casa. Se Nest non rileva alcuna presenza per un lungo periodo di tempo, imposta automaticamente la casa su Assente. Quando rileva la presenza umana, restituisce la struttura allo stato di origine.

La reazione ai cambiamenti nello stato Casa / Ospite apre una vasta gamma di opportunità per i tuoi prodotti. Ad esempio, i tuoi prodotti possono:

  • Spegni le luci quando la casa entra in Via 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 dell'ora di arrivo (ETA) stimati all'API Nest. In altri casi, l'utente può utilizzare un'app per inserire manualmente il proprio ETA. O forse l'ETA è definito in base al programma normale dell'utente.

Le app ETA integrate con il termostato Nest fanno sì 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 di Works con Nest da utilizzare nelle integrazioni di Works con Nest.

Dopo aver immesso l'ETA nel servizio Nest, un'altra integrazione di Works con Nest può utilizzarlo come segnale per preparare la casa all'arrivo dell'utente.

  1. L'ETA è stato scritto da uno sviluppatore Nest utilizzando la chiamata API PUT eta sola scrittura.
  2. Nest Thermostat utilizza questi dati.
  3. Se anche altri sviluppatori vogliono usarlo, possono usare la chiamata API GET eta_begin sola GET eta_begin .
Dati ETA

Il punto importante da tenere presente è che i dati ETA devono essere inseriti da una terza parte. Nest attualmente non fornisce 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 fornitore di illuminazione. È 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.

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

  • Accendi la TV mentre l'utente si avvicina a casa
  • Apri la porta del garage quando l'utente è quasi a casa
  • Ascolta la musica già quando l'utente torna a casa

Autorizzazioni assenti

I seguenti livelli di autorizzazione di accesso sono disponibili per i valori dei dati relativi a Away :



Accesso

Lettura via
Via lettura / scrittura

ETA letto

ETA in lettura / scrittura

Lettura fumo + CO
Termostato letto
Termostato di lettura / scrittura
away
eta_begin (sola lettura)
oggetto eta (solo scrittura)

Per ulteriori informazioni, vedere Panoramica delle autorizzazioni .

Funzionalità assenti

A casa e fuori casa

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

Valore Descrizione
home C'è qualcuno nella struttura. Questo stato può essere impostato:
• da Nest se ha un'alta confidenza con i dati del sensore di movimento
• dall'utente tramite l' app Nest , il termostato Nest o il prodotto
• algoritmicamente via ETA
away Non c'è nessuno nella struttura. L'utente ha impostato esplicitamente la struttura su via, tramite l' app Nest , il termostato Nest o il prodotto.
unknown Se alla struttura non sono associati dispositivi, lo stato di assenza è unknown .

L'API Nest offre la possibilità di impostare direttamente Casa e Ospite, nonché di ascoltare le modifiche a questi stati. Tuttavia, quando si imposta Casa e Assente, dovrebbe essere fatto come l' app Nest : come risultato di una richiesta esplicita dell'utente. Cercare di impostare algoritmicamente questo stato comporta il rischio di creare un'esperienza utente confusa ed è vietato dalle politiche di progettazione Nest .

Tenere presente che gli utenti hanno sempre la possibilità di impostare manualmente lo stato Casa / Ospite.

Ulteriori informazioni su come gli utenti impostano gli stati di casa e fuori casa .

ETA

Lontano

ETA è un oggetto con campi che possono essere impostati su una struttura. Viene utilizzato per comunicare a Nest che un utente dovrebbe tornare a casa in un momento specifico. Quando si imposta l'ETA, un prodotto genera un trip_id univoco e fornisce una finestra di arrivo prevista, specificata dai seguenti valori:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

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

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

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

Effettuare una chiamata di scrittura ETA

La logica ETA dipende dalla presenza di un termostato nella struttura. Se non esiste alcun termostato nella struttura, le chiamate effettuate all'oggetto ETA falliscono con il messaggio di errore "Nessun dispositivo associato" . Questo errore si verifica anche se nella struttura esistono altri tipi di dispositivi (ad esempio, Nest Cam o Nest Protect).

Valori di dati

Una chiamata ETA richiede i seguenti valori di dati:

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

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 una stringa trip_id univoca definita nella chiamata iniziale. Altri parametri possono cambiare con chiamate successive allo stesso 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 cancellare un eta, invia estimated_arrival_window_begin = 0 . Controlla che stai inviando un numero intero (0) in questa chiamata, non una stringa ("0"), altrimenti la chiamata fallirà.

Messaggio di errore

Per informazioni sul significato degli errori di chiamata API e su come gestirli, vedere Messaggi di errore .