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

Thermostat

Thermostatsteuerung

Das Nest Learning Thermostat ™ ist ein Internet - verbundene Gerät, der Verwendung intuitiv und einfach ist, kontinuierlich über Nutzungsmuster Lernen im Hause zu optimieren Komfort und spart Energie. Benutzer können ihre Heizung und Kühlung überall dort steuern, wo sie Zugang zu einer Internetverbindung haben.

Die Unterstützung dieser Funktionen erfordert ein ausgeklügeltes Steuerungssystem, das über einfache Sollwert-basierte Programme hinausgeht. Nest bietet eine breite Palette von Algorithmen (wie früh , Wahre Radiant , Airwave ™ ) , die eine erhebliche Menge an Rechenleistung erfordern im Vergleich zu den meisten Thermostate. Der Nest Thermostat hat die nötige Energie, um diese erweiterten Funktionen bereitzustellen.

Das Nest API ist so konzipiert , Produkte zu ermöglichen , das HVAC - System zu steuern , ohne Nest Algorithmen zu stören oder den Benutzer mit unerwartetem Verhalten zu überraschen. Sie bieten Zugriff auf die folgenden Daten für Nest Thermostat:

  • Strukturname und Gerät "wo name" (Ort in der Wohnung)
  • Benutzerdefiniertes Thermostat-Etikett
  • Online-Status und letzte Verbindungsinformationen
  • Aktuelle und Solltemperaturen
  • Temperaturmodus
  • Eco-Temperaturen
  • Zeit-zu-Temperatur
  • Temperaturskala (F/C einstellen)
  • Temperatursperre Status, und wenn gesperrt, die min / max gesperrt Temperaturwerte
  • Lüfter-Timer-Dauer und HLK-Modus
  • Feuchtigkeit
  • Sonnencreme

Thermostatberechtigungen

Für Lesezugriff auf alle Datenwerte Thermostat API, wählen Sie den Thermostat lesen Erlaubnis für Ihren Kunden.

Für Lesezugriff auf alle Thermostat - API Datenwerte und zusätzlichen Schreibzugriff auf Werte zu wählen, wählen Sie den Thermostat Lese- / Schreibberechtigung für Ihre Kunden. Mit dieser Berechtigungsstufe können Sie Folgendes aktualisieren:

  • Zieltemperatur
  • HLK-Modus
  • Lüfter-Timer

Ab Thermostat read/write v5 können Sie auch Folgendes aktualisieren:

  • Temperaturskala
  • Thermostat-Etikett

Thermostatkennungen

Gerät

Nest-Geräte werden nach Typ als Array von IDs aufgelistet, die verwendet werden können, um ein Gerät über den Gerätepfad eindeutig zu identifizieren. So eine Thermostat - ID von "peyiJNo..." bedeutet , dass Sie das Thermostat - Gerätemodell bei laden können devices/thermostats/peyiJNo... über die API.

Wenn ein Gerät mit mehreren Produkten verbunden ist, sieht jeder Entwickler eine andere ID für dieses Gerät. Bei einem Gerät, auf dem mehrere Produkte desselben Entwicklers installiert sind, wird dem Entwickler dieselbe ID angezeigt.

Name

Es werden zwei Namensattribute bereitgestellt. Das kürzere name - Attribut wird in der Benutzeroberfläche Etikett angezeigt, während name_long in Langform Text verwendet wird.

name

In diesen Beispielen name ist „Flur“ oder „Flur (West)“.

NameName lang

name_long

In diesem Beispiel name_long ist "Office (Upstairs)".

Name lang in einer Nachricht

Etikette

Wo Name (Etikett)
Wo Name (Etikett)

Beginnend mit Berechtigungen Version v5 , können Sie eine benutzerdefinierte Thermostat - Label über die API hinzufügen. In der Nest App wird das Label in Klammern nach dem Where-Namen angezeigt.

Beginnend mit Berechtigungen Version v6 , können Sie auch das Thermostat Etikett lesen.

Wo

where_id

  • Ein einzigartiger, Nest-generierten Identifikator, der darstellt , name
  • where_id ist schreibgeschützt und wird automatisch in dem Aufruf erstellt , um eine benutzerdefinierte zu erstellen , in dem name

Erfahren Sie mehr darüber , wo Namen für Nest Thermostats , Nest schützt und Nest Cams .

where_name

Wenn Sie eine der wählen Thermostat Berechtigungen können Sie das Gerät zugreifen where_name aus dem Geräteobjekt ( devices/thermostats ).

Andere Metadaten

Alle Datenwerte sind schreibgeschützt, sofern nicht anders angegeben.

