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

بعيدا & أمبير ؛ إيتا

بعيدا

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

كيف يعمل Home and Away

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

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

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

كيف تعمل ايتا

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

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

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

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

  1. تتم كتابة ETA بواسطة مطور Nest باستخدام استدعاء 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 مجموعة كبيرة من الفرص لمنتجاتك. على سبيل المثال ، يمكن لمنتجاتك:

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

أذونات بعيدا

مستويات إذن الوصول التالية متاحة لقيم البيانات المتعلقة بالخارج :



التمكن من

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

قراءة ايتا

إيتا القراءة / الكتابة

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

لمزيد من المعلومات ، راجع نظرة عامة على الأذونات .

ميزات بعيدا

ذهابا وايابا

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

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

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

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

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

إيتا

بعيدا

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

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

نظرًا لأن الظروف المحيطة بالرحلات يمكن أن تتغير بسبب حركة المرور وخطط المستخدم المتغيرة والأحداث الأخرى ، يجب أن تقوم المنتجات بتحديث ETA بشكل دوري مع تقدم الرحلة ، مما يوفر لـ 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 موافق عند النجاح.

أمثلة

لفة
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 وكيفية معالجتها ، راجع رسائل الخطأ .