Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Pergi & ETA

Jauh

Di Nest API, konsep "Rumah" atau "Pergi" memiliki efek yang kuat pada perilaku fitur hemat energi dan kenyamanan Nest.

Cara kerja Di Rumah dan Pergi

Nest menggunakan berbagai sinyal untuk mendeteksi keberadaan manusia di Rumah. Jika Nest tidak mendeteksi kehadiran untuk waktu yang lama, Nest akan otomatis menyetel rumah ke Pergi. Saat mendeteksi keberadaan manusia, ia mengembalikan struktur ke status Asal.

Bereaksi terhadap perubahan status Di Rumah/Pergi membuka berbagai peluang untuk produk Anda. Misalnya, produk Anda dapat:

  • Matikan lampu saat rumah dalam mode Pergi untuk menghemat energi
  • Kirim pemberitahuan jika pintu garasi terbuka saat rumah pergi
  • Putar musik saat rumah beralih ke Rumah

Cara kerja ETA

Dalam beberapa kasus, pengguna memiliki aplikasi pihak ketiga yang menggunakan GPS untuk memberikan data perkiraan waktu kedatangan (ETA) ke Nest API. Dalam kasus lain, pengguna mungkin 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 tiba.

Saat integrasi ETA/termostat ada di akun pengguna, data ETA tersedia untuk developer Works with Nest lainnya untuk digunakan dalam integrasi Works with Nest mereka.

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

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

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

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 begitu, tidak hanya suhu yang nyaman, lampu juga menyala saat pengguna tiba di rumah.

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

  • Nyalakan TV saat pengguna mendekati rumah
  • Buka pintu garasi saat pengguna hampir pulang
  • Apakah musik sudah diputar saat pengguna kembali ke rumah

Izin pergi

Berikut tingkat akses izin yang tersedia untuk nilai data Jauh-terkait :



Mengakses

Jauh membaca
Jauh membaca/menulis

ETA baca

ETA baca/tulis

Alarm asap + CO terbaca
termostat membaca
Baca/tulis termostat
away Iya Iya Iya
eta_begin (baca saja) Iya Iya
eta objek (write only) Iya

Untuk info lebih lanjut, lihat Ikhtisar Izin .

Fitur tandang

Rumah dan Pergi

The away nilai data dapat memberitahu Anda jika Nest berpikir struktur ditempati. Nilai yang mungkin adalah:

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

Nest API menyediakan kemampuan untuk mengatur mode Di Rumah dan Pergi secara langsung, serta mendengarkan perubahan pada status ini. Namun, ketika menetapkan Home and Away, hal itu harus dilakukan sebagai aplikasi Nest melakukannya: sebagai hasil dari permintaan pengguna eksplisit. Mencoba untuk algorithmically mengatur negara ini menjalankan risiko menciptakan pengalaman pengguna yang membingungkan dan dilarang oleh kebijakan desain Nest .

Sadarilah bahwa pengguna selalu memiliki kemampuan untuk mengatur secara manual Home / negara Away.

Pelajari lebih lanjut tentang bagaimana pengguna mengatur Rumah dan negara jauh .

ETA

Jauh

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

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Karena keadaan di sekitar perjalanan dapat berubah karena lalu lintas, perubahan rencana pengguna, dan peristiwa lainnya, produk harus memperbarui ETA secara berkala saat perjalanan berlangsung, memberikan Nest aliran perkiraan waktu kedatangan (5 menit adalah interval 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 bergantung pada negara bagian asal. Jika waktu kedatangan ETA bertentangan dengan ETA lain, waktu kedatangan paling awal akan diutamakan.

Lakukan panggilan tulis ETA

Logika ETA tergantung pada keberadaan Termostat dalam struktur. Jika tidak ada termostat ada dalam struktur, panggilan dibuat ke objek ETA gagal dengan "No dipasangkan perangkat" pesan kesalahan. Kesalahan ini terjadi meskipun ada jenis perangkat lain dalam struktur (misalnya, Nest Cam atau Nest Protect).

Nilai data

Panggilan ETA memerlukan 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 , di ISO 8601 Format
estimated_arrival_window_end tali stempel waktu
Harus lebih besar dari estimated_arrival_window_begin , di ISO 8601 Format

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

Setiap panggilan ETA harus menyertakan unik trip_id string yang Anda menentukan dalam panggilan awal. Parameter lainnya dapat berubah dengan panggilan berturut-turut untuk sama trip_id .

Panggilan ETA mengembalikan kode status HTTP 200 OK jika berhasil.

Contoh

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 bilangan bulat (0) dalam panggilan ini, bukan string ("0"), atau panggilan akan gagal.

Pesan kesalahan

Untuk informasi tentang apa kesalahan API panggilan berarti dan bagaimana untuk menangani mereka, lihat Pesan Kesalahan .