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

원정 및 ETA

떨어져

Nest API에서 '재택' 또는 '외출'의 개념은 Nest의 에너지 절약 및 편의 기능의 동작에 강력한 영향을 미칩니다.

재택 및 외출 작동 방식

Nest는 다양한 신호를 사용하여 집에 사람이 있는지 감지합니다. Nest가 오랜 시간 동안 사람이 없는 것을 감지하면 자동으로 집을 외출로 설정합니다. 사람의 존재를 감지하면 구조를 홈 상태로 되돌립니다.

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

  • 에너지 절약을 위해 집이 외출 중일 때 조명을 끄십시오.
  • 집이 부재 중일 때 차고 문이 열려 있으면 알림 보내기
  • 집이 집으로 전환될 때 음악 재생

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 호출을 .
  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를 켭니다.
  • 사용자가 거의 집에 있을 때 차고 문을 엽니다.
  • 사용자가 집에 돌아왔을 때 이미 음악이 재생되도록 합니다.

외출 권한

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



접속하다

멀리 읽기
멀리 읽기/쓰기

ETA 읽기

ETA 읽기/쓰기

연기+일산화탄소 경보 읽기
온도 조절기 읽기
온도 조절기 읽기/쓰기
away
eta_begin (읽기 전용)
eta 객체 (쓰기 전용)

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

외출 기능

홈 앤 어웨이

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

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

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

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

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

예상 도착 시간

떨어져

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 호출 오류의 의미와이를 처리하는 방법, 무엇을보고에 대한 자세한 내용은 오류 메시지 .