Googleは、黒人コミュニティのための人種的衡平の促進に取り組んでいます。 方法をご覧ください。
このページは Cloud Translation API によって翻訳されました。
Switch to English

サーモスタット

サーモスタット制御

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

これらの機能をサポートするには、単純なセットポイントベースのプログラムを超える高度な制御システムが必要です。 Nestは、ほとんどのサーモスタットに比べてかなりの計算能力を必要とする幅広いアルゴリズム( Early OnTrue RadiantAirwave™など )を提供します。 Nestサーモスタットは、これらの高度な機能を提供するために必要なパワーを備えています。

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

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

サーモスタットの権限

すべてのサーモスタットAPIデータ値への読み取りアクセスについては、クライアントのサーモスタット読み取り権限を選択します。

すべてのサーモスタットAPIデータ値への読み取りアクセスと、値を選択するための追加の書き込みアクセスについては、クライアントのサーモスタット読み取り/書き込み権限を選択します。このアクセス許可レベルでは、以下を更新できます。

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

サーモスタットの読み取り/書き込みv5以降では、次のものも更新できます。

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

サーモスタット識別子

端末

Nestデバイスは、IDの配列としてタイプ別にリストされます。これは、デバイスパスを介してデバイスを一意に識別するために使用できます。したがって、 "peyiJNo..."サーモスタットIDは、APIを介してdevices/thermostats/peyiJNo...サーモスタットデバイスモデルをロードできることを意味します。

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

名前

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

name

これらの例では、 nameは「Hallway」または「Hallway(West)」です。

名前長い名前

name_long

この例では、 name_longは「Office(Upstairs)」です。

メッセージで長い名前

ラベル

場所(ラベル)
場所(ラベル)

権限バージョンv5以降、APIを介してカスタムサーモスタットラベルを追加できます。 Nestアプリでは、ラベルはwhere名の後の括弧内に表示されます。

権限バージョンv6以降、サーモスタットラベルを読むこともできます。

どこ

where_id

  • nameを表す、ネストによって生成された一意の識別子
  • where_idは読み取り専用で、カスタムwhere nameを作成する呼び出しで自動的に作成されます

NestサーモスタットNest ProtectsNest Camsの名称の詳細をご覧ください。

where_name

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

その他のメタデータ

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

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

サーモスタットの機能

サーモスタットモード

HVACシステムには、4つの「オン」状態( heatcoolheat-cooleco )と1つの「オフ」状態( off )があります。これらの状態を使用して、 hvac_modeと温度データ値を通じて快適性とエネルギー節約を管理します。

  • HeatまたはCoolモード( heatcool )が選択されている場合、サーモスタットは家を目標温度に調整します。
  • heat-coolheat-coolモード( heat-cool )が選択されている場合、サーモスタットは、家を快適な状態に保ちます。
  • エコ温度 (eco)を選択すると、サーモスタットは省エネアルゴリズムを適用して、家を快適に保ち、エネルギー使用量を削減します。このモードのサーモスタットはECOを表示します。

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

hvac_modeと温度の値がどのようにhvac_mode

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

HVACモードアクセスできる温度データ値
heatまたはcool target_temperature_fまたはtarget_temperature_c
heat-cool target_temperature_low_ftarget_temperature_high_f
または
target_temperature_low_cおよびtarget_temperature_high_c
eco eco_temperature_low_feco_temperature_high_f
または
eco_temperature_low_ceco_temperature_high_c
off なし

一部のシナリオでは、 hvac_mode変更hvac_mode特別なルールがあります。

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

エコ温度

エコ温度により、ユーザーは家にいてもいなくても、エネルギーを節約できます。製品に省エネ動作を実装するときは、 hvac_modeecoに切り替えることを検討してください。

Eco Temperatureエンドポイントは、サーモスタットの読み取りおよび読み取り/書き込みv6権限で始まるNest APIで使用できます。

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

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

絶対に目標温度を直接変更する必要がある場合は、次の2つの呼び出しで変更してください。

  1. hvac_modeeco以外の他の値に変更します
  2. 適切なtarget_temperatureデータ値を変更します

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

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

  1. previous_hvac_mode取得します
  2. hvac_modeprevious_hvac_mode値に設定します
  3. hvac_modeが「eco」に設定されていないことを確認しhvac_mode

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

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