Datenwert Beschreibung
locale Der diesem Gerät zugewiesene Sprach- und Ländercode
software_version Eine Zeichenfolge, die die aktuell auf dem Gerät installierte Firmware darstellt
structure_id Eine Zeichenfolge, die diese Struktur eindeutig darstellt; Dies ist die Struktur, mit der das Gerät gekoppelt ist
last_connection Der Zeitstempel der letzten erfolgreichen Verbindung zum Nest-Dienst
is_online Online Status. Dies wird durch Nest unter Verwendung der bestimmten last_connection Zeit und einer erwarteten Neuverbindung Fenster , das gerätespezifisch ist.

Thermostatfunktionen

Thermostatmodi

HVAC - Systeme haben vier "auf" Staaten ( heat , cool , heat-cool , eco ) und einem "Aus" -Zustand ( off ). Wir verwenden diese Staaten Komfort und Energieeinsparungen durch die Verwaltung hvac_mode und Temperaturdatenwerte.

  • Wenn Heizen oder Kühlen - Modus ( heat , cool ) ausgewählt ist, passt der Thermostat das Haus auf die Zieltemperatur.
  • Wenn Wärme • Cool - Modus ( heat-cool ) ausgewählt wird, prüft der Thermostat das Haus komfortabel, in einem bevorzugten Temperaturbereich.
  • Wenn Eco Temperaturen (eco) ausgewählt wird, wird der Thermostat Energiesparfunktion anwenden , das Haus bequem zu halten und den Energieverbrauch zu reduzieren. Thermostate in diesem Modus zeigen ECO an.

Strukturen haben zwei Anwesenheitsstatus: Zuhause oder Abwesend. Wenn im Haus keine Bewegung wahrgenommen wird, ändert sich die Struktur von Zuhause zu Abwesend und die Thermostate im Haus aktivieren automatisch die Eco-Temperaturen.

Wie hvac_mode und Temperaturwerte arbeiten zusammen

Je nach dem Wert von hvac_mode können nur bestimmte Temperaturdatenwerte in der API zugegriffen werden:

HLK-Modus Temperaturdatenwerte, auf die Sie zugreifen können
heat oder cool target_temperature_f oder target_temperature_c
heat-cool target_temperature_low_f und target_temperature_high_f
oder
target_temperature_low_c und target_temperature_high_c
eco eco_temperature_low_f und eco_temperature_high_f
oder
eco_temperature_low_c und eco_temperature_high_c
off keiner

In einigen Szenarien gibt es spezielle Regeln um Ändern hvac_mode :

Szenario Kann hvac_mode geändert werden?
Temperatursperre aktiviert ist Ja
Notabschaltung aktiv Nein
Notfall Wärme aktiviert Nein
can_cool oder can_heat Wert ist false Nein

Eco-Temperaturen

Eco-Temperaturen ermöglichen es dem Benutzer, Energie zu sparen, egal ob er zu Hause ist oder nicht. Betrachten Sie das Schalt hvac_mode zu eco , wenn Energiesparverhalten in Ihrem Produkt zu implementieren.

Eco Temperatur Endpunkte sind im Nest API mit Thermostat beginnend lesen und Lese / Schreib - v6 - Berechtigungen.

Umschalten zwischen Öko- und Nicht-Öko-Modus

Ihr Produkt sollte die Zieltemperaturen nicht direkt im Eco-Modus verwalten müssen. Wenn das Zuhause auf Abwesend eingestellt ist, wird die Zieltemperatur nicht angezeigt, sondern intern basierend auf der Benutzerauswahl eingestellt. Wenn der Thermostat auf OFF steht, werden keine Solltemperaturen eingehalten.

Wenn Sie die Zieltemperaturen unbedingt direkt ändern müssen, nehmen Sie die Änderung unbedingt in zwei separaten Aufrufen vor:

  1. Ändern hvac_mode auf einen anderen Wert außer eco
  2. Modifizieren , um die entsprechenden target_temperature Datenwerte

Beginnend mit Thermostat lesen und Lese- / Schreib v6 Berechtigungen, die Sie zugreifen können previous_hvac_mode über die API mit HVAC - Modus Übergänge zu unterstützen. previous_hvac_mode wird verwendet , um die zum Speichern hvac_mode des Gerätes , bevor es zu „eco“ umgestellt .

Wenn zum Beispiel der Nest Thermostat mit Eco Temperaturen ( hvac_mode = "eco" ), previous_hvac_mode verfügbar ist , und Sie möchten Ihr Produkt Set target_temperature , dann müssen Sie zuerst:

  1. get previous_hvac_mode
  2. set hvac_mode zum previous_hvac_mode Wert
  3. confirm hvac_mode nicht mehr auf „eco“

Stellen Sie nach diesen Schritten die Zieltemperaturen entsprechend ein.

Je nach hvac_mode Wert, das ist , wie previous_hvac_mode ändert:

