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

بالخارج و ETA

بعيد

في Nest API ، يكون لمفهوم "الصفحة الرئيسية" أو "بالخارج" تأثير قوي على سلوكيات توفير الطاقة وميزات الراحة في Nest.

كيف يعمل Home and Away

يستخدم Nest مجموعة متنوعة من الإشارات لاكتشاف التواجد البشري في المنزل. إذا اكتشف Nest عدم وجود أي وجود لفترة طويلة من الوقت ، فسيقوم تلقائيًا بتعيين المنزل على Away. عندما يكتشف وجود الإنسان ، فإنه يعيد الهيكل إلى الحالة الأصلية.

يؤدي الرد على التغييرات في حالة المنزل / بالخارج إلى فتح مجموعة واسعة من الفرص لمنتجاتك. على سبيل المثال ، يمكن لمنتجاتك:

  • قم بإطفاء الأنوار عندما يذهب المنزل إلى مكان بعيد للحفاظ على الطاقة
  • أرسل إشعارًا إذا كان باب الجراج مفتوحًا عندما يكون المنزل بعيدًا
  • قم بتشغيل الموسيقى عندما ينتقل المنزل إلى المنزل

كيف يعمل ETA

في بعض الحالات ، يكون لدى المستخدمين تطبيق تابع لجهة خارجية يستخدم نظام تحديد المواقع العالمي (GPS) لتوفير بيانات الوقت المقدر للوصول (ETA) إلى Nest API. في حالات أخرى ، قد يستخدم المستخدم تطبيقًا لإدخال الوقت المقدر للوصول يدويًا. أو ربما يتم حساب ETA بناءً على الجدول الزمني المعتاد للمستخدم.

تتسبب تطبيقات ETA المدمجة مع Nest Thermostat في أن يبدأ منظم الحرارة في تدفئة المنزل أو تبريده قبل وصول المستخدم.

عند وجود تكامل ETA / منظم الحرارة في حساب المستخدم ، تكون بيانات ETA متاحة لمطوري Works with Nest الآخرين لاستخدامها في عمليات تكامل Works with Nest.

بعد إدخال ETA في خدمة Nest ، يمكن أن يستخدمها تكامل Works with Nest كإشارة لإعداد المنزل لوصول المستخدم.

  1. هو مكتوب في ETA من قبل مطور عش باستخدام الكتابة الوحيد PUT eta دعوة API .
  2. يستخدم Nest Thermostat هذه البيانات.
  3. إذا مطورين آخرين يرغبون في استخدامه، أيضا، يمكن أن تستخدم للقراءة فقط GET eta_begin دعوة API .
بيانات ETA

النقطة المهمة التي يجب وضعها في الاعتبار هي أنه يجب إدخال بيانات ETA بواسطة طرف ثالث. لا يوفر Nest حاليًا بيانات ETA. إذا لم تتم كتابة بيانات ETA ، فإن Nest API تُرجع القيمة الافتراضية "1970-01-01T00: 00: 00.000Z".

افترض ، على سبيل المثال ، أنك بائع إضاءة. يمكنك الحصول على بيانات ETA المقدمة من خلال تكامل ETA / منظم الحرارة واستخدامها كإشارة لتشغيل الأضواء.

بهذه الطريقة ، لا تكون درجة الحرارة مريحة فحسب ، بل تضاء الأضواء أيضًا عند وصول المستخدم إلى المنزل.

يفتح الرد على التغييرات في حالة ETA مجموعة واسعة من الفرص لمنتجاتك. على سبيل المثال ، يمكن لمنتجاتك:

  • قم بتشغيل التلفزيون عندما يقترب المستخدم من المنزل
  • افتح باب الجراج عندما يكون المستخدم في المنزل تقريبًا
  • تشغيل الموسيقى بالفعل عند عودة المستخدم إلى المنزل

أذونات بعيدة

تتوفر مستويات أذونات الوصول التالية ل قيم البيانات ذات الصلة بعيدا :



وصول

قراءة بعيدا
قراءة / كتابة بعيدا

قراءة ETA

ETA للقراءة / الكتابة

