Notice: We're retiring Works with Nest. See the home page for more information.
Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.
Halaman ini diterjemahkan oleh Cloud Translation API.
Switch to English

Jauh & amp; ETA

Jauh

Dalam Nest API, konsep "Home" atau "Away" memiliki efek yang kuat pada perilaku penghematan energi dan fitur kenyamanan Nest.

Bagaimana Home dan Away bekerja

Nest menggunakan berbagai sinyal untuk mendeteksi keberadaan manusia di Rumah. Jika Nest tidak mendeteksi keberadaan untuk jangka waktu yang lama, ia secara otomatis mengatur rumah ke Away. Ketika mendeteksi keberadaan manusia, ia mengembalikan struktur ke kondisi asal.

Bereaksi terhadap perubahan dalam status Home / Away membuka berbagai peluang untuk produk Anda. Misalnya, produk Anda dapat:

  • Matikan lampu ketika rumah masuk ke Away untuk menghemat energi
  • Kirim pemberitahuan jika pintu garasi terbuka saat rumah Jauh
  • Putar musik saat rumah beralih ke Rumah

Cara kerja ETA

Dalam beberapa kasus, pengguna memiliki aplikasi pihak ke-3 yang menggunakan GPS untuk memberikan data perkiraan waktu kedatangan (ETA) ke Nest API. Dalam kasus lain, pengguna dapat menggunakan aplikasi untuk memasukkan ETA mereka secara manual. Atau mungkin ETA dihitung berdasarkan jadwal reguler pengguna.

Aplikasi ETA yang terintegrasi dengan Nest Thermostat menyebabkan termostat mulai menghangatkan atau mendinginkan rumah sebelum pengguna datang.

Ketika integrasi ETA / termostat ada di akun pengguna, data ETA tersedia untuk Pekerjaan lain dengan pengembang Nest untuk digunakan dalam integrasi Works with Nest mereka.

Setelah ETA dimasukkan ke dalam layanan Nest, integrasi Works with Nest lainnya dapat menggunakannya sebagai sinyal untuk mempersiapkan rumah bagi kedatangan pengguna.

  1. ETA ditulis oleh pengembang Nest menggunakan panggilan API PUT eta .
  2. Nest Thermostat menggunakan data ini.
  3. Jika pengembang lain juga ingin menggunakannya, mereka dapat menggunakan panggilan API GET eta_begin read-only.
Data ETA

Poin penting yang perlu diingat adalah bahwa data ETA harus dimasukkan oleh pihak ke-3. Nest saat ini tidak menyediakan data ETA. Jika data ETA belum ditulis, API Nest mengembalikan nilai "1970-01-01T00: 00: 00.000Z" default.

Misalkan, misalnya, Anda adalah penjual lampu. Anda bisa mendapatkan data ETA yang disediakan oleh integrasi ETA / termostat dan menggunakannya sebagai sinyal untuk menyalakan lampu.

Dengan cara ini, tidak hanya suhu nyaman, lampu juga menyala ketika pengguna tiba di rumah.

Bereaksi terhadap perubahan dalam status ETA membuka berbagai peluang untuk produk Anda. Misalnya, produk Anda dapat:

  • Nyalakan TV saat pengguna mendekati rumah
  • Buka pintu garasi ketika pengguna hampir di rumah
  • Sudah ada musik yang diputar ketika pengguna kembali ke rumah

Izin pergi

Tingkat izin akses berikut tersedia untuk nilai data terkait-Jauh :



Mengakses

Baca jauh
Jauh baca / tulis

ETA baca

Baca / tulis ETA

Alarm asap + CO membaca
Thermostat baca
Thermostat baca / tulis
away Iya Iya Iya
eta_begin (hanya baca) Iya Iya
objek eta (hanya tulis) Iya

Untuk info lebih lanjut, lihat Tinjauan Izin .

Fitur jauh

Rumah dan jauh

Nilai data away dapat memberi tahu Anda jika Nest berpikir struktur tersebut terisi. Nilai yang mungkin adalah:

