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

ทีมเยือน & ETA

ไม่อยู่

ใน Nest API แนวคิดของ "บ้าน" หรือ "ไม่อยู่" มีผลอย่างมากต่อพฤติกรรมของฟีเจอร์การประหยัดพลังงานและความสะดวกสบายของ Nest

วิธีการทำงานที่บ้านและนอกบ้าน

Nest ใช้สัญญาณที่หลากหลายเพื่อตรวจจับการมีอยู่ของมนุษย์ในบ้าน หาก Nest ตรวจพบว่าไม่อยู่เป็นระยะเวลานาน ระบบจะตั้งค่าบ้านเป็น "ไม่อยู่บ้าน" โดยอัตโนมัติ เมื่อตรวจพบว่ามีมนุษย์อยู่ โครงสร้างจะกลับคืนสู่สถานะเดิม

การตอบสนองต่อการเปลี่ยนแปลงในสถานะอยู่บ้าน/ไม่อยู่บ้านจะเปิดโอกาสที่หลากหลายสำหรับผลิตภัณฑ์ของคุณ ตัวอย่างเช่น ผลิตภัณฑ์ของคุณสามารถ:

  • ปิดไฟเมื่อบ้านเข้า Away เพื่อประหยัดพลังงาน
  • ส่งการแจ้งเตือนหากประตูโรงรถเปิดเมื่อบ้านไม่อยู่
  • เล่นเพลงเมื่อบ้านเปลี่ยนเป็นโฮม

ETA ทำงานอย่างไร

ในบางกรณี ผู้ใช้มีแอปของบุคคลที่สามที่ใช้ GPS เพื่อให้ข้อมูลเวลาที่มาถึงโดยประมาณ (ETA) แก่ Nest API ในกรณีอื่นๆ ผู้ใช้อาจใช้แอปเพื่อป้อน ETA ด้วยตนเอง หรือบางที ETA อาจคำนวณตามกำหนดการปกติของผู้ใช้

แอป ETA ที่ผสานรวมกับ Nest Thermostat จะทำให้ตัวควบคุมอุณหภูมิเริ่มอุ่นหรือทำความเย็นให้กับบ้านก่อนที่ผู้ใช้จะมาถึง

เมื่อมีการผสาน ETA/ตัวควบคุมอุณหภูมิในบัญชีของผู้ใช้ ข้อมูล ETA จะพร้อมใช้งานสำหรับนักพัฒนา Works with Nest รายอื่นเพื่อใช้ในการผสานการทำงานกับ Nest

หลังจากป้อนข้อมูล ETA ลงในบริการ Nest แล้ว การผสานการทำงานกับ Nest อื่นสามารถใช้เป็นสัญญาณเพื่อเตรียมบ้านสำหรับการมาถึงของผู้ใช้

  1. การทางพิเศษแห่งประเทศไทยที่เขียนโดยนักพัฒนา Nest ใช้เขียนเพียง PUT eta เรียก API
  2. Nest Thermostat ใช้ข้อมูลนี้
  3. หากนักพัฒนาอื่น ๆ ต้องการที่จะใช้มันเกินไปพวกเขาสามารถใช้อ่านอย่างเดียว GET eta_begin เรียก API
ข้อมูลการทางพิเศษแห่งประเทศไทย

จุดสำคัญที่ต้องจำไว้คือต้องป้อนข้อมูล ETA โดยบุคคลที่สาม ขณะนี้ Nest ไม่ได้ให้ข้อมูลเวลาถึงโดยประมาณ หากไม่ได้เขียนข้อมูล ETA ไว้ Nest API จะส่งกลับค่าดีฟอลต์ "1970-01-01T00:00:00.000Z"

ตัวอย่างเช่น สมมติว่าคุณเป็นผู้จำหน่ายระบบแสงสว่าง คุณสามารถรับข้อมูล ETA ที่ได้จากการรวม ETA/เทอร์โมสตัท และใช้เป็นสัญญาณในการเปิดไฟ

ด้วยวิธีนี้ ไม่เพียงแต่อุณหภูมิจะสบาย แต่ยังเปิดไฟเมื่อผู้ใช้กลับถึงบ้านด้วย

การตอบสนองต่อการเปลี่ยนแปลงในสถานะ ETA จะเป็นการเปิดโอกาสที่หลากหลายสำหรับผลิตภัณฑ์ของคุณ ตัวอย่างเช่น ผลิตภัณฑ์ของคุณสามารถ:

  • เปิดทีวีเมื่อผู้ใช้เข้าใกล้บ้าน
  • เปิดประตูโรงรถเมื่อผู้ใช้ใกล้ถึงบ้าน
  • มีเพลงเล่นอยู่แล้วเมื่อผู้ใช้กลับบ้าน

