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

הרחק & amp; ETA

רָחוֹק

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

איך עובד הבית והרחק

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

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

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

איך עובד ETA

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

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

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

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

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

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

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

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

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

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

הרשאות משם

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



גִישָׁה

קראו משם
משם לקרוא / לכתוב

ETA קרא

קריאה / כתיבה של ETA

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

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

תכונות משם

בית והרחק

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

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

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

שימו לב שלמשתמשים תמיד יש את היכולת להגדיר ידנית את מצב הבית / מרחק.

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

ETA

רָחוֹק

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

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

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

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

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

התקשר לכתוב ETA

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

ערכי נתונים

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

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

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

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

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

דוגמאות

סִלְסוּל
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, שלח estim_arrival_window_begin estimated_arrival_window_begin = 0 . בדוק שאתה שולח מספר שלם (0) בשיחה זו, לא מחרוזת ("0"), או שהשיחה תיכשל.

הודעות שגיאה

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