Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Vắng khách & ETA

Xa

Trong API Nest, khái niệm "Nhà" hoặc "Đi vắng" có ảnh hưởng mạnh mẽ đến hành vi của các tính năng tiện lợi và tiết kiệm năng lượng của Nest.

Cách thức hoạt động của Home and Away

Nest sử dụng nhiều tín hiệu khác nhau để phát hiện sự hiện diện của con người trong Nhà. Nếu Nest phát hiện không có sự hiện diện trong một khoảng thời gian dài, Nest sẽ tự động đặt nhà thành Đi vắng. Khi phát hiện sự hiện diện của con người, nó sẽ trả cấu trúc về trạng thái Home.

Phản ứng với những thay đổi trong trạng thái Nhà / Đi vắng mở ra nhiều cơ hội cho sản phẩm của bạn. Ví dụ: sản phẩm của bạn có thể:

  • Tắt đèn khi nhà đi vắng để tiết kiệm năng lượng
  • Gửi thông báo nếu cửa nhà để xe mở khi nhà đi vắng
  • Phát nhạc khi ngôi nhà chuyển sang Màn hình chính

Cách thức hoạt động của ETA

Trong một số trường hợp, người dùng có ứng dụng của bên thứ 3 sử dụng GPS để cung cấp dữ liệu thời gian đến dự kiến ​​(ETA) cho Nest API. Trong các trường hợp khác, người dùng có thể sử dụng một ứng dụng để nhập ETA của họ theo cách thủ công. Hoặc có thể ETA được phân loại dựa trên lịch trình thông thường của người dùng.

Các ứng dụng ETA được tích hợp với Bộ điều nhiệt Nest khiến bộ điều nhiệt bắt đầu làm ấm hoặc làm mát nhà trước khi người dùng đến.

Khi tích hợp ETA / bộ điều nhiệt tồn tại trong tài khoản của người dùng, dữ liệu ETA sẽ có sẵn cho các nhà phát triển Hoạt động với Nest khác sử dụng trong tích hợp Hoạt động với Nest của họ.

Sau khi ETA được nhập vào dịch vụ Nest, một tích hợp Hoạt động với Nest khác có thể sử dụng nó như một tín hiệu để chuẩn bị cho ngôi nhà của người dùng đến.

  1. ETA được viết bởi một nhà phát triển Nest sử dụng chỉ ghi PUT eta gọi API .
  2. Nest Thermostat sử dụng dữ liệu này.
  3. Nếu nhà phát triển khác muốn sử dụng nó cũng vậy, họ có thể sử dụng chỉ đọc GET eta_begin gọi API .
Dữ liệu ETA

Điểm quan trọng cần lưu ý là dữ liệu ETA phải được nhập bởi bên thứ ba. Nest hiện không cung cấp dữ liệu ETA. Nếu dữ liệu ETA chưa được ghi, Nest API trả về giá trị "1970-01-01T00: 00: 00.000Z" mặc định.

Ví dụ, giả sử rằng bạn là một nhà cung cấp đèn chiếu sáng. Bạn có thể lấy dữ liệu ETA do tích hợp ETA / bộ điều nhiệt cung cấp và sử dụng dữ liệu đó làm tín hiệu để bật đèn.

Bằng cách này, không chỉ nhiệt độ dễ chịu, đèn còn sáng khi người dùng về đến nhà.

Phản ứng với những thay đổi trong trạng thái ETA mở ra nhiều cơ hội cho sản phẩm của bạn. Ví dụ: sản phẩm của bạn có thể:

  • Bật TV khi người dùng về nhà
  • Mở cửa nhà để xe khi người dùng gần về nhà
  • Đã phát nhạc khi người dùng trở về nhà

Quyền đi vắng

Các mức độ quyền truy cập sau đây có sẵn cho các giá trị dữ liệu Xa-liên quan :



Truy cập

Đọc đi
Đọc / ghi ở xa

ETA đã đọc

ETA đọc / ghi

Đọc báo động khói + CO
Bộ điều nhiệt đã đọc
Bộ điều nhiệt đọc / ghi
away Đúng Đúng Đúng
eta_begin (chỉ đọc) Đúng Đúng
eta đối tượng (chỉ ghi) Đúng

Để biết thêm, xem Quyền Tổng quan .

Tính năng đi vắng

Home and Away

Các away giá trị dữ liệu có thể cho bạn biết nếu Nest nghĩ cấu trúc là chiếm đóng. Các giá trị có thể là:

