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

Away & ETA

רָחוֹק

בממשק ה- API של Nest, המושג "בית" או "רחוק" משפיע רבות על התנהגויות חיסכון באנרגיה ותכונות הנוחות של נסט.

איך עובד בית וחוץ

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

תגובה לשינויים בסטטוס הבית / הרחק פותחת מגוון רחב של הזדמנויות עבור המוצרים שלך. לדוגמה, המוצרים שלך יכולים:

  • כבה את האורות כאשר הבית נכנס למרחק כדי לחסוך באנרגיה
  • שלח הודעה אם דלת המוסך פתוחה כשהבית רחוק
  • השמע מוסיקה כאשר הבית עובר לבית

איך עובד ETA

במקרים מסוימים למשתמשים יש אפליקציה של צד שלישי המשתמשת ב- GPS כדי לספק נתוני זמן הגעה משוער (ETA) ל- Nest API. במקרים אחרים, המשתמש עשוי להשתמש באפליקציה כדי להזין ידנית את ה- ETA שלהם. או אולי ה- ETA מחושב על פי לוח הזמנים הרגיל של המשתמש.

אפליקציות ETA המשולבות בתרמוסטט של Nest גורמות לתרמוסטט להתחיל לחמם או לקרר את הבית לפני שהמשתמש מגיע.

כאשר קיימת שילוב ETA / תרמוסטט בחשבון המשתמש, נתוני ה- ETA זמינים לשימוש של מפתחי Works with Nest אחרים באינטגרציות שלהם ב- Works with Nest.

לאחר הכנסת ה- ETA לשירות הקן, שילוב אחר עבודה עם קן יכול להשתמש בו כאות להכנת הבית לקראת הגעת המשתמש.

  1. אט"א הוא נכתב על ידי מפתחי קן באמצעות לכתיבה בלבד PUT eta שיחת API .
  2. התרמוסטט של Nest משתמש בנתונים אלה.
  3. אם מפתחים אחרים רוצים להשתמש בו, מדי, הם יכולים להשתמש לקריאה בלבד GET eta_begin שיחת API .
נתוני ETA

הנקודה החשובה שיש לזכור היא כי על נתוני ETA להזין צד שלישי. Nest אינו מספק כעת נתוני ETA. אם נתוני ה- ETA לא נכתבו, Nest API מחזיר את ערך ברירת המחדל "1970-01-01T00: 00: 00.000Z".

נניח למשל שאתה ספק תאורה. ניתן לקבל את נתוני ה- ETA המסופקים על ידי שילוב ה- ETA / התרמוסטט ולהשתמש בהם כאות להפעלת הנורות.

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

תגובה לשינויים בסטטוס ה- ETA פותחת מגוון רחב של הזדמנויות עבור המוצרים שלך. לדוגמה, המוצרים שלך יכולים:

  • הפעל את הטלוויזיה כשהמשתמש מתקרב לביתו
  • פתח את דלת המוסך כאשר המשתמש כמעט בבית
  • השמעת מוזיקה כבר כשהמשתמש חוזר הביתה

הרשאות הרחקה

רמות אישור הגישה זמינות עבור ערכי נתונים הקשורים הרחק :



גִישָׁה

הרחק לקרוא
הרחק לקרוא / לכתוב

קריאת ETA

ETA לקרוא / לכתוב

קריאת אזעקת עשן + CO
קריאת תרמוסטט
תרמוסטט לקרוא / לכתוב
away כן כן כן
eta_begin (לקריאה בלבד) כן כן
eta אובייקט (כתיבה בלבד) כן

למידע נוסף, ראה סקירת ההרשאות .

תכונות רחוקות

בית ורחוק

away ערך הנתונים יכול להגיד לך אם Nest חושב המבנה מאוכלס. הערכים האפשריים הם:

ערך תיאור
home יש מישהו במבנה. ניתן להגדיר מצב זה:
• על ידי Nest אם יש לו ביטחון גבוה מנתוני חיישני תנועה
• על ידי המשתמש באמצעות אפליקציית Nest , את התרמוסטט של Nest, או המוצר שלך
• באופן אלגוריתמי באמצעות ETA
away אין אף אחד במבנה. שהמשתמש הגדיר במפורש את המבנה משם, או דרך אפליקציית Nest , את התרמוסטט של Nest, או המוצר שלך.
unknown אם אין מכשירים הקשורים למבנה, אז המדינה משם הוא unknown .

ממשק ה- API של Nest מספק את האפשרות להגדיר באופן ישיר את הבית ואת 'רחוק', וכן להקשיב לשינויים במצבים אלה. עם זאת, בעת הגדרת Home and Away, זה צריך להיעשות כמו אפליקציית Nest עושה זאת: כתוצאה בקשה מפורשת של המשתמש. מנסה להגדיר מצב אלגוריתמי זה מסתכן ביצירת חוויית משתמש מבלבל ואת זה אסור על פי מדיניות תכנון קן .

שים לב כי משתמשים תמיד יש את היכולת להגדיר באופן ידני את המדינה הביתה / משם.

למידע נוסף על איך משתמשים להגדיר בית ומדינות הרחק .

ETA

רָחוֹק

ETA הוא אובייקט עם שדות שניתן להגדיר על מבנה. הוא משמש כדי ליידע את קן שמשתמש צפוי לחזור הביתה בשעה מסוימת. בעת הגדרת ETA, מוצר יוצר ייחודי trip_id ומספק חלון צפוי הגעה, שצוין על ידי הערכים הבאים:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

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

ככל שאנו מקבלים יותר מידע, כך אנו יכולים להיות בטוחים יותר באמינות תשומות ה- ETA, מה שהופך אותנו לבטוחים יותר בעת ביצוע פעולות להכנת הבית.

ETA אינו תלוי במדינת הבית. אם זמן ההגעה של ETA מתנגש עם ETA אחר, זמן ההגעה המוקדם ביותר הוא העדיף.

בצע שיחת כתיבה של ETA

ההיגיון ב- ETA תלוי בנוכחותו של תרמוסטט במבנה. אם אין תרמוסטט קיים במבנה, שיחות שבוצעו האובייקט ETA להיכשל עם "No מכשירים מותאמים" הודעת שגיאה. שגיאה זו מתרחשת גם אם ישנם סוגים אחרים של מכשירים במבנה (למשל, Nest Cam או Nest Protect).

ערכי נתונים

שיחת ETA דורשת את ערכי הנתונים הבאים:

שֵׁם סוּג תיאור
trip_id חוּט מזהה טיול ETA ייחודי
estimated_arrival_window_begin חוּט חותמת זמן
חייב להיות גדול מ NOW , ב ISO 8601 בפורמט
estimated_arrival_window_end חוּט חותמת זמן
חייב להיות גדול מ estimated_arrival_window_begin , ב ISO 8601 בפורמט

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

כל שיחת ETA חייבת לכלול ייחודית trip_id מחרוזת שאתה מגדיר את השיחה הראשונית. פרמטרים אחרים יכולים לשנות עם שיחות רצופות לאותו trip_id .

שיחת ETA מחזירה קוד סטטוס HTTP 200 OK בהצלחה.

דוגמאות

סִלְסוּל
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..."

בטל ETA

לביטול ETA, לשלוח estimated_arrival_window_begin = 0 . בדוק שאתה שולח מספר שלם (0) בשיחה זו, ולא מחרוזת ("0"), אחרת השיחה תיכשל.

הודעות שגיאה

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