Notice: We're retiring Works with Nest. See the home page for more information.
Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기
이 페이지는 Cloud Translation API를 통해 번역되었습니다.
Switch to English

자리 비움 & amp; ETA

떨어져

Nest API에서 "Home"또는 "Away"라는 개념은 Nest의 에너지 절약 및 편의 기능의 동작에 강력한 영향을 미칩니다.

홈앤 어웨이 작동 방식

Nest는 가정에서 사람의 존재를 감지하기 위해 다양한 신호를 사용합니다. Nest가 오랫동안 존재를 감지하지 않으면 자동으로 집을 자리 비움으로 설정합니다. 사람의 존재를 감지하면 구조를 홈 상태로 되돌립니다.

Home / Away 상태의 변화에 ​​대응하면 제품에 대한 다양한 기회가 열립니다. 예를 들어, 제품은 다음을 수행 할 수 있습니다.

  • 집이 에너지 절약을 위해 멀리 갈 때 불을 끄십시오
  • 집이 없을 때 차고 문이 열려 있으면 알림을 보냅니다.
  • 집이 집으로 바뀌면 음악 재생

ETA 작동 방식

경우에 따라 사용자는 GPS를 사용하여 예상 도착 시간 (ETA) 데이터를 Nest API에 제공하는 타사 앱을 보유하고 있습니다. 다른 경우, 사용자는 앱을 사용하여 수동으로 ETA를 입력 할 수 있습니다. 또는 사용자의 정기 일정에 따라 ETA가 계산 될 수 있습니다.

Nest 온도 조절기와 통합 된 ETA 앱은 사용자가 도착하기 전에 온도 조절기가 집을 데우거나 식히기 시작합니다.

ETA / 온도 조절기 통합이 사용자 계정에 존재하는 경우, ETA 데이터는 다른 Works with Nest 개발자가 자신의 Works with Nest 통합에 사용할 수 있습니다.

ETA가 Nest 서비스에 입력 된 후 다른 Works with Nest 통합은이를 사용자의 도착을위한 가정을 준비하기위한 신호로 사용할 수 있습니다.

  1. ETA는 쓰기 전용 PUT eta API 호출을 사용하여 Nest 개발자가 작성합니다.
  2. Nest 온도 조절기는이 데이터를 사용합니다.
  3. 다른 개발자들도 사용하려면 읽기 전용 GET eta_begin API 호출을 사용할 수 있습니다.
ETA 데이터

명심해야 할 중요한 점은 ETA 데이터는 제 3자가 입력해야한다는 것입니다. Nest는 현재 ETA 데이터를 제공하지 않습니다. ETA 데이터가 기록되지 않은 경우 Nest API는 기본 "1970-01-01T00 : 00 : 00.000Z"값을 반환합니다.

예를 들어, 조명 공급 업체라고 가정하십시오. ETA / 온도 조절기 통합으로 제공되는 ETA 데이터를 가져 와서 신호를 신호로 사용하여 조명을 켤 수 있습니다.

이런 식으로 온도가 편안 할뿐만 아니라 사용자가 집에 도착하면 표시등이 켜집니다.

ETA 상태의 변화에 ​​대응하면 제품에 대한 다양한 기회가 열립니다. 예를 들어, 제품은 다음을 수행 할 수 있습니다.

  • 사용자가 집에 접근 할 때 TV를 켭니다
  • 사용자가 거의 집에있을 때 차 고문 열기
  • 사용자가 집에 돌아 왔을 때 이미 음악 재생 중

자리 비움

Away 관련 데이터 값에 대해 다음 액세스 권한 레벨을 사용할 수 있습니다.



접속하다

멀리 읽기
멀리 읽기 / 쓰기

ETA 읽기

ETA 읽기 / 쓰기

연기 + CO 경보 읽기
온도 조절기 읽기
온도 조절기 읽기 / 쓰기
away
eta_begin (읽기 전용)
eta 객체 (쓰기 전용)

자세한 내용은 권한 개요를 참조하십시오.