Giá trị Sự miêu tả
home Có ai đó trong cấu trúc. Trạng thái này có thể được đặt:
• bởi Nest nếu Nest có độ tin cậy cao từ dữ liệu cảm biến chuyển động
• bởi người sử dụng thông qua các ứng dụng Nest , Nest Thermostat, hoặc sản phẩm của bạn
• theo thuật toán qua ETA
away Không có ai trong cấu trúc. Người dùng đã thiết lập một cách rõ ràng cấu trúc để đi, hoặc thông qua các ứng dụng Nest , Nest Thermostat, hoặc sản phẩm của bạn.
unknown Nếu không có các thiết bị được kết hợp với cấu trúc, sau đó tình trạng đi là unknown .

API Nest cung cấp khả năng đặt trực tiếp Nhà và Đi, cũng như lắng nghe các thay đổi đối với các trạng thái này. Tuy nhiên, khi thiết Home and Away, nó nên được thực hiện như các ứng dụng Nest làm nó: là kết quả của một yêu cầu người sử dụng rõ ràng. Cố gắng theo thuật toán thiết lập trạng thái này có nguy cơ tạo ra một kinh nghiệm người dùng bối rối và bị cấm bởi chính sách thiết kế Nest .

Hãy nhận biết rằng người dùng luôn luôn có khả năng tự thiết lập Trang chủ / tiểu bang Away.

Tìm hiểu thêm về cách người dùng thiết lập Trang chủ và các tiểu bang Xa .

ETA

Xa

ETA là một đối tượng với các lĩnh vực có thể được đặt trên một cấu trúc. Nó được sử dụng để cho Nest biết rằng người dùng dự kiến ​​sẽ trở về nhà vào một thời điểm cụ thể. Khi thiết lập các ETA, một sản phẩm độc đáo tạo ra một trip_id và cung cấp một cửa sổ dự kiến đến, xác định bởi các giá trị sau:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Vì hoàn cảnh xung quanh các chuyến đi có thể thay đổi do giao thông, kế hoạch của người dùng thay đổi và các sự kiện khác, các sản phẩm phải cập nhật ETA định kỳ khi chuyến đi diễn ra, cung cấp cho Nest luồng thời gian đến ước tính (5 phút là khoảng thời gian lý tưởng).

Chúng tôi càng nhận được nhiều thông tin, chúng tôi càng có thể tin tưởng vào độ tin cậy của các đầu vào ETA, điều này khiến chúng tôi tự tin hơn khi hành động để chuẩn bị cho ngôi nhà.

ETA độc lập với nhà nước. Nếu thời gian đến của một ETA xung đột với ETA khác, thì thời gian đến sớm nhất sẽ được ưu tiên.

Thực hiện một cuộc gọi viết thư ETA

Logic ETA phụ thuộc vào sự hiện diện của Bộ điều nhiệt trong cấu trúc. Nếu không có điều chỉnh nhiệt tồn tại trong cấu trúc, các cuộc gọi thực hiện cho các đối tượng ETA thất bại với "Không cặp thiết bị" thông báo lỗi. Lỗi này xảy ra ngay cả khi các loại thiết bị khác tồn tại trong cấu trúc (ví dụ: Nest Cam hoặc Nest Protect).

Giá trị dữ liệu

Cuộc gọi ETA yêu cầu các giá trị dữ liệu sau:

Tên Kiểu Sự miêu tả
trip_id chuỗi Mã nhận dạng chuyến đi ETA duy nhất
estimated_arrival_window_begin chuỗi Dấu thời gian
Phải lớn hơn NOW , trong tiêu chuẩn ISO 8601 định dạng
estimated_arrival_window_end chuỗi Dấu thời gian
Phải lớn hơn estimated_arrival_window_begin , trong tiêu chuẩn ISO 8601 định dạng

Do khả năng xảy ra tình trạng bỏ kết nối trong liên lạc GPS, chúng tôi đề xuất một luồng mẫu, lý tưởng là 5 phút một lần.

Mỗi cuộc gọi ETA phải bao gồm một độc đáo trip_id chuỗi mà bạn xác định trong các cuộc gọi ban đầu. Các thông số khác có thể thay đổi với các cuộc gọi liên tiếp với cùng trip_id .

Cuộc gọi ETA trả về mã trạng thái HTTP 200 OK khi thành công.

Các ví dụ

Xoăn
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..."

Hủy một ETA

Để hủy eta, gửi estimated_arrival_window_begin = 0 . Kiểm tra để đảm bảo rằng bạn đang gửi một số nguyên (0) trong cuộc gọi này, không phải là một chuỗi ("0"), nếu không cuộc gọi sẽ không thành công.

Thông báo lỗi

Để biết thông tin về những gì lỗi gọi API nghĩa và cách xử lý chúng, hãy xem thông báo lỗi .