Google cam kết thúc đẩy công bằng chủng tộc cho các cộng đồng Đen. Xem thế nào.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Đi vắng & amp; ETA

Xa

Trong API Nest, khái niệm "Nhà" hoặc "Đi vắng" có tác động mạnh mẽ đến các 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, nó sẽ tự động đặt nhà thành Xa. 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 Trang chủ / Đi sẽ mở ra nhiều cơ hội cho các sản phẩm của bạn. Ví dụ: các sản phẩm của bạn có thể:

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

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 (ETA) ước tính cho API 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 thủ công ETA của họ. Hoặc có thể ETA được tính toán dựa trên lịch trình thường xuyên 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 làm cho 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 có sẵn cho các Nhà phát triển khác với các nhà phát triển Nest sử dụng trong Công việc của họ với tích hợp Nest.

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

  1. ETA được viết bởi nhà phát triển Nest bằng cách sử dụng lệnh gọi API PUT eta chỉ ghi.
  2. Bộ điều nhiệt Nest sử dụng dữ liệu này.
  3. Nếu các nhà phát triển khác cũng muốn sử dụng nó, họ có thể sử dụng lệnh gọi API GET eta_begin chỉ đọc.
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ứ 3. Nest hiện không cung cấp dữ liệu ETA. Nếu dữ liệu ETA chưa được ghi, API Nest trả về giá trị "1970-01-01T00: 00: 00.000Z" mặc định.

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

Bằng cách này, không chỉ là nhiệt độ thoải mái, đèn cũng bật khi người dùng về nhà.

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

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

Quyền đi vắng

Các mức cấp phép truy cập sau đây khả dụng cho các giá trị dữ liệu liên quan đến Away :



Truy cập

Đi đọc
Đi đọc / viết

ETA đọc

ETA đọc / ghi

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

Để biết thêm thông tin, xem Tổng quan về quyền .

Tính năng sân khách

Nhà và Đi

Giá trị dữ liệu away có thể cho bạn biết nếu Nest nghĩ rằng cấu trúc bị chiếm dụ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 nó có độ tin cậy cao từ dữ liệu cảm biến chuyển động
• bởi người dùng thông qua ứng dụng Nest, Bộ điều nhiệt Nest hoặc sản phẩm của bạn
• theo thuật toán thông qua ETA
away Không có ai trong cấu trúc. Người dùng rõ ràng đã đặt cấu trúc đi, thông qua ứng dụng Nest, Bộ điều nhiệt Nest hoặc sản phẩm của bạn.
unknown Nếu không có thiết bị nào được liên kết với cấu trúc, thì trạng thái đi là unknown .

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

Xin lưu ý rằng người dùng luôn có khả năng đặt thủ công trạng thái Home / Away.

Tìm hiểu thêm về cách người dùng đặt trạng thái Home và Away .

ETA

Xa

ETA là một đối tượng với các trường 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 đặt ETA, một sản phẩm tạo ra một trip_id duy nhất và cung cấp một cửa sổ đến dự kiến, được chỉ định bởi các giá trị sau:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Do hoàn cảnh xung quanh các chuyến đi có thể thay đổi do lưu lượng truy cập, kế hoạch người dùng thay đổi và các sự kiện khác, các sản phẩm nên cập nhật ETA định kỳ khi chuyến đi tiếp tục, cung cấp cho Nest một 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ị nhà.

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

Thực hiện cuộc gọi viết 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ó bộ điều nhiệt tồn tại trong cấu trúc, các cuộc gọi được thực hiện cho đối tượng ETA sẽ thất bại với thông báo lỗi "Không có thiết bị được ghép nố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 Định danh chuyến đi ETA độc đáo
estimated_arrival_window_begin chuỗi Dấu thời gian
Phải lớn hơn NOW , ở định dạng ISO 8601
estimated_arrival_window_end chuỗi Dấu thời gian
Phải lớn hơn estimated_arrival_window_begin , ở định dạng ISO 8601

Do khả nă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 cứ sau 5 phút.

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

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

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 bỏ ETA

Để hủy eta, hãy gửi estimated_arrival_window_begin = 0 tính_ariances_window_begin estimated_arrival_window_begin = 0 . Kiểm tra xem 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ẽ thất bại.

Thông báo lỗi

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