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; การทางพิเศษแห่งประเทศไทย

ไป

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

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

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

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

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

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

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

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

เมื่อมีการรวม ETA / เทอร์โมสแตทในบัญชีของผู้ใช้ข้อมูล ETA จะพร้อมใช้งานสำหรับผู้พัฒนารายอื่น ๆ ของ Works with Nest เพื่อใช้ในการผสานรวมกับการทำงานด้วย 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 จะเปิดโอกาสมากมายสำหรับผลิตภัณฑ์ของคุณ ตัวอย่างเช่นผลิตภัณฑ์ของคุณสามารถ:

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

การอนุญาตไม่อยู่

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



เข้าไป

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

ETA อ่าน

ETA อ่าน / เขียน

Smoke + CO alarm read
อ่านเทอร์โม
เครื่องควบคุมอุณหภูมิอ่าน / เขียน
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 เป็นระยะเมื่อการเดินทางดำเนินไป

ยิ่งเราได้รับข้อมูลมากเท่าใดเราก็ยิ่งมีความมั่นใจในความน่าเชื่อถือของอินพุต ETA เพิ่มขึ้นซึ่งจะทำให้เรามีความมั่นใจมากขึ้นเมื่อดำเนินการเพื่อเตรียมบ้าน

ETA เป็นอิสระจากสถานะบ้าน หากเวลามาถึงของ ETA ขัดแย้งกับ ETA อื่นเวลาที่มาถึงเร็วที่สุดจะมาก่อน

โทรติดต่อ ETA

ตรรกะ ETA ขึ้นอยู่กับการมีอยู่ของ Thermostat ในโครงสร้าง หากไม่มีเทอร์โมสตัทอยู่ในโครงสร้างการโทรไปยังวัตถุ ETA จะล้มเหลวพร้อมกับข้อความแสดงข้อผิดพลาด "ไม่มีอุปกรณ์ที่จับคู่" ข้อผิดพลาดนี้เกิดขึ้นแม้ว่าอุปกรณ์ประเภทอื่นจะมีอยู่ในโครงสร้าง (เช่น Nest Cam หรือ Nest Protect)

ค่าข้อมูล

การเรียก ETA ต้องการค่าข้อมูลต่อไปนี้:

ชื่อ ชนิด ลักษณะ
trip_id เชือก ตัวระบุการเดินทาง ETA ที่ไม่ซ้ำ
estimated_arrival_window_begin เชือก การประทับเวลา
ต้องมากกว่า NOW ในรูปแบบ ISO 8601
estimated_arrival_window_end เชือก การประทับเวลา
ต้องมากกว่า estimated_arrival_window_begin _arrival_window_begin ใน รูปแบบ ISO 8601

เนื่องจากความเป็นไปได้ของการเชื่อมต่อแบบดรอปเอาท์ในการสื่อสาร GPS เราขอแนะนำสตรีมของกลุ่มตัวอย่างโดยสมบูรณ์ทุกๆ 5 นาที

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

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

ตัวอย่าง

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 _arrival_window_begin estimated_arrival_window_begin = 0 ตรวจสอบว่าคุณส่งจำนวนเต็ม (0) ในการโทรนี้ไม่ใช่สตริง ("0") มิฉะนั้นการโทรจะล้มเหลว

ข้อความผิดพลาด

สำหรับข้อมูลเกี่ยวกับข้อผิดพลาดในการโทรของ API หมายถึงและวิธีจัดการกับ ข้อผิดพลาด เหล่านั้นให้ดู ข้อความแสดงข้อผิดพลาด