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

Auswärts & ETA

Weg

In der Nest API hat das Konzept von "Zuhause" oder "Abwesend" einen starken Einfluss auf das Verhalten der Energiespar- und Komfortfunktionen von Nest.

So funktioniert Zuhause und abwesend

Nest verwendet eine Vielzahl von Signalen, um die Anwesenheit von Menschen in einem Zuhause zu erkennen. Wenn Nest über einen längeren Zeitraum keine Anwesenheit erkennt, stellt es das Zuhause automatisch auf Abwesend. Wenn es eine menschliche Anwesenheit erkennt, kehrt es die Struktur in den Home-Zustand zurück.

Auf Veränderungen des Zuhause/Abwesend-Status zu reagieren, eröffnet vielfältige Möglichkeiten für Ihre Produkte. Ihre Produkte können beispielsweise:

  • Schalten Sie das Licht aus, wenn das Haus in Abwesenheit geht, um Energie zu sparen
  • Senden Sie eine Benachrichtigung, wenn das Garagentor geöffnet ist, wenn das Haus abwesend ist
  • Musik abspielen, wenn das Haus auf Zuhause wechselt

So funktioniert ETA

In einigen Fällen haben Nutzer eine Drittanbieter-App, die GPS verwendet, um Daten zur geschätzten Ankunftszeit (ETA) an die Nest API bereitzustellen. In anderen Fällen verwendet der Benutzer möglicherweise eine App, um seine voraussichtliche Ankunftszeit manuell einzugeben. Oder vielleicht wird die ETA basierend auf dem regulären Zeitplan des Benutzers berechnet.

ETA-Apps, die in Nest Thermostat integriert sind, veranlassen den Thermostat, das Zuhause zu wärmen oder zu kühlen, bevor der Benutzer eintrifft.

Wenn die ETA/Thermostat-Integration im Konto des Nutzers vorhanden ist, stehen die ETA-Daten anderen Works with Nest-Entwicklern zur Verwendung in ihren Works with Nest-Integrationen zur Verfügung.

Nachdem die ETA in den Nest-Dienst eingegeben wurde, kann eine andere Works with Nest-Integration sie als Signal verwenden, um das Zuhause auf die Ankunft des Nutzers vorzubereiten.

  1. Die ETA wird von einem Nest Entwickler unter Verwendung der Schreib nur geschrieben PUT eta - API - Aufrufs .
  2. Der Nest Thermostat verwendet diese Daten.
  3. Wenn andere Entwickler es verwenden wollen, auch können sie die Verwendung Nur - Lese- GET eta_begin - API - Aufruf .
ETA-Daten

Der wichtige Punkt, den Sie beachten sollten, ist, dass die ETA-Daten von einem Dritten eingegeben werden müssen. Nest stellt derzeit keine ETA-Daten zur Verfügung. Wenn die ETA-Daten nicht geschrieben wurden, gibt die Nest API den Standardwert "1970-01-01T00:00:00.000Z" zurück.

Angenommen, Sie sind ein Beleuchtungsanbieter. Sie können die von der ETA/Thermostat-Integration bereitgestellten ETA-Daten abrufen und als Signal zum Einschalten der Beleuchtung verwenden.

So ist nicht nur die Temperatur angenehm, sondern das Licht ist auch an, wenn der Nutzer nach Hause kommt.

Auf Änderungen des ETA-Status zu reagieren, eröffnet vielfältige Möglichkeiten für Ihre Produkte. Ihre Produkte können beispielsweise:

  • Schalten Sie den Fernseher ein, wenn sich der Benutzer nach Hause nähert
  • Öffnen Sie das Garagentor, wenn der Benutzer fast zu Hause ist
  • Lassen Sie die Musik bereits abspielen, wenn der Benutzer nach Hause zurückkehrt

Abwesenheitsberechtigungen

Folgende Zugriffsberechtigungsstufen sind verfügbar für Auswärtsbezogene Datenwerte :



Zugriff

Auswärts lesen
Abwesend lesen/schreiben

ETA lesen

ETA lesen/schreiben

Rauch+CO-Alarm gelesen
Thermostat lesen
Thermostat lesen/schreiben
away Ja Ja Ja
eta_begin (nur lesen) Ja Ja
eta - Objekt (nur schreiben) Ja

Für mehr Informationen, die sehen Berechtigungen Übersicht .

Abwesenheitsfunktionen

Zuhause und weg

Der away Datenwert können Ihnen sagen , wenn Nest denkt die Struktur besetzt. Die möglichen Werte sind:

