Google setzt sich dafür ein, die Rassengerechtigkeit für schwarze Gemeinschaften zu fördern. Siehe wie.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Weg & amp; ETA

Weg

In der Nest-API hat das Konzept "Zuhause" oder "Auswärts" einen starken Einfluss auf das Verhalten der Energieeinsparungs- und Komfortfunktionen von Nest.

Wie Heim und Auswärts funktioniert

Nest verwendet eine Vielzahl von Signalen, um die Anwesenheit von Menschen in einem Heim zu erkennen. Wenn Nest über einen längeren Zeitraum keine Anwesenheit feststellt, wird das Haus automatisch auf Abwesenheit gesetzt. Wenn es menschliche Präsenz erkennt, bringt es die Struktur in den Heimatzustand zurück.

Die Reaktion auf Änderungen im Heim- / Auswärtsstatus eröffnet Ihren Produkten eine Vielzahl von Möglichkeiten. Zum Beispiel können Ihre Produkte:

  • Schalten Sie das Licht aus, wenn das Haus weggeht, um Energie zu sparen
  • Senden Sie eine Benachrichtigung, wenn das Garagentor geöffnet ist, wenn das Haus weg ist
  • Spielen Sie Musik, wenn das Haus zu Home wechselt

Wie ETA funktioniert

In einigen Fällen verfügen Benutzer über eine Drittanbieter-App, die mithilfe von GPS der Nest-API Daten zur geschätzten Ankunftszeit (ETA) bereitstellt. In anderen Fällen kann der Benutzer eine App verwenden, um seine ETA manuell einzugeben. Oder die ETA wird basierend auf dem regulären Zeitplan des Benutzers berechnet.

ETA-Apps, die in den Nest-Thermostat integriert sind, bewirken, dass der Thermostat das Haus erwärmt oder abkühlt, bevor der Benutzer eintrifft.

Wenn die ETA / Thermostat-Integration im Benutzerkonto 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 Haus auf die Ankunft des Benutzers vorzubereiten.

  1. Die ETA wird von einem Nest-Entwickler mithilfe des schreibgeschützten PUT eta API-Aufrufs geschrieben .
  2. Der Nest-Thermostat verwendet diese Daten.
  3. Wenn andere Entwickler es ebenfalls verwenden möchten, können sie den GET eta_begin API-Aufruf GET eta_begin .
ETA-Daten

Der wichtige Punkt, den Sie beachten sollten, ist, dass ETA-Daten von Dritten eingegeben werden müssen. Nest liefert derzeit keine ETA-Daten. 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 Lichter verwenden.

Auf diese Weise ist nicht nur die Temperatur angenehm, die Lichter sind auch an, wenn der Benutzer nach Hause kommt.

Die Reaktion auf Änderungen des ETA-Status eröffnet Ihren Produkten eine Vielzahl von Möglichkeiten. Zum Beispiel können Ihre Produkte:

  • 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 bereits Musik abspielen, wenn der Benutzer nach Hause zurückkehrt

Abwesenheitsberechtigungen

Die folgenden Zugriffsberechtigungsstufen sind für Auswärtsdatenwerte verfügbar:



Zugriff

Weg lesen
Weg lesen / schreiben

ETA gelesen

ETA lesen / schreiben

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

Weitere Informationen finden Sie in der Berechtigungsübersicht .

Auswärtsmerkmale

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 Status kann eingestellt werden:
• von Nest, wenn es ein hohes Vertrauen in Bewegungssensordaten hat
• vom Benutzer über die Nest-App , den Nest-Thermostat oder Ihr Produkt
• algorithmisch über ETA
away Es ist niemand in der Struktur. Der Benutzer hat die Struktur entweder über die Nest-App , den Nest-Thermostat oder Ihr Produkt explizit auf "Weg" gesetzt.
unknown Wenn der Struktur keine Geräte zugeordnet sind, ist der Abwesenheitszustand unknown .

Die Nest-API bietet die Möglichkeit, Home und Away direkt festzulegen und auf Änderungen an diesen Status zu warten. Wenn Sie jedoch Heim und Auswärts einstellen, sollte dies wie in der Nest-App erfolgen : als Ergebnis einer expliziten Benutzeranforderung. Der Versuch, diesen Status algorithmisch festzulegen, birgt das Risiko einer verwirrenden Benutzererfahrung und ist durch die Nest-Entwurfsrichtlinien verboten.

Beachten Sie, dass Benutzer den Home / Away-Status immer manuell festlegen können.

Erfahren Sie mehr darüber, wie Benutzer den Status "Heim" und "Auswärts" festlegen .

ETA

Weg

ETA ist ein Objekt mit Feldern, die für eine Struktur festgelegt werden können. Es wird verwendet, um Nest mitzuteilen, dass von einem Benutzer erwartet wird, dass er zu einem bestimmten Zeitpunkt nach Hause zurückkehrt. Beim Festlegen der ETA generiert ein Produkt eine eindeutige trip_id und bietet ein erwartetes Ankunftsfenster, das durch die folgenden Werte angegeben wird:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Da sich die Umstände rund um Reisen aufgrund von Verkehr, geänderten Benutzerplänen und anderen Ereignissen ändern können, sollten Produkte die ETA im Verlauf der Reise regelmäßig aktualisieren und Nest einen Strom geschätzter Ankunftszeiten zur Verfügung stellen (5 Minuten sind ein ideales Intervall).

Je mehr Informationen wir erhalten, desto sicherer können wir uns auf die Zuverlässigkeit der ETA-Eingaben verlassen. Dies macht uns sicherer, wenn wir Maßnahmen zur Vorbereitung des Hauses ergreifen.

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

Tätigen Sie einen ETA-Schreibanruf

Die ETA-Logik hängt vom Vorhandensein eines Thermostats in der Struktur ab. Wenn in der Struktur kein Thermostat vorhanden ist, schlagen Aufrufe des ETA-Objekts mit der Fehlermeldung "Keine gekoppelten Geräte" fehl. Dieser Fehler tritt auch dann auf, wenn andere Gerätetypen in der Struktur vorhanden sind (z. B. eine Nest-Kamera oder ein Nest-Schutz).

Datenwerte

Ein ETA-Aufruf erfordert die folgenden Datenwerte:

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

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

Jeder ETA-Aufruf muss eine eindeutige trip_id Zeichenfolge enthalten, die Sie beim ersten Aufruf definiert haben. Andere Parameter können sich bei aufeinanderfolgenden Aufrufen derselben trip_id .

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

Beispiele

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

ETA abbrechen

Um ein eta abzubrechen, senden Sie estimated_arrival_window_begin = 0 . Überprüfen Sie, ob Sie in diesem Aufruf eine Ganzzahl (0) senden, keine Zeichenfolge ("0"). Andernfalls schlägt der Aufruf fehl.

Fehlermeldungen

Informationen dazu, was API-Aufruffehler bedeuten und wie sie behandelt werden, finden Sie unter Fehlermeldungen .