สิทธิ์ในการไม่อยู่

ระดับสิทธิ์การเข้าถึงต่อไปนี้สำหรับ ค่าข้อมูลออกไปที่เกี่ยวข้องกับ :



เข้าไป

อ่านไม่ออก
ออกไปอ่าน/เขียน

กทพ.อ่าน

กทพ. อ่าน/เขียน

อ่านสัญญาณเตือนควัน+CO
อ่านเทอร์โมสตัท
อ่าน/เขียนเทอร์โมสตัท
away ใช่ ใช่ ใช่
eta_begin (อ่านเท่านั้น) ใช่ ใช่
eta วัตถุ (เขียนเท่านั้น) ใช่

สำหรับข้อมูลเพิ่มเติมโปรดดูที่ การอนุญาตภาพรวม

คุณสมบัติทีมเยือน

อยู่บ้านและนอกบ้าน

away ค่าข้อมูลสามารถบอกคุณได้ถ้า Nest คิดว่าโครงสร้างที่ถูกครอบครอง ค่าที่เป็นไปได้คือ:

ความคุ้มค่า คำอธิบาย
home มีใครบางคนอยู่ในโครงสร้าง สถานะนี้สามารถตั้งค่าได้:
• โดย Nest หากมีความมั่นใจสูงจากข้อมูลเซ็นเซอร์ตรวจจับความเคลื่อนไหว
•โดยผู้ใช้ผ่านทางที่ แอป Nest , Nest Thermostat หรือผลิตภัณฑ์ของคุณ
• อัลกอริธึมผ่าน ETA
away ไม่มีใครอยู่ในโครงสร้าง ผู้ใช้มีการกำหนดอย่างชัดเจนโครงสร้างเพื่อออกไปอย่างใดอย่างหนึ่งผ่านทาง แอพพลิเค Nest , Nest Thermostat หรือผลิตภัณฑ์ของคุณ
unknown หากไม่มีอุปกรณ์ที่เกี่ยวข้องกับโครงสร้างแล้วรัฐอยู่ห่างออกไป unknown

Nest API ให้ความสามารถในการตั้งค่า "อยู่บ้าน" และ "ไม่อยู่บ้าน" ได้โดยตรง ตลอดจนรับฟังการเปลี่ยนแปลงของสถานะเหล่านี้ แต่เมื่อตั้งค่าบ้านและออกไปก็ควรจะทำในขณะที่ แอป Nest ไม่ได้: เป็นผลมาจากการร้องขอของผู้ใช้ที่ชัดเจน พยายามที่จะอัลกอริทึมตั้งรัฐนี้จะเสี่ยงต่อการสร้างประสบการณ์การใช้งานเกิดความสับสนและเป็นสิ่งต้องห้ามโดย นโยบายการออกแบบ Nest

โปรดทราบว่าผู้ใช้มักจะมีความสามารถในการตั้งค่าหน้าแรก / รัฐไปด้วยตนเอง

เรียนรู้เพิ่มเติมเกี่ยวกับ วิธีที่ผู้ใช้ตั้งค่าหน้าแรกและรัฐออกไป

กทพ

ไม่อยู่

กทพ. เป็นวัตถุที่มีเขตข้อมูลที่สามารถตั้งค่าเกี่ยวกับโครงสร้างหนึ่ง ใช้เพื่อแจ้งให้ Nest ทราบว่าผู้ใช้คาดว่าจะกลับบ้านในเวลาที่กำหนด เมื่อตั้งกทพผลิตภัณฑ์ที่จะสร้างที่ไม่ซ้ำกัน 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 นาที

การทางพิเศษแห่งประเทศไทยโทรทุกคนจะต้องมีที่ไม่ซ้ำกัน trip_id สตริงที่คุณกำหนดในการโทรครั้งแรก พารามิเตอร์อื่น ๆ สามารถเปลี่ยนกับสายต่อเนื่องไปเหมือนกัน trip_id

การเรียก ETA จะส่งคืนรหัสสถานะ HTTP OK 200 เมื่อสำเร็จ

ตัวอย่าง

Curl
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 หมายและวิธีการที่จะจัดการกับพวกเขาเห็น ข้อความข้อผิดพลาด