hvac_mode状態が... 次に、 previous_hvac_modeは...
eco heatcoolheat-coolまたはoff
heatcoolheat-coolまたはoff 空白/空

目標温度

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

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

  • HeatまたはCoolモード( heatcool )を選択すると、単一のtarget_temperatureが設定されます
  • 加熱•冷却モード( heat-cool )が選択されている場合、2つのtarget_temperature値が設定され、ターゲット範囲を示します。
  • エコモード( eco )を選択した場合、目標温度範囲は内部で設定されます

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

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

温度までの時間

Time-to-Temperatureを使用すると、HVACシステムの次のデータ値にアクセスできます。

  • time_to_target構造が目標温度に到達するのにかかる時間(分)
  • time_to_target_training
    • トレーニング状況
    • サーモスタットはHVACシステムがどのように応答するかを学習するため、目標温度に到達するための推定値を調整します
    • サーモスタットが目標温度に到達するまでの推定時間を合理的に確信している場合、ステータスはtrainingからready変わります

周囲温度

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

温度スケール

周囲温度と目標温度の変数は、摂氏または華氏のスケールで編成されています。 temperature_scale属性は、ユーザーの設定に応じて「F」または「C」になります。このプロパティは各サーモスタットによって設定されるため、単一の構造で、ユーザーが2つのサーモスタット(各温度スケールに1つ)を持つ可能性があります。温度値を表示するときは、 ユーザー設定を考慮してください。

権限バージョンv5以降、APIを使用して温度スケールを変更できます。

目標および周囲温度フィールドには、温度を表示するときに一貫した丸めに対応するための_fおよび_cバリアントがあります。

温度表示

サーモスタット

ターゲットの温度情報を表示するときは、次の3つの依存値を考慮してください: temperature_scalehvac_mode 、および構造体のaway状態。

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

  • hvac_modeheat-coolに設定されている場合、Nestサーモスタットは、箇条書き文字(•)で区切られたhvac_modehvac_mode設定値を表示します。それ以外の場合は、Nestサーモスタットは目標温度のみを表示します
  • hvac_modeoffに設定されている場合、Nest Thermostatに「OFF」という単語がユーザーの優先言語で表示されます。
  • hvac_modeecoに設定されている場合、Nest Thermostatに「ECO」という単語がユーザーの優先言語で表示されます。

表示温度の形式は、選択した温度スケール(F / C)にも依存します。

華氏温度は整数として表示されます。

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

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

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

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

葉

温度ロック

ユーザーはNestサーモスタットをロックして、限られた温度範囲内でのみ調整できるようにすることができます。 パーミッションバージョンv5以降、 is_lockedをチェックすることで温度ロックが有効になっているかどうかを確認is_locked 、有効になっている場合は、APIを介して温度ロックの最小/最大値を読み取ります。

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

湿度

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

日焼け止め

日焼け止めテクノロジーにより、Nestサーモスタットの温度が自動的に調整され、ユニットに直射日光が当たると発生する熱スパイクが補正されます。

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

ファン

多くのHVACシステムにはファンが組み込まれています 。つまり、 ファンを個別に制御することはできません 。内蔵ファンには、加熱または冷却がオンのときにファンを稼働させる必要があるため、オフモードはありません。

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

ファンを個別に制御できる場合、 has_fantrueに設定され、次のデータ値をサーモスタットの読み取り/書き込み権限で設定できます。

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

なお、 fan_timer_durationはいつでも変更できます。これは、 hvac_modeや構造体の占有状態(アウェイ)とは無関係です。

成功または失敗したときにこれらの応答を期待できます。

  • 200 OK
  • 400不正な要求

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

レート制限

システムまたはバッテリーのパフォーマンスに影響を与える可能性のあるデバイスへの過剰な呼び出しから保護するために、レート制限を適用します。通常の状態では、Nestデバイスは冷暖房システムの低電圧ワイヤーからバッテリーを充電します。ただし、過度の通話が短時間で行われ、電池残量が少なくなると、Nest ThermostatはWi-Fiをオフにして電力を節約します。

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

詳細については、「 データレート制限」を参照してください。

電力の制約

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

Nestラーニングサーモスタットで電池残量低下の詳細をご覧ください。

エラーメッセージ

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

API呼び出しエラーの意味とその処理方法については、「 エラーメッセージ」を参照してください。

Wi-Fi /接続の問題

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