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