Nilai Deskripsi
home Ada seseorang dalam struktur itu. Keadaan ini dapat diatur:
• oleh Nest jika memiliki kepercayaan diri yang tinggi dari data sensor gerak
• oleh pengguna melalui aplikasi Nest , Nest Thermostat, atau produk Anda
• secara algoritmik melalui ETA
away Tidak ada seorang pun di struktur. Pengguna telah secara eksplisit mengatur struktur untuk menjauh, baik melalui aplikasi Nest , Nest Thermostat, atau produk Anda.
unknown Jika tidak ada perangkat yang dikaitkan dengan struktur, maka negara jauh unknown .

Nest API menyediakan kemampuan untuk mengatur langsung Home and Away, serta mendengarkan perubahan pada status ini. Namun, ketika mengatur Home and Away, itu harus dilakukan sebagaimana aplikasi Nest melakukannya: sebagai hasil permintaan pengguna yang eksplisit. Mencoba menetapkan secara algoritmik kondisi ini berisiko menimbulkan pengalaman pengguna yang membingungkan dan dilarang oleh kebijakan desain Nest .

Ketahuilah bahwa pengguna selalu memiliki kemampuan untuk mengatur secara manual kondisi Home / Away.

Pelajari lebih lanjut tentang cara pengguna mengatur negara Asal dan Jauh .

ETA

Jauh

ETA adalah objek dengan bidang yang dapat diatur pada struktur. Ini digunakan untuk memberi tahu Nest bahwa pengguna diharapkan untuk kembali ke rumah pada waktu tertentu. Saat mengatur ETA, produk menghasilkan trip_id unik dan memberikan jendela kedatangan yang diharapkan, ditentukan oleh nilai-nilai berikut:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Karena keadaan di sekitar perjalanan dapat berubah karena lalu lintas, rencana pengguna yang diubah, dan acara lainnya, produk harus memperbarui ETA secara berkala seiring perjalanan berlangsung, memberi Nest arus perkiraan waktu kedatangan (5 menit adalah interval yang ideal).

Semakin banyak informasi yang kami terima, semakin yakin kami akan keandalan input ETA, yang membuat kami lebih percaya diri saat mengambil tindakan untuk mempersiapkan rumah.

ETA tidak tergantung pada negara bagian asal. Jika waktu kedatangan ETA bertentangan dengan ETA lain, waktu kedatangan paling awal diutamakan.

Lakukan panggilan tulis ETA

Logika ETA tergantung pada keberadaan Thermostat dalam struktur. Jika tidak ada termostat dalam struktur, panggilan yang dilakukan ke objek ETA gagal dengan pesan kesalahan "Tidak ada pasangan perangkat" . Kesalahan ini terjadi bahkan jika jenis perangkat lain ada dalam struktur (misalnya, Nest Cam atau Nest Nest).

Nilai data

Panggilan ETA membutuhkan nilai data berikut:

Nama Tipe Deskripsi
trip_id tali Pengidentifikasi perjalanan ETA yang unik
estimated_arrival_window_begin tali Stempel waktu
Harus lebih besar dari NOW , dalam format ISO 8601
estimated_arrival_window_end tali Stempel waktu
Harus lebih besar dari estimated_arrival_window_begin , dalam format ISO 8601

Karena kemungkinan putus koneksi dalam komunikasi GPS, kami menyarankan aliran sampel, idealnya setiap 5 menit.

Setiap panggilan ETA harus menyertakan string trip_id unik yang Anda tetapkan dalam panggilan awal. Parameter lain dapat berubah dengan panggilan berurutan ke trip_id sama.

Panggilan ETA mengembalikan 200 status kode HTTP OK jika berhasil.

Contohnya

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

Batalkan ETA

Untuk membatalkan eta, kirim estimated_arrival_window_begin = 0 . Periksa apakah Anda mengirim integer (0) dalam panggilan ini, bukan string ("0"), atau panggilan itu akan gagal.

Pesan kesalahan

Untuk informasi tentang arti kesalahan panggilan API dan cara menanganinya, lihat Pesan Kesalahan .