어웨이 특징

집과 멀리

away 데이터 값은 Nest가 구조가 점유되었다고 생각하는지 여부를 알려줍니다. 가능한 값은 다음과 같습니다.

기술
home 구조에 누군가가 있습니다. 이 상태는 다음과 같이 설정할 수 있습니다.
• 모션 센서 데이터에 대한 신뢰도가 높은 경우 Nest
Nest 앱 , Nest 온도 조절기 또는 제품을 통해 사용자가
• ETA를 통한 알고리즘
away 구조에 아무도 없습니다. 사용자는 Nest 앱 , Nest 온도 조절기 또는 제품을 통해 구조를 명시 적으로 없앨 수 있습니다.
unknown 구조와 연결된 장치가 없으면 자리 비움 상태를 unknown .

Nest API는 홈 및 자리 비움을 직접 설정하고 이러한 상태의 변경 사항을 수신 할 수있는 기능을 제공합니다. 그러나 Home 및 Away를 설정할 때 명시 적 사용자 요청의 결과로 Nest 앱 이 수행하는 것처럼 수행해야합니다. 알고리즘 적으로이 상태를 설정하려고하면 혼란스러운 사용자 경험이 발생할 위험이 있으며 Nest 디자인 정책에 의해 금지됩니다.

사용자는 항상 Home / Away 상태를 수동으로 설정할 수 있습니다.

사용자가 집과 자리 비움 상태를 설정하는 방법에 대해 자세히 알아보십시오.

ETA

떨어져

ETA 는 구조에 설정할 수있는 필드가있는 객체입니다. Nest는 사용자가 특정 시간에 집으로 돌아올 것으로 예상됨을 알리는 데 사용됩니다. ETA를 설정할 때, 제품은 고유 한 trip_id 생성하고 다음 값으로 지정된 예상 도착 창을 제공합니다.

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

트래픽, 사용자 계획 변경 및 기타 이벤트로 인해 여행 주변 상황이 변경 될 수 있으므로 여행이 진행되는 동안 제품이 정기적으로 ETA를 업데이트하여 Nest에 예상 도착 시간 스트림을 제공해야합니다 (5 분이 이상적인 간격).

더 많은 정보를받을수록 ETA 입력의 신뢰성에 대한 확신이 생겨 집을 준비하기위한 조치를 취할 때 더욱 자신감을 갖게됩니다.

ETA는 거주 국가와 무관합니다. ETA의 도착 시간이 다른 ETA와 충돌하면 가장 빠른 도착 시간이 우선합니다.

ETA 쓰기 전화 걸기

ETA 논리는 구조에서 온도 조절기의 존재 여부에 달려 있습니다. 구조에 온도 조절기가 없으면 "페어링 된 장치 없음" 오류 메시지와 함께 ETA 객체에 대한 호출이 실패합니다. 구조에 다른 유형의 장치 (예 : Nest Cam 또는 Nest Protect)가있는 경우에도이 오류가 발생합니다.

데이터 값

ETA 호출에는 다음 데이터 값이 필요합니다.

이름 유형 기술
trip_id 고유 한 ETA 여행 식별자
estimated_arrival_window_begin 타임 스탬프
ISO 8601 형식에서 NOW 보다 커야합니다.
estimated_arrival_window_end 타임 스탬프
ISO 8601 형식의 estimated_arrival_window_begin_arrival_window_begin 보다 커야합니다.

GPS 통신에서 연결이 끊어 질 가능성이 있으므로 5 분마다 한 번씩 샘플 스트림을 제안합니다.

모든 ETA 호출에는 초기 호출에서 정의한 고유 한 trip_id 문자열이 포함되어야합니다. 다른 매개 변수는 동일한 trip_id 를 연속적으로 호출하여 변경 될 수 있습니다.

ETA 호출은 성공시 200 OK HTTP 상태 코드를 반환합니다.

곱슬 곱슬하다
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 호출 오류의 의미 및 처리 방법에 대한 정보는 오류 메시지를 참조하십시오.