Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

원정 및 ETA

떨어져

Nest API에서 '집'또는 '자리 비움'개념은 Nest의 에너지 절약 및 편의 기능 동작에 강력한 영향을 미칩니다.

Home and Away 작동 방식

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

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

  • 에너지를 절약하기 위해 집이 자리를 비울 때 조명을 끕니다.
  • 집이 비었을 때 차고 문이 열려 있으면 알림을 보냅니다.
  • 집이 집으로 전환되면 음악 재생

ETA 작동 원리

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

Nest Thermostat에 통합 된 ETA 앱을 사용하면 사용자가 오기 전에 온도 조절기가 집을 데우거나 냉각하기 시작합니다.

사용자 계정에 ETA / 온도 조절기 통합이있는 경우 다른 Works with Nest 개발자가 Works with Nest 통합에서 사용할 수 있도록 ETA 데이터를 사용할 수 있습니다.

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

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

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

예를 들어 조명 공급 업체라고 가정합니다. ETA / 서모 스탯 통합으로 제공되는 ETA 데이터를 가져 와서 조명을 켜는 신호로 사용할 수 있습니다.

이렇게하면 온도가 편안 할뿐만 아니라 사용자가 집에 도착했을 때 조명도 켜집니다.

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

  • 사용자가 집에 접근하면 TV를 켭니다.
  • 사용자가 거의 집에있을 때 차고 문을 엽니 다.
  • 사용자가 집에 돌아 왔을 때 이미 음악이 재생되는 경우

자리 비움 권한

다음 액세스 권한 수준에 사용할 수있는 멀리 관련 데이터 값 :



접속하다

멀리 읽기
자리 비움 읽기 / 쓰기

ETA 읽기

ETA 읽기 / 쓰기

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

더 많은 정보를 들어, 참조 권한 개요 .

자리 비움 기능

홈 앤 어웨이

away 둥지는 구조가 점령 생각하면 데이터 값을 알 수 있습니다. 가능한 값은 다음과 같습니다.

기술
home 구조에 누군가가 있습니다. 이 상태는 다음과 같이 설정할 수 있습니다.
• Nest가 모션 센서 데이터에서 높은 신뢰도를 가지고있는 경우
• 통하여, 사용자가 둥지 응용 프로그램 , 둥지 온도 조절기, 또는 제품
• ETA를 통한 알고리즘 방식
away 구조에 아무도 없습니다. 사용자가 명시 적 중 하나를 통해, 멀리로 구조를 설정 한 둥지 응용 프로그램 , 둥지 온도 조절기, 또는 제품.
unknown 어떤 장치가 구조와 연관되지 않는 경우, 떨어진 상태입니다 unknown .

Nest API는 홈 및 자리 비움을 직접 설정하고 이러한 상태의 변경 사항을 수신하는 기능을 제공합니다. 홈을 설정하고 멀리 할 때 그러나, 그것은 수행해야 둥지 애플 리케이션 을 수행합니다 명시적인 사용자 요청의 결과로. 알고리즘이 상태를 설정하려고하는 것은 혼란 사용자 경험을 생성의 위험을 실행에 의해 금지되어 둥지 디자인 정책 .

사용자는 항상 수동으로 홈 / 어웨이 상태를 설정하는 기능이 있음을 유의하십시오.

더에 대해 알아 사용자가 홈과 어웨이 상태를 설정하는 방법 .

ETA

떨어져

ETA는 구조를 설정할 수있는 필드를 목적으로한다. 사용자가 특정 시간에 집으로 돌아갈 것으로 예상된다는 것을 Nest에 알리는 데 사용됩니다. 도착 예정 시간을 설정하는 경우, 제품 고유 생성 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 타임 스탬프
보다 커야합니다 NOW 에, 8601 ISO 형식
estimated_arrival_window_end 타임 스탬프
보다 커야합니다 estimated_arrival_window_begin 에, 8601 ISO 형식

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 . 이 호출에서 문자열 ( "0")이 아닌 정수 (0)를 보내고 있는지 확인하십시오. 그렇지 않으면 호출이 실패합니다.

오류 메시지

API 호출 오류의 의미와이를 처리하는 방법, 무엇을보고에 대한 자세한 내용은 오류 메시지 .