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

アウェイ&ETA

アウェイ

Nest APIでは、「ホーム」または「アウェイ」の概念が、Nestのエネルギー節約および便利な機能の動作に強力な影響を及ぼします。

ホームアンドアウェイのしくみ

Nestは、さまざまな信号を使用して、ホーム内の人間の存在を検出します。 Nestが長期間存在を検出しない場合、Nestは自動的にホームを退席中設定にします。人間の存在を検出すると、構造をホーム状態に戻します。

ホーム/アウェイステータスの変化に対応することで、製品にさまざまな機会が開かれます。たとえば、製品は次のことができます。

  • 家が離れるときは、エネルギーを節約するために電気を消してください
  • 家が離れているときにガレージのドアが開いている場合は通知を送信します
  • 家がホームに切り替わったときに音楽を再生する

ETAの仕組み

場合によっては、ユーザーはGPSを使用して到着予定時刻(ETA)データをNestAPIに提供するサードパーティのアプリを使用しています。その他の場合、ユーザーはアプリを使用して手動でETAを入力することがあります。または、ETAはユーザーの定期的なスケジュールに基づいて計算される場合があります。

Nest Thermostatと統合されているETAアプリにより、ユーザーが到着する前にサーモスタットが家を暖めたり冷やしたりし始めます。

ETA /サーモスタット統合がユーザーのアカウントに存在する場合、ETAデータは、他のWorks withNest開発者がWorkswithNest統合で使用できるようになります。

ETAがNestサービスに入力された後、別のWorks with Nest統合は、ETAを信号として使用して、ユーザーの到着に備えて家を準備することができます。

  1. ETAは、書き込み専用使用して巣の開発者によって書かれているPUT eta API呼び出しを
  2. Nestサーモスタットはこのデータを使用します。
  3. 他の開発者がそれを使用したい場合は、あまりにも、彼らは読み取り専用に使用することができますGET eta_begin API呼び出しを
ETAデータ

覚えておくべき重要な点は、ETAデータはサードパーティによって入力される必要があるということです。 Nestは現在ETAデータを提供していません。 ETAデータが書き込まれていない場合、NestAPIはデフォルトの「1970-01-01T00:00:00.000Z」値を返します。

たとえば、あなたが照明ベンダーであるとします。 ETA /サーモスタット統合によって提供されるETAデータを取得し、それを信号として使用してライトをオンにすることができます。

このように、温度が快適であるだけでなく、ユーザーが家に着いたときにライトも点灯します。

ETAステータスの変化に対応することで、製品にさまざまな機会が開かれます。たとえば、製品は次のことができます。

  • ユーザーが家に近づいたらテレビの電源を入れます
  • ユーザーがほとんど家にいるときにガレージのドアを開けます
  • ユーザーが帰宅したときにすでに音楽を再生している

アウェイパーミッション

以下のアクセス許可レベルは、のために用意されていアウェイ関連のデータ値



アクセス

読んで
アウェイ読み取り/書き込み

ETA読み取り

ETA読み取り/書き込み

煙+ COアラーム読み取り
サーモスタット読み取り
サーモスタットの読み取り/書き込み
awayはいはいはい
eta_begin (読み取り専用)はいはい
etaオブジェクト(書き込みのみ)はい

詳細情報については、参照権限の概要を

アウェイ機能

ホームアンドアウェイ

away巣は構造が占有されていると考えた場合、データ値はあなたを伝えることができます。可能な値は次のとおりです。

説明
home構造物の中に誰かがいます。この状態は次のように設定できます。
•モーションセンサーデータからの信頼性が高い場合はNestによる
•を介してユーザによって巣アプリ、巣サーモスタット、またはお使いの製品
•ETAを介してアルゴリズム的に
away構造には誰もいません。ユーザーが明示的にのいずれかを介して、離れに構造を設定した巣のアプリ、巣サーモスタット、またはお使いの製品。
unknown装置がない構造に関連付けされていない場合は、離れて状態があるunknown

Nest APIは、ホームアンドアウェイを直接設定する機能と、これらの状態の変化をリッスンする機能を提供します。ホームを設定し、アウェイときしかし、それが行われるべき巣のアプリがそれをしない:明示的なユーザー要求の結果として。アルゴリズムこの状態を設定しようとすると、混乱のユーザーエクスペリエンスを作成する危険性を実行し、によって禁止された巣の設計方針

ユーザーは常に手動でホーム/アウェイ状態を設定する能力を持っていることに注意してください。

詳細情報、ユーザーがホームとアウェイの状態を設定する方法

ETA

アウェイ

ETAは、構造上で設定することができますフィールドを持つオブジェクトです。これは、ユーザーが特定の時間に帰宅する予定であることをNestに通知するために使用されます。 ETAを設定する場合、生成物は独特の生成trip_id 、次の値で指定された到着の予想されるウィンドウを、提供します。

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

交通状況、ユーザープランの変更、その他のイベントによって旅行の状況が変わる可能性があるため、製品は旅行の進行に合わせてETAを定期的に更新し、Nestに到着予定時刻のストリームを提供する必要があります(5分が理想的な間隔です)。

受け取る情報が多ければ多いほど、ETA入力の信頼性に自信が持てるようになり、家を準備するための行動を起こすときに自信が持てるようになります。

ETAは本国の州から独立しています。 ETAの到着時刻が別のETAと競合する場合は、最も早い到着時刻が優先されます。

ETA書き込み呼び出しを行う

ETAロジックは、構造内のサーモスタットの存在に依存しています。何の構造に存在しない場合は、サーモスタット、ETAのオブジェクトへの呼び出しは失敗して、「いいえデバイスをペアリング」のエラーメッセージが表示されます。このエラーは、構造内に他の種類のデバイス(NestCamやNestProtectなど)が存在する場合でも発生します。

データ値

ETA呼び出しには、次のデータ値が必要です。

名前タイプ説明
trip_idストリング一意のETAトリップ識別子
estimated_arrival_window_beginストリングタイムスタンプ
より大きくなければなりませんNOWで、 ISO 8601形式
estimated_arrival_window_endストリングタイムスタンプ
より大きくなければなりませんestimated_arrival_window_beginで、 ISO 8601形式

GPS通信で接続が切断される可能性があるため、サンプルのストリームをお勧めします。理想的には5分に1回です。

すべてのETAの呼び出しは、ユニーク含まれている必要がありtrip_idあなたが最初の呼び出しで定義する文字列を。他のパラメータは同じに連続して呼び出すと変更することができますtrip_id

ETA呼び出しは、成功すると200 OKHTTPステータスコードを返します。

カール
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をキャンセルする

イータをキャンセルするには、送信estimated_arrival_window_begin = 0 。この呼び出しで文字列( "0")ではなく整数(0)を送信していることを確認してください。送信しないと、呼び出しは失敗します。

エラーメッセージ

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