Google は、黒人コミュニティのための人種的公平の促進に取り組んでいます。詳細をご覧ください。

サーモスタット

サーモスタット制御

巣学習サーモスタット™は、継続的に最適化快適に家庭でのエネルギー保存の使用パターンについて学び、直感的で使いやすいインターネット接続されたデバイスです。ユーザーは、インターネット接続にアクセスできる場所であればどこでも冷暖房を制御できます。

これらの機能をサポートするには、単純なセットポイントベースのプログラムを超える高度な制御システムが必要です。巣は、(のようなアルゴリズムの広い範囲を提供し、早い段階で真のラディアントエアウェイブ™ほとんどのサーモスタットに比べて計算能力にかなりの量を必要とします)。 Nest サーモスタットには、これらの高度な機能を提供するために必要なパワーがあります。

巣のAPIは、製品が巣アルゴリズムを中断するか、予期しない動作をユーザーに驚かずにHVACシステムを制御することができるように設計されています。これらは、Nestサーモスタットの次のデータへのアクセスを提供します。

  • 構造名とデバイス「場所の名前」(家の中の場所)
  • カスタム サーモスタット ラベル
  • オンラインステータスと最後の接続情報
  • 現在および目標温度
  • 温度モード
  • エコ温度
  • 温度までの時間
  • 温度尺度(設定F / C)
  • 温度ロック状態、およびロックされている場合、最小/最大ロックされた温度値
  • ファンタイマーの持続時間とHVACモード
  • 湿度
  • 日焼け止め

サーモスタットの許可

すべてのサーモスタットのAPIデータ値への読み取りアクセスのために、選択サーモスタットを読んで、あなたのクライアントの許可を。

すべてのサーモスタットのAPIデータ値への読み取りアクセスおよび追加の書き込みアクセスの場合は、値を選択し、選択サーモスタットの読み取り/書き込みクライアントの許可を。このアクセス許可レベルでは、以下を更新できます。

  • 目標温度
  • HVACモード
  • ファンタイマー

サーモスタット読み取り/書き込みv5以降、以下を更新することもできます。

  • 温度尺度
  • サーモスタットラベル

サーモスタット識別子

端末

Nestデバイスは、IDの配列としてタイプ別に一覧表示されます。これを使用して、デバイスパスを介してデバイスを一意に識別できます。サーモスタットIDだから、 "peyiJNo..."あなたは恒温デバイスモデルを読み込むことができることを意味devices/thermostats/peyiJNo... APIを介して。

デバイスが複数の製品に接続されている場合、各開発者にはそのデバイスの異なる ID が表示されます。同じ開発者からの複数の製品をインストールしたデバイスの場合、開発者には同じIDが表示されます。

名前

2つの名前属性が提供されます。短いnameながら属性は、ユーザインタフェースのラベルに表示されname_long長い形式のテキストで使用されています。

name

これらの例では、 name 「廊下」または「廊下(西)」です。

名前長い名前

name_long

この例では、 name_long 「オフィス(アップステアーズ)」です。

メッセージに長い名前を付ける

ラベル

名前(ラベル)の場所
名前(ラベル)の場所

始まる権限バージョンV5 、あなたは、APIを介してカスタムサーモスタットラベルを追加することができます。 Nestアプリでは、ラベルはwhere名の後に括弧で囲まれて表示されます。

始まる権限バージョンV6 、あなたはまた、サーモスタットのラベルを読み取ることができます。

どこ

where_id

  • 表す一意、巣、生成された識別子name
  • where_id 、読み取り専用で、どこカスタム作成するコールに自動的に作成されたname

名前場所についての詳細はこちら 巣のサーモスタット巣を保護し、巣カム

where_name

あなたは、任意の選択するとサーモスタットの権限を、あなたは、デバイスにアクセスすることができますwhere_nameデバイスオブジェクト(からdevices/thermostats )。

その他のメタデータ

特に指定がない限り、すべてのデータ値は読み取り専用です。

データ値説明
localeこのデバイスに割り当てられている言語と国コード
software_versionデバイスに現在インストールされているファームウェアを表す文字列
structure_idこの構造を一意に表す文字列。これは、デバイスがペアになっている構造です
last_connection Nestサービスへの最後に成功した接続のタイムスタンプ
is_onlineオンラインステータス。これは、使用ネストすることによって決定されるlast_connection時間とデバイス固有であると予想再接続ウィンドウ。

サーモスタット機能

サーモスタットモード

HVACシステムは、状態(「オン」4持っているheatcoolheat-coolecoの「オフ」状態)と1( off )。我々はを通じて快適さと省エネを管理するために、これらの状態を使用しhvac_modeし、温度データ値。

  • 加熱または冷却モード(ときheatcool )選択され、サーモスタットは、目標温度に家を調整します。
  • ヒート•冷却モード(ときheat-cool )選択され、サーモスタットは好ましい温度範囲内で、快適な家を維持します。
  • ときに エコ温度(エコ)が選択され、サーモスタットは、快適な家を維持し、エネルギー使用量を削減する省エネアルゴリズムを適用します。このモードのサーモスタットはECOを表示します。

