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

אזעקת עשן + CO

אזעקת עשן + CO

Nest Protect נועד לזהות עשן ופחמן חד חמצני (CO) בסביבת מגורים, עם חיישנים מרובים כדי לסייע לה להבין מה קורה בבית.

API קן מספק גישה לנתונים הבאים על Nest Protect:

  • מצב אזעקת עשן או פחמן חד חמצני (CO)
  • מצב בריאות הסוללה
  • מצב הבדיקה הידני האחרון וחותמת הזמן
  • מצב מקוון ומידע על חיבור אחרון
  • שם המבנה ומכשיר "איפה שם" (מיקום בבית)

הרשאות עשן + CO

לקבלת גישה לקריאה לכל ערכי הנתונים API גלאי עשן + CO, לבחור את עשן + CO לקרוא רשות הלקוח שלך.

אין הרשאות כתיבה זמינות עבור ממשק ה- API לעשן + CO.

מזהי עשן + CO

התקן

מכשירי Nest רשומים לפי סוג כמערך של מזהים, שניתן להשתמש בהם כדי לזהות מכשיר באופן ייחודי דרך נתיב המכשיר. אז מזהה אזעקת עשן + שיתוף של "RTMTKxs..." כלומר, אתה יכול לטעון את דגם המכשיר גלאי עשן + שיתוף ב devices/smoke_co_alarms/RTMTKxs... דרך ממשק ה- API.

כאשר מכשיר מחובר למספר מוצרים, כל מפתח יראה מזהה אחר עבור אותו מכשיר. עבור מכשיר שהתקין מספר מוצרים מאותו מפתח, המפתח יראה את אותו מזהה.

שֵׁם

שתי תכונות שם מסופקות. קצרה יותר name התכונה מוצגת תוויות ממשק משתמש, תוך name_long משמש בטקסט בצורה ארוכה.

name

בדוגמה זו, name הוא "קן להגן".

שֵׁם

name_long

בדוגמה זו, name_long הוא "מרתף Nest Protect".

שם ארוך

איפה

where_id

  • מזהה ייחודי, שנוצר קן שמייצג name
  • where_id הוא לקריאה בלבד, והוא נוצר אוטומטית את השיחה כדי ליצור מנהג שבו name

למידע נוסף על שם שמות תרמוסטט קן ,קן מגן ו מצלמות קן .

where_name

כאשר אתה בוחר את העשן + CO לקרוא רשות , אתה יכול לגשת למכשיר where_name מאובייקט המכשיר ( devices/smoke_co_alarms ).

מטא נתונים אחרים

כל ערכי הנתונים נקראים בלבד, אלא אם כן צוין אחרת.

ערך נתונים תיאור
locale השפה וקוד המדינה שהוקצו למכשיר זה
software_version מחרוזת המייצגת את הקושחה המותקנת כעת בהתקן
structure_id מחרוזת המייצגת באופן ייחודי מבנה זה; זה המבנה שאליו משויך המכשיר
last_connection חותמת הזמן של החיבור המוצלח האחרון לשירות Nest
is_online סטטוס מקוון. זה נקבע על ידי קן באמצעות last_connection הזמן וחלון מחודש צפוי כי הוא ספציפי למכשיר.

תכונות עשן + CO

בריאות הסוללה

השתמש battery_health שדה כדי להציג את מצב תקינות הסוללה.

ערך תיאור
ok רמת הסוללה בסדר
replace רמת הסוללה נמוכה, יש להחליפה

אזעקת CO

השתמש co_alarm_state השדה כדי להציג את מצב אזעקת CO.

ערך תיאור
ok פעולה רגילה
warning איתור רמות עלייה של CO
emergency רמות CO גבוהות מדי, המשתמש צריך לצאת מהבית

גלאי עשן

השתמש smoke_alarm_state השדה כדי להציג את מצב גלאי עשן.

ערך תיאור
ok פעולה רגילה
warning איתור עליית רמות העשן
emergency רמות עשן גבוהות מדי, על המשתמש לצאת מהבית

בדיקה ידנית

השתמש בשדות אלה כדי לבדוק אם בדיקת עשן או CO ידנית פעילה כעת, ובפעם האחרונה שבוצעה בדיקת עשן או CO מוצלחת.

מצב צבע ממשק משתמש

כדי להקל לעצב UI צולב מוצר קוהרנטית, ספקנו ui_color_state השדה, אשר נותן אינדיקציה ברמה גבוהה של המצב הכללי של Nest Protect. הוא נגזר is_online , battery_health , co_alarm_state , ו smoke_alarm_state , מתן תנאי במצטבר המשקף האינדיקטורים צבע בפועל המוצג אפליקציית Nest .

הודעות שגיאה

לקבלת מידע על מה שגיאות קריאה API אומר ואיך לטפל בהם, לראות הודעות שגיאה .