قراءة إنذار الدخان + أول أكسيد الكربون
قراءة الترموستات
قراءة / كتابة ترموستات
away نعم نعم نعم
eta_begin (للقراءة فقط) نعم نعم
eta الكائن (الكتابة فقط) نعم

لمزيد من المعلومات، راجع نظرة عامة ضوابط .

الميزات البعيدة

ذهابا وايابا

و away قيمة البيانات يمكن أن أقول لكم إذا عش يفكر واحتل هيكل. القيم الممكنة هي:

قيمة وصف
home هناك شخص ما في الهيكل. يمكن تعيين هذه الحالة:
• بواسطة Nest إذا كان لديه ثقة عالية من بيانات مستشعر الحركة
• قبل المستخدم عبر التطبيق عش ، عش الحرارة، أو منتجك
• خوارزميًا عبر ETA
away لا يوجد أحد في الهيكل. قام المستخدم بوضوح تعيين هيكل للبعيدا، إما عن طريق تطبيق Nest ، عش الحرارة، أو المنتج الخاص بك.
unknown إذا يتم ربط الأجهزة مع الهيكل، ثم الدولة خارج أرضه هي unknown .

يوفر Nest API القدرة على تعيين Home and Away مباشرةً ، بالإضافة إلى الاستماع إلى التغييرات التي تطرأ على هذه الحالات. ومع ذلك، عند وضع والاياب، فإنه ينبغي أن يتم ذلك في التطبيق عش يفعل ذلك: نتيجة للطلب المستخدم صريحة. في محاولة لوضع حسابيا هذه الدولة ينطوي على خطر خلق تجربة المستخدم الخلط وحرمه على تصميم سياسات عش .

كن على علم أن المستخدمين لديهم دائما القدرة على تعيين الصفحة الرئيسية / الدولة بعيدا يدويا.

معرفة المزيد حول كيفية إعداد المستخدمين المنزليين والدول بعيدا .

إيتا

بعيد

ETA هو كائن مع الحقول التي يمكن تعيينها على هيكل. يتم استخدامه لإعلام Nest بأنه من المتوقع أن يعود المستخدم إلى المنزل في وقت محدد. عند تعيين ETA، وهو منتج يولد فريدة من نوعها trip_id ويوفر نافذة المتوقع وصوله، والتي يحددها القيم التالية:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

نظرًا لأن الظروف المحيطة بالرحلات يمكن أن تتغير بسبب حركة المرور وخطط المستخدم المتغيرة والأحداث الأخرى ، يجب أن تقوم المنتجات بتحديث الوقت المقدر للوصول بشكل دوري مع تقدم الرحلة ، مما يوفر لشركة Nest تدفقًا لأوقات الوصول المقدرة (5 دقائق هي فترة مثالية).

كلما زادت المعلومات التي نتلقاها ، زادت ثقتنا في موثوقية مدخلات ETA ، مما يجعلنا أكثر ثقة عند اتخاذ إجراء لإعداد المنزل.

ETA مستقلة عن الدولة الأم. إذا كان وقت وصول ETA يتعارض مع وقت وصول متوقع آخر ، فإن وقت الوصول الأول يكون له الأسبقية.

قم بإجراء مكالمة كتابة لـ ETA

منطق ETA يعتمد على وجود منظم حرارة في الهيكل. في حالة وجود أي الحرارة في الهيكل، والمكالمات التي يتم إجراؤها إلى كائن ETA تفشل مع "لا تقرن الأجهزة" رسالة الخطأ. يحدث هذا الخطأ حتى في حالة وجود أنواع أخرى من الأجهزة في الهيكل (على سبيل المثال ، 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 ، نقترح مجموعة من العينات ، بشكل مثالي مرة واحدة كل 5 دقائق.

يجب أن يتضمن كل مكالمة 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

لإلغاء ايتا، وإرسال estimated_arrival_window_begin = 0 . تحقق من أنك ترسل عددًا صحيحًا (0) في هذه المكالمة ، وليس سلسلة ("0") ، وإلا ستفشل المكالمة.

رسائل خاطئة

للحصول على معلومات حول ما تعني أخطاء دعوة API وكيفية التعامل معها، انظر رسائل خطأ .