Wenn hvac_mode Zustand ist ... Dann previous_hvac_mode kann sein ...
eco heat , cool , heat-cool oder off
heat , cool , heat-cool oder off leer/leer

Zieltemperatur

Die Zieltemperatur ist der wichtigste Wert für das HLK-System – es ist die gewünschte Temperatur, die normalerweise vom Benutzer eingestellt wird. Die meisten Handlungen und Entscheidungen basieren darauf. Über die API können Works with Nest-Produkte die Zieltemperatur als Teil eines größeren Prozesses schreiben.

Es ist immer eine Zieltemperatur eingestellt, wenn das System eingeschaltet ist.

  • Wenn Wärme oder Kühlmodus ( heat , cool ) ausgewählt wird, eine einzelne target_temperature gesetzt ist
  • Wenn Wärme • Kühlmodus ( heat-cool ) ausgewählt wird, werden zwei target_temperature sind Werte gesetzt, einen Zielbereich angibt, einen höheren zum Kühlen und eine untere für Heizung
  • Wenn Eco Modus ( eco ) ausgewählt wird, wird der Ziel - Temperaturbereich intern eingestellten

Es gibt auch Sicherheitstemperaturen, die als Rücklaufsperre dienen, um ein Einfrieren von Rohren oder zu hohe Temperaturen im Haus zu verhindern.

Wenn der Thermostat AUS ist, werden keine Zieltemperaturen eingestellt.

Zeit-zu-Temperatur

Time-to-Temperatur gibt Ihnen Zugriff auf diese Datenwerte für das HVAC - System:

  • time_to_target - Die Zeit in Minuten an , dass es für die Struktur nimmt die Solltemperatur zu erreichen
  • time_to_target_training
    • Trainingsstatus
    • Wenn der Thermostat lernt, wie das HLK-System reagiert, passt er die Schätzung an, um die Zieltemperatur zu erreichen
    • Wenn die Thermostat ziemlich sicher der Zeitschätzung ist die Solltemperatur zu erreichen, wird Status von ändern training zu ready

Umgebungstemperatur

Die in der Nähe des Thermostats gemessene Temperatur. Zeigen Sie den Wert an, der der vom Benutzer bevorzugten Temperaturskala entspricht.

Temperaturskala

Die Umgebungs- und Zieltemperaturvariablen sind nach Celsius- oder Fahrenheit-Skala organisiert. Das temperature_scale Attribut wird entweder „F“ oder „C“, je nach Benutzerpräferenz. Diese Eigenschaft wird von jedem Thermostat eingestellt, daher ist es möglich, dass ein Benutzer in einer einzigen Struktur zwei Thermostate hat, einen in jeder Temperaturskala. Halten Sie Benutzereinstellungen im Auge , wenn Temperaturwerte angezeigt werden .

Beginnend mit Berechtigungen Version v5 können Sie die Temperaturskala durch die API ändern.

Temperatur Ziel und Umgebungsfelder haben _f und _c Varianten konsequente Abrundung aufzunehmen , wenn Temperaturen anzeigt.

Temperaturanzeige

Thermostat

Wenn Sie Zieltemperaturinformationen angezeigt werden , betrachten Sie diese drei abhängigen Werte: temperature_scale , hvac_mode und die Struktur away Zustand.

Viele Datenwerte wirken zusammen, um zu bestimmen, was auf dem Nest Thermostat-Display angezeigt wird und wie es sich verhält.

  • Wenn hvac_mode eingestellt wird heat-cool , getrennt das Nest Thermostat zeigt die niedrige und hohe Sollwerte von einer Aufzählungszeichen (•), andernfalls das Nest Thermostat zeigt nur die Zieltemperatur
  • Wenn hvac_mode gesetzt wird off , wird das Wort „OFF“ auf dem Nest Thermostat angezeigt, in dem bevorzugten Sprache des Benutzers
  • Wenn hvac_mode eingestellt ist eco , wird das Wort „ECO“ auf dem Nest Thermostat angezeigt, in dem bevorzugten Sprache des Benutzers

Das Anzeigetemperaturformat hängt auch von der gewählten Temperaturskala (F/C) ab.

Fahrenheit-Temperaturen werden als ganze Zahlen angezeigt:

  • Zieltemperatur: 55 ° F
  • Umgebungstemperatur: 62 ° F

Celsius-Temperaturen werden als ganze Zahl oder als Dezimalwert angezeigt, wobei die letzte Ziffer auf ".5" gesetzt ist:

  • Zieltemperatur: 12°C
  • Umgebungstemperatur: 16,5 °C

Blatt

Wenn das Blatt Symbol auf der Vorderseite des Thermostaten ist die Thermostat auf eine energiesparende Temperatur eingestellt und has_leaf = true .

Blatt

Temperatursperre

