Abwesend

Abwesend

In der Nest API wirkt sich das Konzept „Zuhause“ oder „Abwesend“ stark auf das Verhalten von Nest-Energiesparfunktionen und Komfortfunktionen aus.

So funktioniert die Zuhause/Abwesend-Funktion

Nest nutzt eine Vielzahl von Signalen, um die Anwesenheit eines Menschen in einem Zuhause zu erkennen. Wenn Nest über einen längeren Zeitraum hinweg keine Anwesenheit erkennt, wird das Zuhause automatisch in den Modus „Abwesend“ versetzt. Wenn sie menschliche Anwesenheit erkennt, wird die Struktur in den Modus „Zuhause“ versetzt.

Wenn du auf Änderungen im Status „Zuhause“ oder „Abwesend“ reagieren kannst, bieten sich dir viele Möglichkeiten. Ihre Produkte können beispielsweise:

  • Schalte das Licht aus, wenn das Zuhause in den Modus „Abwesend“ wechselt, um Energie zu sparen
  • Benachrichtigung senden, wenn das Garagentor geöffnet ist, wenn der Modus „Abwesend“ eingestellt ist
  • Musik abspielen, wenn das Zuhause in den Modus „Zuhause“ wechselt

So funktioniert die voraussichtliche Ankunftszeit

In einigen Fällen verwenden Nutzer eine Drittanbieter-App, die GPS verwendet, um der Nest API die geschätzte voraussichtliche Ankunftszeit mitzuteilen. In anderen Fällen kann es vorkommen, dass Nutzer ihre App manuell in einer App eingeben. Oder die voraussichtliche Ankunftszeit wird anhand des regulären Fahrplans des Nutzers berechnet.

ETA-Apps, die in Nest Thermostat integriert sind, führen dazu, dass der Thermostat vor Beginn des Zuhauses mit dem Aufwärmen oder Kühlen beginnt.

Wenn die ETA-/Thermostat-Integration im Konto des Nutzers vorhanden ist, sind die ETA-Daten für andere Works with Nest-Entwickler verfügbar und können in ihren Works with Nest-Integrationen verwendet werden.

Sobald die voraussichtliche Ankunftszeit in den Nest-Dienst eingegeben wurde, kann sie von einer anderen Works with Nest-Integration als Signal für die Ankunft des Nutzers verwendet werden.

  1. Die voraussichtliche Ankunftszeit wird von einem Nest-Entwickler geschrieben, der den schreibgeschützten PUT eta API-Aufruf verwendet.
  2. Diese Daten werden vom Nest Thermostat verwendet.
  3. Wenn andere Entwickler die Funktion ebenfalls verwenden möchten, können sie den schreibgeschützten GET eta_begin API-Aufruf verwenden.
Ank.

Wichtig: Die ETA-Daten müssen von einem Drittanbieter eingegeben werden. Nest liefert derzeit keine Daten zu voraussichtlichen Ankunftszeiten. Wenn die voraussichtliche Ankunftszeit nicht geschrieben wurde, gibt die Nest API den Standardwert 1970-01-01T00:00:00.000Z& zurück.

Angenommen, Sie sind Anbieter von Beleuchtungstechniken. Du kannst die ETA-Daten abrufen, die durch die ETA/Thermostat-Integration bereitgestellt werden, und sie als Signal zum Einschalten der Lichter verwenden.

Auf diese Weise wird nicht nur die Temperatur gemütlich, sondern auch das Licht eingeschaltet, wenn der Nutzer nach Hause kommt.

Wenn du auf Änderungen des voraussichtlichen Ankunftszeitentyps reagierst, ergeben sich für dich zahlreiche Möglichkeiten. Ihre Produkte können beispielsweise:

  • Einschalten, wenn sich der Nutzer dem Zuhause nähert
  • Garagentor öffnen, wenn der Nutzer zu Hause ist
  • Musik abspielen, wenn der Nutzer nach Hause kommt

Berechtigungen für „Abwesend“

Für Abwesend-Datenwerte sind folgende Zugriffsberechtigungen verfügbar:



Zugriff

Lese- und Schreibzugriff
Abwesend

Noch heute gelesen

ETA-Lese-/-Schreibzugriff

Rauch- und Kohlenmonoxidmelder gelesen
Lese-/Schreibzugriff auf Thermostat
away Ja Ja Ja
eta_begin (schreibgeschützt) Ja Ja
eta-Objekt (schreibgeschützt) Ja

Weitere Informationen finden Sie unter Berechtigungen.

Funktionen für „Abwesend“

Zuhause/Abwesend-Funktion

Der Datenwert away gibt Aufschluss darüber, ob die Struktur Ihrer Meinung nach belegt ist. Die möglichen Werte sind:

