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

Alarm Asap + CO

Alarm asap + CO

Nest Protect dirancang untuk mendeteksi asap dan karbon monoksida (CO) di lingkungan perumahan, dengan beberapa sensor untuk membantu memahami apa yang terjadi di rumah.

The Nest API menyediakan akses ke data berikut di Nest Protect:

  • Status alarm asap atau karbon monoksida (CO)
  • Status kesehatan baterai
  • Status dan stempel waktu pengujian manual terakhir
  • Status online dan informasi koneksi terakhir
  • Struktur nama dan perangkat "where name" (lokasi di rumah)

Izin Asap+CO

Untuk akses baca ke semua + CO asap nilai alarm API data, pilih asap + CO membaca izin untuk klien Anda.

Tidak ada izin menulis yang tersedia untuk API alarm Asap+CO.

Pengidentifikasi asap+CO

Alat

Perangkat Nest dicantumkan menurut jenisnya sebagai larik ID, yang dapat digunakan untuk mengidentifikasi perangkat secara unik melalui jalur perangkat. Jadi asap + co ID alarm "RTMTKxs..." berarti bahwa Anda dapat memuat asap + co alarm model perangkat di devices/smoke_co_alarms/RTMTKxs... melalui API.

Saat perangkat terhubung ke beberapa produk, setiap pengembang akan melihat ID yang berbeda untuk perangkat tersebut. Untuk perangkat yang telah menginstal beberapa produk dari pengembang yang sama, pengembang akan melihat ID yang sama.

Nama

Dua atribut nama disediakan. Semakin pendek name atribut ditampilkan dalam label antarmuka pengguna, sementara name_long digunakan dalam bentuk teks panjang.

name

Dalam contoh ini, name adalah "Nest Protect".

Nama

name_long

Dalam contoh ini, name_long adalah "Basement Nest Protect".

Nama panjang

Dimana

where_id

  • Yang unik,-Nest dihasilkan identifier yang mewakili name
  • where_id read-only, dan dibuat secara otomatis dalam panggilan untuk membuat custom mana name

Pelajari lebih lanjut tentang di mana nama untuk Termostat Nest ,Nest Melindungi dan Nest Cams .

where_name

Bila Anda memilih asap + CO membaca izin , Anda dapat mengakses perangkat where_name dari objek perangkat ( devices/smoke_co_alarms ).

Metadata lainnya

Semua nilai data hanya dapat dibaca, kecuali ditentukan lain.

Nilai Data Deskripsi
locale Bahasa dan kode negara yang ditetapkan untuk perangkat ini
software_version String yang mewakili firmware yang saat ini diinstal pada perangkat
structure_id Sebuah string yang secara unik mewakili struktur ini; ini adalah struktur yang dipasangkan dengan perangkat
last_connection Stempel waktu koneksi terakhir yang berhasil ke layanan Nest
is_online Status daring. Hal ini ditentukan oleh Nest menggunakan last_connection waktu dan diharapkan rekoneksi jendela yang khusus perangkat.

Fitur Asap + CO

Kesehatan baterai

Gunakan battery_health lapangan untuk melihat kondisi kesehatan baterai.

Nilai Deskripsi
ok Tingkat baterai oke
replace Tingkat baterai rendah, harus diganti

alarm CO

Gunakan co_alarm_state lapangan untuk melihat keadaan CO alarm.

Nilai Deskripsi
ok Operasi normal
warning Deteksi peningkatan kadar CO
emergency Tingkat CO terlalu tinggi, pengguna harus keluar dari rumah

Alarm asap

Gunakan smoke_alarm_state lapangan untuk melihat keadaan alarm asap.

Nilai Deskripsi
ok Operasi normal
warning Deteksi kenaikan tingkat asap smoke
emergency Tingkat asap terlalu tinggi, pengguna harus keluar dari rumah

Tes manual

Gunakan bidang ini untuk memeriksa apakah uji asap atau CO manual saat ini aktif, dan terakhir kali uji asap atau CO berhasil dilakukan.

Status warna UI

Untuk membuatnya lebih mudah untuk merancang sebuah UI cross-produk yang koheren, kami telah menyediakan ui_color_state lapangan, yang memberikan indikasi tingkat tinggi dari negara secara keseluruhan Nest Protect. Hal ini berasal dari is_online , battery_health , co_alarm_state , dan smoke_alarm_state , menyediakan kondisi agregat yang mencerminkan indikator warna sebenarnya ditampilkan dalam aplikasi Nest .

Pesan kesalahan

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