構造には、プレゼンスに関連する2つの状態があります。ホームまたはアウェイです。家の中で動きが感知されない場合、構造はホームからアウェイに変わり、家のサーモスタットは自動的にエコ温度を有効にします。

どのようにhvac_modeと温度の値は、一緒に働きます

値に応じhvac_mode 、のみ特定の温度データ値がAPIにアクセスすることができます。

HVACモードアクセス可能な温度データ値
heatcool target_temperature_fまたはtarget_temperature_c
heat-cool target_temperature_low_ftarget_temperature_high_f
または
target_temperature_low_ctarget_temperature_high_c
eco eco_temperature_low_feco_temperature_high_f
または
eco_temperature_low_ceco_temperature_high_c
off無し

いくつかのシナリオでは、変更の周りに特別なルールがあるhvac_mode

シナリオすることができますhvac_mode変更することは?
温度ロックが有効になっていますはい
緊急シャットオフはアクティブになっています番号
緊急熱が有効になっています番号
can_coolまたはcan_heat値がfalse番号

エコ温度

エコ温度により、ユーザーは家にいるかどうかに関係なく、エネルギーを節約できます。切り替えることを検討hvac_modeするeco製品に省エネ行動を実装する場合。

エコ温度のエンドポイントは、読み込みと読み取り/書き込みv6の権限をサーモスタットで始まる巣のAPIで利用できます。

エコモードと非エコモードの切り替え

製品は、エコモードで直接目標温度を管理する必要はありません。ホームが離れている場合、目標温度は表示されませんが、ユーザーの選択に基づいて内部的に設定されます。サーモスタットがOFFに設定されている場合、目標温度は観測されません。

どうしても目標温度を直接変更する必要がある場合は、必ず2つの別々の呼び出しで変更してください。

  1. 変更hvac_modeを除く他のどの値にeco
  2. 適切な変更target_temperatureデータ値を

読んで、読み取り/書き込みv6の権限サーモスタットで始まる、あなたがアクセスすることができprevious_hvac_mode HVACモードの移行を支援するためにAPIを介して。 previous_hvac_mode格納するために使用されhvac_modeそれは「エコ」に移行する前に、デバイスのを。

巣サーモスタットは、エコ温度(使用している場合たとえば、 hvac_mode = "eco" )、 previous_hvac_mode利用可能で、あなたはセットにあなたの製品をしたいtarget_temperature 、あなたが最初に行う必要があります。

  1. GET previous_hvac_mode
  2. セットhvac_modeprevious_hvac_mode
  3. 確認hvac_modeもはやに設定されている「エコ」

これらの手順の後、必要に応じて目標温度を設定します。

応じて、 hvac_mode値、これはどのようにあるprevious_hvac_mode変更:

ときhvac_mode状態は...その後、 previous_hvac_modeすることができ...
eco heatcoolheat-coolまたはoff
heatcoolheat-coolまたはoff空白/空

目標温度

目標温度は、HVACシステムにとって最も重要な値です。これは、通常、ユーザーが設定する望ましい温度です。ほとんどの行動と決定はそれに基づいています。 API から、Works with Nest 製品は、より大きなプロセスの一部として目標温度を書き込むことができます。

システムがオンのときは、常に目標温度が設定されています。

  • 加熱または冷却モード(場合heatcool )選択された、単一target_temperatureセットであります
  • 熱•クールモード時( heat-cool )選択された二target_temperature値が目標範囲、冷却するための高い方と加熱のための1つの下側を示す、設定されています
  • エコモード(場合eco )選択され、目標温度範囲は内部で設定されています

パイプの凍結や家庭内の過度の高温を防ぐためのバックストップとなる安全温度もあります。

サーモスタットがオフの場合、目標温度は設定されません。

温度までの時間

タイム・ツー・温度があなたがHVACシステムのため、これらのデータ値にアクセスできます:

  • time_to_target -時間は、数分で、それは構造のために取ることを目標温度に到達します
  • time_to_target_training
    • トレーニングステータス
    • サーモスタットは、HVACシステムがどのように応答するかを学習するときに、目標温度に到達するための見積もりを調整します
    • サーモスタットが目標温度に到達するまでの時間の見積もりの合理的に確実である場合には、ステータスが変化しますからtrainingready

周囲温度

サーモスタットの近くで測定した温度。ユーザーの好みの温度スケールに対応する値を表示します。

温度尺度

周囲温度と目標温度の変数は、摂氏または華氏のスケールで編成されています。 temperature_scale属性は、ユーザーの好みに応じて、「F」、または「C」のいずれかであろう。このプロパティは各サーモスタットによって設定されるため、1つの構造で、ユーザーが各温度スケールに1つずつ、合計2つのサーモスタットを持つ可能性があります。キープユーザーの好みに温度値を表示するときに念頭に置いて。

始まる権限バージョンV5 、あなたは、APIを介して温度スケールを変更することができます。

ターゲットと周囲温度フィールドが持っている_f_c温度を表示するときに一貫性のある丸めに対応するために、変異体です。

温度表示

サーモスタット