Wert Beschreibung
home Es ist jemand in der Struktur. Dieser Zustand kann eingestellt werden:
• von Nest, wenn es ein hohes Vertrauen in die Bewegungssensordaten hat
• durch den Benutzer über das Nest App , das Nest Thermostat, oder Ihr Produkt
• algorithmisch über ETA
away Es gibt niemanden in der Struktur. Der Benutzer hat die Struktur weg explizit festgelegt, entweder über das Nest App , das Nest Thermostat oder Ihr Produkt.
unknown Wenn keine Geräte mit der Struktur verbunden sind, dann ist der weg Zustand ist unknown .

Die Nest API bietet die Möglichkeit, "Zuhause" und "Abwesend" direkt festzulegen und auf Änderungen dieser Zustände zu achten. Wenn jedoch Heim Einstellung und Auswärts soll es geschehen, wie das Nest App tut es: als Ergebnis einer expliziten Benutzeranforderung. Der Versuch , algorithmisch diesen Zustand zu setzen , läuft Gefahr , eine verwirrende Benutzererlebnis und wird von der verbotenen Nest Design Politik .

Seien Sie sich bewusst , dass die Benutzer immer die Möglichkeit haben, das Heim / Auswärts Zustand manuell einstellen.

Erfahren Sie mehr über , wie Benutzer eingestellt Heim- und Auswärts Staaten .

ETA

Weg

ETA ist ein Objekt mit Feldern , die auf einer Struktur eingestellt werden können. Sie wird verwendet, um Nest mitzuteilen, dass ein Nutzer voraussichtlich zu einem bestimmten Zeitpunkt nach Hause zurückkehren wird. Wenn die ETA Einstellung erzeugt ein Produkt mit einem einzigartigen trip_id und stellt ein Fenster erwartete Ankunftszeit, die durch die folgenden Werte angegeben:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Da sich die Umstände bei Reisen aufgrund von Verkehr, geänderten Nutzerplänen und anderen Ereignissen ändern können, sollten Produkte die ETA regelmäßig während der Fahrt aktualisieren, um Nest einen Strom der geschätzten Ankunftszeiten bereitzustellen (5 Minuten ist ein ideales Intervall).

Je mehr Informationen wir erhalten, desto sicherer können wir uns auf die Zuverlässigkeit der ETA-Eingaben verlassen, was uns bei der Vorbereitung des Hauses zuversichtlicher macht.

Die ETA ist unabhängig vom Heimatstaat. Wenn die Ankunftszeit einer ETA mit einer anderen ETA in Konflikt steht, hat die früheste Ankunftszeit Vorrang.

Machen Sie einen ETA-Schreibanruf

Die ETA-Logik hängt vom Vorhandensein eines Thermostats in der Struktur ab. Wenn kein Thermostat in der Struktur vorhanden ist , Notrufe an die ETA Objekt gemacht scheitern mit der „No gekoppelten Geräten“ Fehlermeldung. Dieser Fehler tritt auch dann auf, wenn andere Gerätetypen in der Struktur vorhanden sind (z. B. eine Nest Cam oder ein Nest Protect).

Datenwerte

Ein ETA-Aufruf erfordert die folgenden Datenwerte:

Name Art Beschreibung
trip_id Schnur Eindeutige ETA-Reisekennung
estimated_arrival_window_begin Schnur Zeitstempel
Muss größer sein als NOW , in ISO 8601 - Format
estimated_arrival_window_end Schnur Zeitstempel
Muss größer sein als estimated_arrival_window_begin , in ISO 8601 - Format

Aufgrund der Möglichkeit von Verbindungsabbrüchen bei der GPS-Kommunikation empfehlen wir einen Stream von Samples, idealerweise alle 5 Minuten.

Jede ETA Anruf muss einen eindeutigen umfassen trip_id Zeichenfolge, die Sie in dem ersten Aufruf zu definieren. Andere Parameter können mit aufeinander folgenden Aufrufen der gleichen ändern trip_id .

Ein ETA-Aufruf gibt bei Erfolg den HTTP-Statuscode 200 OK zurück.

Beispiele

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

Eine ETA stornieren

Um einen eta abzubrechen, senden estimated_arrival_window_begin = 0 . Stellen Sie sicher, dass Sie in diesem Aufruf eine Ganzzahl (0) senden, keine Zeichenfolge ("0"), sonst schlägt der Aufruf fehl.

Fehlermeldungen

Für Informationen darüber , was API - Aufruf Fehler bedeuten und wie sie zu behandeln, siehe Fehlermeldungen .