Google is committed to advancing racial equity for Black communities. See how.

สัญญาณเตือนควัน+CO

สัญญาณเตือนควัน + CO

Nest Protect ถูกออกแบบมาเพื่อตรวจจับควันและก๊าซคาร์บอนมอนอกไซด์ (CO) ในสภาพแวดล้อมที่อยู่อาศัยที่มีเซ็นเซอร์หลายเพื่อช่วยให้มันเข้าใจสิ่งที่เกิดขึ้นในบ้าน

Nest API ให้การเข้าถึงข้อมูลต่อไปนี้บน Nest Protect:

  • สถานะสัญญาณเตือนควันหรือคาร์บอนมอนอกไซด์ (CO)
  • สถานะความสมบูรณ์ของแบตเตอรี่
  • สถานะการทดสอบด้วยตนเองล่าสุดและการประทับเวลา
  • สถานะออนไลน์และข้อมูลการเชื่อมต่อล่าสุด
  • ชื่อโครงสร้างและอุปกรณ์ "ชื่อไหน" (ตำแหน่งในบ้าน)

สิทธิ์สูบบุหรี่+CO

สำหรับการเข้าถึงแบบอ่านไปสูบบุหรี่ + CO ค่าข้อมูลเตือนภัย API ทั้งหมดเลือก สูบบุหรี่ + CO อ่าน อนุญาตสำหรับลูกค้าของคุณ

ไม่มีสิทธิ์เขียนสำหรับ API สัญญาณเตือน Smoke+CO

ตัวระบุควัน+CO

อุปกรณ์

อุปกรณ์ Nest จะแสดงรายการตามประเภทเป็นอาร์เรย์ของรหัส ซึ่งสามารถใช้เพื่อระบุอุปกรณ์โดยไม่ซ้ำกันผ่านเส้นทางอุปกรณ์ ดังนั้น ID ควัน + ปลุกร่วมของ "RTMTKxs..." หมายความว่าคุณสามารถโหลดควัน + ร่วมรุ่นของอุปกรณ์ปลุก devices/smoke_co_alarms/RTMTKxs... ผ่าน API

เมื่ออุปกรณ์เชื่อมต่อกับหลายผลิตภัณฑ์ นักพัฒนาแต่ละรายจะเห็น ID ที่แตกต่างกันสำหรับอุปกรณ์นั้น สำหรับอุปกรณ์ที่ติดตั้งผลิตภัณฑ์หลายรายการจากผู้พัฒนารายเดียวกัน ผู้พัฒนาจะเห็นรหัสเดียวกัน

ชื่อ

มีการระบุแอตทริบิวต์ชื่อสองรายการ สั้น name แอตทริบิวต์จะแสดงในฉลากส่วนติดต่อผู้ใช้ในขณะที่ name_long ถูกนำมาใช้ในข้อความแบบยาว

name

ในตัวอย่างนี้ name คือ "Nest Protect"

ชื่อ

name_long

ในตัวอย่างนี้ name_long คือ "ชั้นใต้ดิน Nest Protect"

ชื่อยาว

ที่ไหน

where_id

  • ที่ไม่ซ้ำกันระบุ Nest สร้างที่แสดงถึง name
  • where_id อ่านอย่างเดียวและถูกสร้างขึ้นโดยอัตโนมัติในการเรียกร้องให้สร้างที่กำหนดเองที่ name

เรียนรู้เพิ่มเติมเกี่ยวกับการที่ชื่อ Thermostats Nest ,Nest ปกป้อง และ กล้อง Nest

where_name

เมื่อคุณเลือก สูบบุหรี่ + CO สิทธิ์ในการอ่าน คุณสามารถเข้าถึงอุปกรณ์ where_name จากวัตถุอุปกรณ์ ( devices/smoke_co_alarms )

ข้อมูลเมตาอื่นๆ

ค่าข้อมูลทั้งหมดเป็นแบบอ่านอย่างเดียว เว้นแต่จะระบุไว้เป็นอย่างอื่น

ค่าข้อมูล คำอธิบาย
locale ภาษาและรหัสประเทศที่กำหนดให้กับอุปกรณ์นี้
software_version สตริงที่แสดงถึงเฟิร์มแวร์ที่ติดตั้งบนอุปกรณ์ในปัจจุบัน
structure_id สตริงที่แสดงถึงโครงสร้างนี้โดยเฉพาะ นี่คือโครงสร้างที่อุปกรณ์จับคู่ด้วย
last_connection การประทับเวลาของการเชื่อมต่อที่สำเร็จครั้งล่าสุดกับบริการ Nest
is_online สถานะออนไลน์ นี้จะถูกกำหนดโดย Nest ใช้ last_connection เวลาและหน้าต่างต่อสัญญาณที่คาดว่าเป็นอุปกรณ์เฉพาะ

คุณสมบัติควัน+CO

สุขภาพแบตเตอรี่

ใช้ battery_health ฟิลด์ดูสถานะสุขภาพของแบตเตอรี่

ความคุ้มค่า คำอธิบาย
ok ระดับแบตเตอรี่โอเค
replace ระดับแบตเตอรี่ต่ำ ควรเปลี่ยน

สัญญาณเตือน CO

ใช้ co_alarm_state ฟิลด์เพื่อดูสถานะการเตือนภัย CO

ความคุ้มค่า คำอธิบาย
ok ดำเนินการตามปกติ
warning การตรวจจับระดับ CO ที่เพิ่มขึ้น
emergency ระดับ CO สูงเกินไป ผู้ใช้ควรออกจากบ้าน

เครื่องตรวจจับควัน

ใช้ smoke_alarm_state ฟิลด์เพื่อดูสถานะการเตือนภัยควัน

ความคุ้มค่า คำอธิบาย
ok ดำเนินการตามปกติ
warning การตรวจจับระดับควันที่เพิ่มขึ้น
emergency ระดับควันสูงเกินไป ผู้ใช้ควรออกจากบ้าน

การทดสอบด้วยตนเอง

ใช้ฟิลด์เหล่านี้เพื่อตรวจสอบว่าการทดสอบควันด้วยตนเองหรือ CO กำลังทำงานอยู่หรือไม่ และครั้งล่าสุดที่ทำการทดสอบควันหรือคาร์บอนไดออกไซด์สำเร็จ

สถานะสี UI

เพื่อให้ง่ายในการออกแบบ UI ข้ามผลิตภัณฑ์ที่สอดคล้องกันเราได้ให้ ui_color_state ฟิลด์ซึ่งจะช่วยให้เป็นตัวบ่งชี้ระดับสูงของรัฐโดยรวมของรังป้องกัน มันมาจาก is_online , battery_health , co_alarm_state และ smoke_alarm_state ให้สภาพการรวมตัวชี้วัดที่สะท้อนให้เห็นสีที่เกิดขึ้นจริงที่ปรากฏใน แอป Nest

ข้อความแสดงข้อผิดพลาด

สำหรับข้อมูลเกี่ยวกับสิ่งที่ผิดพลาดที่เรียก API หมายและวิธีการที่จะจัดการกับพวกเขาเห็น ข้อความข้อผิดพลาด