WertBeschreibung
homeJemand in der Struktur Dieser Status kann festgelegt werden:
• von Nest, wenn er mit den Bewegungssensordaten sehr zuverlässig ist
• durch den Nutzer über die Nest App, den Nest Thermostat oder das Produkt
• mit Algorithmus über die TA
awayIn der Struktur ist niemand vorhanden. Der Nutzer hat die Struktur über die Nest App, den Nest Thermostat oder Ihr Produkt explizit auf „Abwesend“ gesetzt.
unknownWenn der Struktur keine Geräte zugeordnet sind, ist der Abwesenheitsstatus unknown.

Mit der Nest API können die Abläufe „Zuhause“ und „Abwesend“ direkt festgelegt sowie Änderungen an diesen Status überwacht werden. Wenn Sie die Abläufe „Zuhause“ und „Abwesend“ festlegen, sollten Sie das jedoch wie in der Nest App tun, d. h. aufgrund einer expliziten Nutzeranfrage. Wenn du diesen Status algorithmisch festlegst, kann dies zu Verwirrung bei den Nutzern führen. Dies verstößt gegen die Nest-Designrichtlinien.

Nutzer können die Zuhause/Abwesend-Funktion immer manuell festlegen.

Weitere Informationen zum Festlegen der Abläufe „Zuhause“ und „Abwesend“

ETA

Abwesend

ETA ist ein Objekt mit Feldern, die für eine Struktur festgelegt werden können. Damit wird Nest mitgeteilt, dass ein Nutzer zu einem bestimmten Zeitpunkt zurückkehren wird. Beim Festlegen der voraussichtlichen Ankunftszeit generiert ein Produkt ein eindeutiges trip_id und stellt ein voraussichtliches Zeitfenster für die Ankunft bereit, das durch folgende Werte angegeben wird:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Weil sich die Umstände aufgrund von Verkehrslage, geänderten Nutzerplänen und anderen Ereignissen ändern können, sollten die voraussichtlichen Ankunftszeiten während der Fahrt regelmäßig aktualisiert werden. Nest stellt dabei einen Stream von voraussichtlichen Ankunftszeiten bereit. Idealerweise sind 5 Minuten ein Intervall.

Je mehr Informationen wir erhalten, desto zuverlässiger sind die ETA-Eingaben, und wir können sie auch dann nutzen, wenn wir Maßnahmen für die Vorbereitung Ihres Zuhauses ergreifen.

Die voraussichtliche Ankunftszeit ist unabhängig von ihrem Heimatzustand. Wenn die Ankunftszeit eines voraussichtlichen Ankunftszeitens mit einem anderen voraussichtlichen Zeitpunkt in Konflikt steht, hat die früheste Ankunftszeit Vorrang.

Einen Anruf innerhalb der voraussichtliche Ankunftszeit starten

Die ETA-Logik hängt davon ab, ob ein Thermostat in der Struktur vorhanden ist. Wenn kein Thermostat in der Struktur vorhanden ist, schlagen Aufrufe für das ETA-Objekt mit der Fehlermeldung "No gekoppelted devices" fehl. Dieser Fehler tritt auch dann auf, wenn andere Typen von Geräten in der Struktur vorhanden sind, z. B. eine Nest Cam oder ein Nest Protect.

Datenwerte

Ein ETA-Aufruf erfordert die folgenden Datenwerte:

Name Typ Beschreibung
trip_id string Eindeutige ID der voraussichtlichen Ankunftszeit
estimated_arrival_window_begin string Zeitstempel
Der Wert muss größer als NOW sein. Die Angabe muss im ISO 8601-Format vorliegen.
estimated_arrival_window_end string Zeitstempel
Der Wert muss größer als estimated_arrival_window_begin sein. Die Angabe muss im ISO 8601-Format vorliegen.

Aufgrund der Möglichkeit von Verbindungsausbrüchen bei der GPS-Kommunikation empfehlen wir einen Stichprobenstream, idealerweise alle fünf Minuten.

Jeder ETA-Aufruf muss einen eindeutigen trip_id-String enthalten, den Sie im ersten Aufruf definieren. Andere Parameter können sich bei aufeinanderfolgenden Aufrufen derselben trip_id ändern.

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

Beispiele

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

Meine voraussichtliche Ankunftszeit kündigen

Um eine ETA zu stornieren, senden Sie estimated_arrival_window_begin = 0. Achten Sie darauf, dass Sie in diesem Anruf eine Ganzzahl (0) und nicht einen String (&) senden. Andernfalls schlägt der Aufruf fehl.

Fehlermeldungen

Informationen zu den API-Aufruffehlern und deren Behebung finden Sie unter Fehlermeldungen.