Nutzer können einen Nest Thermostat sperren, sodass er nur innerhalb eines begrenzten Temperaturbereichs angepasst werden kann. Beginnend mit Berechtigungen Version v5 können Sie sehen , ob Temperatursperre durch Prüfung aktiviert ist is_locked , und wenn es ist, Temperatursperre min / Max - Werte über die API lesen:

Lock - Temperaturen müssen paarweise festgelegt werden, wie Maximal- und Minimalwerte und können nur geschrieben werden , wenn is_locked = true .

Feuchtigkeit

Luftfeuchtigkeit im Prozent (%) Format, gemessen am Gerät, auf die nächsten 5 % gerundet.

Sonnencreme

Sunblocker - Technologie passt automatisch die Temperatur auf dem Nest Thermostat für die Wärmespitzen zu kompensieren , die vor direkter Sonneneinstrahlung auf das Gerät auftreten.

Diese Datenwerte sagen Ihnen, ob Sunblock aktiviert ist und/oder die Temperatur aktiv korrigiert.

Ventilator

Viele HVAC - Systeme haben Fans integriert, was bedeutet , dass der Lüfter nicht unabhängig gesteuert werden . Für integrierte Lüfter gibt es keinen Aus-Modus, da der Lüfter laufen muss, wenn die Heizung oder Kühlung eingeschaltet ist.

Wenn das HVAC-System jedoch kompatibel ist, kann der Lüfter über die API explizit eingeschaltet werden, um den Komfort der Bewohner zu erhöhen, ohne das gesamte HVAC-System zu aktivieren.

Wenn der Lüfter unabhängig voneinander gesteuert werden können, has_fan wird eingestellt werden true , und die folgenden Datenwerte können mit Thermostat Lese- / Schreibberechtigungen festgelegt werden:

  • fan_timer_active - boolean, kehrt true , wenn Fan - Timer für eine vorprogrammierte Dauer eingreift
  • fan_timer_duration - int, die Länge der Zeit (in Minuten) , dass der Lüfter läuft gesetzt

Verwenden Sie diese Werte zusammen, um den Lüfter-Timer (Schalten Sie den Lüfter ein) für einen bestimmten Zeitraum zu starten. Sie können auch die Verwendung fan_timer_timeout Wert den Zeitstempel , um zu bestimmen , wenn der Ventilator eingestellt läuft zu stoppen.

Beachten Sie, dass Sie sich jederzeit ändern können fan_timer_duration - es ist unabhängig von hvac_mode oder Struktur Belegungszustand (weg).

Sie können diese Antworten bei Erfolg oder Misserfolg erwarten:

  • 200 OK
  • 400 Schlechte Anfrage

Wenn der Befehl zum Einschalten des Lüfters nicht das erwartete Ergebnis liefert, kann dies daran liegen, dass der Lüfter bereits eingeschaltet ist (entweder manuell vom Benutzer oder nach einem Zeitplan oder aufgrund eines HLK-Heiz-/Kühlzyklus).

Ratenbegrenzung

Wir wenden eine Tarifbegrenzung an, um vor übermäßigen Anrufen von Geräten zu schützen, die sich auf die System- oder Akkuleistung auswirken können. Unter normalen Bedingungen laden Nest-Geräte den Akku über die Niederspannungskabel des Heiz- und Kühlsystems auf. Wenn jedoch in kurzer Zeit zu viele Anrufe getätigt werden und der Akkustand niedrig wird, schaltet Nest Thermostat das WLAN aus, um Strom zu sparen.

In der Praxis bedeutet dies, dass wir die Anzahl der Anrufe begrenzen, die innerhalb eines definierten Zeitraums zu einem Gerät geführt werden können. Wenn Sie dieses Limit überschreiten, erhalten Sie eine Fehlerantwort und eine Meldung, dass Sie das Limit überschritten haben.

Weitere Informationen finden Sie Data Rate Limits .

Leistungsbeschränkungen

In einigen Fällen hat der Thermostat möglicherweise nicht genügend Batterieleistung, um eine Änderungsanforderung zu bearbeiten. In diesem Fall erhalten Sie eine Fehlerantwort und eine Meldung, dass das Gerät die Anfrage derzeit nicht bedienen kann. Geben Sie in diesem Fall dem Akku etwas Zeit zum Aufladen, bevor Sie es erneut versuchen.

Erfahren Sie mehr über niedrigen Batteriebedingungen im Nest Learning Thermostat .

Fehlermeldungen

Einige Zustände machen bestimmte Funktionen nicht verfügbar. Diese Regeln sollen Energie sparen oder Komfort und Sicherheit bieten.

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

WLAN-/Verbindungsproblem

Wenn ein Gerät offline ist, sind Änderungen nicht zulässig. Sie können den Online-Zustand des Geräts im Datenmodell beobachten und die Benutzeroberfläche entsprechend anzeigen.