Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
דף זה תורגם על ידי Cloud Translation API.
Switch to English

עשן + אזעקת CO

עשן + אזעקת CO

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

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

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

הרשאות עשן + CO

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

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

מזהים עשן + CO

התקן

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

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

שֵׁם

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

name

בדוגמה זו name הוא "Nest Protect".

שֵׁם

name_long

בדוגמה זו name_long הוא "מגן על קן המרתף".

שם ארוך

איפה

where_id

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

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

where_name

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

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

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

ערך נתונים תיאור
locale השפה וקוד המדינה שהוקצו למכשיר זה
software_version מחרוזת המייצגת את הקושחה המותקנת כעת במכשיר
structure_id מחרוזת המייצגת באופן ייחודי את המבנה הזה; זהו המבנה שאליו נקשר ההתקן
last_connection חותמת הזמן של החיבור המוצלח האחרון לשירות הקן
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_color_state , שנותן אינדיקציה ברמה גבוהה למצב הכללי של Nest Protect. זה נגזר מ- is_online , battery_health , co_alarm_state ו- smoke_alarm_state , ומספקים מצב מצטבר המשקף את מחוון הצבעים בפועל המוצג באפליקציית Nest .

הודעות שגיאה

למידע על המשמעות של שגיאות קריאת API וכיצד לטפל בהן, עיין בהודעות שגיאה .