あなたが目標温度情報を表示すると、これら三つの依存の値を考慮してください。 temperature_scalehvac_mode 、および構造のaway状態に。

多くのデータ値が連携して、Nestサーモスタットディスプレイに表示される内容とその動作を決定します。

  • 場合hvac_modeに設定されているheat-cool 、ネストサーモスタットは低いが表示され、高い設定値は、行頭文字(•)、そうでなければ巣サーモスタットディスプレイだけ目標温度により分離しました
  • ときhvac_modeに設定されているoff 、単語「OFF」は、ユーザの優先言語で、巣サーモスタット上に表示されます
  • ときhvac_modeに設定されているeco 、単語「ECO」は、ユーザの優先言語で、巣サーモスタット上に表示されます

表示温度フォーマットも、選択した温度スケール (F/C) によって異なります。

華氏温度は整数で表示されます。

  • 目標温度:55°F
  • 周囲温度: 62°F

摂氏温度は整数または10進値として表示され、最後の桁は「.5」に設定されます。

  • 目標温度:12°C
  • 周囲温度:16.5°C

葉のアイコンは、サーモスタットの前面に表示されている場合、サーモスタットは省エネ温度に設定されており、 has_leaf = true

葉

温度ロック

ユーザーはNestサーモスタットをロックして、限られた温度範囲内でのみ調整できるようにすることができます。始まる権限バージョンv5の場合、あなたは見ることができ、温度ロックをチェックすることで有効になっているis_locked :、それがある場合、APIを介して温度ロック最小/最大値を読み込みます

ロックの温度が最大値と最小値として、ペアで指定する必要があり、そして場合にのみ書き込むことができるis_locked = true

湿度

デバイスで測定された湿度(パーセント(%)形式)は、最も近い5%に丸められます。

日焼け止め

日焼け止めの技術は、自動的にユニットに直射日光から生じる熱スパイクを補償するためにネストサーモスタットで温度を調整します。

これらのデータ値は、日焼け止めが有効になっているか、および/または積極的に温度を修正しているかどうかを示します。

  • sunlight_correction_enabled
    • ブール値、返すtrue日焼け止めが有効になっている場合
  • sunlight_correction_active -ブール値、戻りtrue日焼け止めは、サーモスタットが直射日光に位置していることを示す、アクティブである場合

ファン

多くのHVACシステムがあることを意味し、ファンを統合しているファンを独立に制御することができません。統合ファンにはオフモードはありません。これは、加熱または冷却がオンのときにファンを実行する必要があるためです。

ただし、HVACシステムに互換性がある場合は、APIを介してファンを明示的にオンにして、完全なHVACシステムを使用せずに居住者をより快適にすることができます。

ファンを独立に制御することができる場合は、 has_fanに設定されtrue読み取り/書き込み権限をし、次のデータ値はサーモスタットで設定することができます。

  • fan_timer_active -ブール値、返すtrueファンタイマは、事前にプログラム期間中に従事されている場合
  • fan_timer_duration - int型、時間(分)の長さがファンを実行するように設定されていること

これらの値を一緒に使用して、特定の期間、ファンタイマーを開始(ファンをオン)します。また、使用することができますfan_timer_timeoutファンが動作して停止するように設定されているときのタイムスタンプを決定するために値を。

あなたが常に変化することに注意してくださいfan_timer_duration -それはとは無関係ですhvac_mode (離れて)または構造占有状態。

成功または失敗すると、次の応答が期待できます。

  • 200 OK
  • 400不正な要求

ファンをオンにするコマンドで期待した結果が得られない場合は、ファンがすでに作動していることが原因である可能性があります(ユーザーが手動で、スケジュールに従って、またはHVACの加熱/冷却サイクルが原因で)。

レート制限

システムやバッテリーのパフォーマンスに影響を与える可能性のあるデバイスへの過度の通話から保護するために、レート制限を適用します。通常の状態では、Nestデバイスは冷暖房システムの低電圧配線からバッテリーを充電します。ただし、短時間に過度の通話が行われ、バッテリーレベルが低下すると、Nestサーモスタットは電力を節約するためにWi-Fiをオフにします。

実際には、これは、定義された期間内にデバイスに対して行うことができる呼び出しの数を制限することを意味します。この制限を超えると、エラー応答と制限を超えたことを示すメッセージが表示されます。

詳細については、データレート制限を

電力の制約

場合によっては、サーモスタットに変更要求を処理するのに十分なバッテリー電力がないことがあります。この場合、エラー応答と、現時点ではデバイスがリクエストを処理できないことを示すメッセージが表示されます。このような場合は、バッテリーを充電してから再試行してください。

詳細はこちら巣学習サーモスタットで低バッテリ条件

エラーメッセージ

一部の状態では、特定の機能が使用できなくなります。これらのルールは、エネルギーを節約したり、快適さと安全性を提供したりするために設けられています。

API呼び出しのエラーは何を意味するかの詳細については、どのように見、それらを処理するためにエラーメッセージを

Wi-Fi /接続の問題

デバイスがオフラインの場合、変更は許可されていません。データモデルでデバイスのオンライン状態を観察し、UIを適切に表示できます。