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

온도 조절기

온도 조절기 제어

둥지 학습 온도 조절기 ™는 지속적으로 최적화 편안함과 에너지 절약 가정에서 사용 패턴에 대한 학습, 직관적이고 쉽게 사용할 수 인터넷에 연결된 장치입니다. 사용자는 인터넷 연결에 액세스 할 수있는 모든 곳에서 난방 및 냉방을 제어 할 수 있습니다.

이러한 기능을 지원하려면 단순한 설정 값 기반 프로그램을 능가하는 정교한 제어 시스템이 필요합니다. 둥지는 (같은 알고리즘의 넓은 범위를 제공 초기에 , 진정한 방사 , 에어 웨이브 ™ 대부분의 자동 온도 조절 장치에 비해 계산 상당한 양의 전력을 필요로). Nest Thermostat에는 이러한 고급 기능을 제공하는 데 필요한 전력이 있습니다.

둥지 API는 제품 둥지 알고리즘을 중단이나 예기치 않은 동작을 사용자에게 놀라게없이 HVAC 시스템을 제어 할 수 있도록 설계되었습니다. Nest Thermostat에 대한 다음 데이터에 대한 액세스를 제공합니다.

  • 구조 이름 및 장치 "where name"(집 내 위치)
  • 맞춤 온도 조절기 라벨
  • 온라인 상태 및 마지막 연결 정보
  • 현재 및 목표 온도
  • 온도 모드
  • 에코 온도
  • 시간-온도
  • 온도 눈금 (F / C 설정)
  • 온도 잠금 상태 및 잠금 경우, 최소 / 최대 고정 온도 값
  • 팬 타이머 기간 및 HVAC 모드
  • 습기
  • 선 블록

온도 조절기 권한

모든 온도 조절기 API 데이터 값에 대한 읽기 액세스의 선택 온도 조절기 읽고 클라이언트 권한을.

모든 온도 조절기의 API 데이터 값에 대한 읽기 액세스 및 추가 쓰기 액세스를 들어, 값을 선택하려면 선택 온도 조절기 읽기 / 쓰기 클라이언트 권한을. 이 권한 수준을 사용하면 다음을 업데이트 할 수 있습니다.

  • 목표 온도
  • HVAC 모드
  • 팬 타이머

Thermostat 읽기 / 쓰기 v5부터 다음을 업데이트 할 수도 있습니다.

  • 온도 눈금
  • 온도 조절기 라벨

온도 조절기 식별자

장치

Nest 기기는 유형별로 ID 배열로 나열되며 기기 경로를 통해 기기를 고유하게 식별하는 데 사용할 수 있습니다. 의 온도 조절 장치 ID 그래서 "peyiJNo..." 당신의 온도 조절 장치 모델로드 할 수 있다는 것을 의미한다 devices/thermostats/peyiJNo... API를 통해입니다.

장치가 여러 제품에 연결되면 각 개발자는 해당 장치에 대해 다른 ID를 보게됩니다. 동일한 개발자의 여러 제품을 설치 한 기기의 경우 개발자에게 동일한 ID가 표시됩니다.

이름

두 가지 이름 속성이 제공됩니다. 짧은 name 동안 속성은, 사용자 인터페이스 라벨에 표시됩니다 name_long 긴 형식의 텍스트에 사용됩니다.

name

이러한 예에서, name "복도"또는 "복도 (웨스트)"입니다.

이름긴 이름

name_long

이 예에서 name_long "사무소 (위층)"입니다.

메시지에 긴 이름

상표

이름 (레이블)
이름 (레이블)

부터 권한 버전 V5 , 당신은 API를 통해 라벨 온도 정의를 추가 할 수 있습니다. Nest 앱에서 라벨은 where 이름 뒤 괄호 안에 표시됩니다.

부터 권한 버전의 V6 , 당신은 또한 온도 조절기 라벨을 읽을 수 있습니다.

어디

where_id

  • 나타내는 고유 식별자 생성 둥지 name
  • where_id , 읽기 전용이며 어디에서 사용자 정의 만들 호출에 자동으로 생성되는 name

더의 이름 위치에 대해 알아 둥지 온도 조절 장치는 ,둥지를 보호 하고 둥지 캠 .

where_name

당신은 어떤 선택하면 온도 조절기 권한을 해당 장치에 액세스 할 수 있습니다 where_name 장치 개체 (에서 devices/thermostats ).

기타 메타 데이터

달리 지정하지 않는 한 모든 데이터 값은 읽기 전용입니다.

데이터 값 기술
locale 이 기기에 할당 된 언어 및 국가 코드
software_version 현재 장치에 설치된 펌웨어를 나타내는 문자열
structure_id 이 구조를 고유하게 나타내는 문자열입니다. 이것은 장치가 페어링 된 구조입니다.
last_connection Nest 서비스에 마지막으로 성공한 연결의 타임 스탬프
is_online 온라인 상태. 이렇게하여 둥지 판정 last_connection 시간 및 장치 특정 예상 재접속 창.

온도 조절기 기능

온도 조절기 모드

HVAC 시스템은 상태 ( "에"네이 heat , cool , heat-cool , eco 상태 "OFF")과 하나 ( off ). 우리는을 통해 편안함과 에너지 절약을 관리하기 위해 이러한 상태를 사용 hvac_mode 및 온도 데이터 값.

  • 가열 또는 냉각 모드 (때 heat , cool )를 선택하면 온도 조절기는 목표 온도에 홈을 조정합니다.
  • 열 • 쿨 모드 (때 heat-cool )를 선택하면 온도 조절기는 원하는 온도 범위 내에서 편안한 가정을 유지합니다.
  • 에코 온도 (환경)을 선택, 온도 조절기 편안한 집을 유지하고 에너지 사용량을 줄이기 위해 에너지 절약 알고리즘을 적용합니다. 이 모드의 온도 조절기는 ECO를 표시합니다.

구조에는 현재 상태와 관련된 두 가지 상태 (홈 또는 자리 비움)가 있습니다. 집에서 움직임이 감지되지 않으면 구조가 집에서 자리 비움으로 변경되고 집의 온도 조절기가 자동으로 에코 온도를 활성화합니다.

어떻게 hvac_mode 및 온도 값이 함께 작동

의 값에 따라 hvac_mode , 특정 온도 데이터 값은 API에 액세스 할 수있다 :

HVAC 모드 액세스 할 수있는 온도 데이터 값
heat 또는 cool target_temperature_f 또는 target_temperature_c
heat-cool target_temperature_low_ftarget_temperature_high_f
또는
target_temperature_low_ctarget_temperature_high_c
eco eco_temperature_low_feco_temperature_high_f
또는
eco_temperature_low_ceco_temperature_high_c
off 없음

일부 시나리오에서는 변화의 주위에 특별한 규칙이 hvac_mode :

대본hvac_mode 변경 될 수?
온도 잠금 사용 가능
긴급 차단이 활성화되어 아니
비상 열은 사용 가능 아니
can_cool 또는 can_heat 값은 false 아니

에코 온도

에코 온도를 사용하면 집에 있든 없든 에너지를 절약 할 수 있습니다. 스위칭 고려 hvac_modeeco 제품에 에너지 절약 행동을 구현할 때.

에코 온도 엔드 포인트는 읽기 및 읽기 / 쓰기 V6 권한을 온도 조절기로 시작 둥지 API에서 사용할 수 있습니다.

에코 모드와 비 에코 모드 간 전환

제품은 에코 모드에서 직접 목표 온도를 관리 할 필요가 없습니다. 집이 외출로 설정되면 목표 온도가 표시되지 않고 사용자 선택에 따라 내부적으로 설정됩니다. 온도 조절기가 OFF로 설정되면 목표 온도가 관찰되지 않습니다.

절대적으로 목표 온도를 직접 변경해야하는 경우 두 개의 개별 호출로 변경해야합니다.

  1. 변경 hvac_mode 제외한 다른 값으로 eco
  2. 적절한의 수정 target_temperature 데이터 값을

온도 조절기로 시작하는 것은 읽기 및 읽기 / 쓰기 V6 권한, 당신은에 액세스 할 수 있습니다 previous_hvac_mode HVAC 모드 전환을 지원하기 위해 API를 통해. previous_hvac_mode 가게에 사용되는 hvac_mode 는 "환경"으로 전환하기 전에 장치를.

예를 들어, 둥지 경우 온도 조절기가 에코 온도 (사용 hvac_mode = "eco" ), previous_hvac_mode 가능하며, 당신은 세트 제품을 원하는 target_temperature , 당신이 먼저해야합니다 :

  1. GET previous_hvac_mode
  2. 세트 hvac_mode 받는 previous_hvac_mode
  3. 확인 hvac_mode 더 이상 설정되어 "친환경"

이 단계 후에 목표 온도를 적절하게 설정하십시오.

에 따라 hvac_mode 값이 어떻게 previous_hvac_mode 변경 :

hvac_mode 상태가 ... 그런 다음, previous_hvac_mode 될 수 있습니다 ...
eco heat , cool , heat-cool 또는 off
heat , cool , heat-cool 또는 off 공백 / 비어 있음

목표 온도

목표 온도는 HVAC 시스템에서 가장 중요한 값이며 일반적으로 사용자가 설정하는 원하는 온도입니다. 대부분의 행동과 결정은이를 기반으로합니다. API에서 Works with Nest 제품은 더 큰 프로세스의 일부로 목표 온도를 작성할 수 있습니다.

시스템이 켜져있을 때 항상 목표 온도가 설정됩니다.

  • 가열 또는 냉각 모드 (때 heat , cool ) 선택, 하나의 target_temperature 세트입니다
  • 열 • 냉각 모드 (되면 heat-cool )를 선택하면 두 target_temperature 값은 목표 범위, 높은 냉각 한 가열을위한 하나의 하부를 나타내는, 설정된
  • 에코 모드 (하면 eco ) 선택하고, 목표 온도 범위는 내부에 설정된

또한 집안의 파이프가 얼거나 과도하게 높은 온도를 방지하기위한 안전 온도도 있습니다.

온도 조절기가 꺼져 있으면 목표 온도가 설정되지 않습니다.

시간-온도

타임 - 투 - 온도 당신에게 HVAC 시스템이 데이터 값에 액세스 할 수 있습니다 :

  • time_to_target - 시간은 분 단위는 구조 걸릴 것으로 목표 온도에 도달하는
  • time_to_target_training
    • 교육 상태
    • 온도 조절기가 HVAC 시스템이 어떻게 반응하는지 학습하면 목표 온도에 도달하기위한 추정치를 조정합니다.
    • 온도 조절기가 목표 온도에 도달하는 시간 추정의 합리적으로 확인되면 상태가 변경됩니다 training 에 대한 ready

주변 온도

온도 조절기 근처에서 측정 한 온도입니다. 사용자가 선호하는 온도 눈금에 해당하는 값을 표시합니다.

온도 눈금

주변 및 목표 온도 변수는 섭씨 또는 화씨 눈금으로 구성됩니다. temperature_scale 특성은 사용자 환경에 따라 어느 "F"또는 "C"가 될 것이다. 이 속성은 각 온도 조절기에 의해 설정되므로 단일 구조에서 사용자는 각 온도 눈금에 하나씩 두 개의 온도 조절기를 가질 수 있습니다. 계속 사용자 환경 온도 값을 표시 할 때 마음에.

부터 권한 버전 V5 , 당신은 API를 통해 온도 눈금을 변경할 수 있습니다.

대상 및 주위 온도 필드가 _f 하고 _c 온도를 표시 할 때 일관성있는 라운딩을 수용 할 수 있도록 변형.

온도 표시

온도 조절기

당신이 목표 온도 정보를 표시 할 때,이 세 가지 종속 값을 고려 temperature_scale , hvac_mode 및 구조의 away 상태.

많은 데이터 값이 함께 작동하여 Nest Thermostat 디스플레이에 표시되는 내용과 작동 방식을 결정합니다.

  • 경우 hvac_mode 설정되어 heat-cool 둥지 스탯 표시 하한 및 상한 설정 값은 목표 온도, 총알이 캐릭터 (•)에 의해 그렇지 않으면 둥지 스탯 표시 구분
  • hvac_mode 설정되어 off , 단어 "OFF"은 사용자가 선호하는 언어로, 둥지 온도 조절기에 표시됩니다
  • hvac_mode 설정되어 eco , 단어 "ECO"은 사용자가 선호하는 언어로, 둥지 온도 조절기에 표시됩니다

디스플레이 온도 형식은 선택한 온도 눈금 (F / C)에 따라 다릅니다.

화씨 온도는 정수로 표시됩니다.

  • 목표 온도 : 55 ° F
  • 주변 온도 : 62 ° F

섭씨 온도는 정수 또는 10 진수 값으로 표시되며 마지막 숫자는 ".5"로 설정됩니다.

  • 목표 온도 : 12 ° C
  • 주변 온도 : 16.5 ° C

리프 아이콘이 서모 스탯의 전면에 표시 될 때, 서모 스탯은 에너지 절약 온도로 설정하고, has_leaf = true .

잎

온도 잠금

사용자는 제한된 온도 범위 내에서만 조정할 수 있도록 Nest 온도 조절기를 잠글 수 있습니다. 부터 권한 버전 V5 , 당신은 볼 수 있습니다 온도 잠금을 선택하여 사용할 수 is_locked ,하고 있는지, API를 통해 온도 잠금 최소 / 최대 값을 읽을 :

잠금 온도는 최대 및 최소 값으로, 쌍으로 지정해야하며, 경우에만 쓸 수 is_locked = true .

습기

장치에서 측정 한 퍼센트 (%) 형식의 습도이며 가장 가까운 5 %로 반올림됩니다.

선 블록

자외선 차단제의 기술은 자동으로 기기 직사광선으로부터 발생 열 스파이크를 보상하기 위해 네스트 온도 조절기의 온도를 조절한다.

이러한 데이터 값은 Sunblock이 활성화되었는지 여부 및 / 또는 온도를 적극적으로 수정하는지 여부를 알려줍니다.

부채

대부분의 HVAC 시스템은 즉, 팬을 통합 한 팬이 독립적으로 제어 할 수 없습니다 . 통합 팬에 대한 끄기 모드는 없습니다. 가열 또는 냉각이 켜져있을 때 팬이 작동해야하기 때문입니다.

그러나 HVAC 시스템이 호환되는 경우 전체 HVAC 시스템을 사용하지 않고도 탑승자를보다 편안하게 만들기 위해 API를 통해 팬을 명시 적으로 켤 수 있습니다.

팬이 독립적으로 제어 될 수 있다면, has_fan 설정 될 것이다 true 읽기 / 쓰기 권한을, 다음의 데이터 값은 온도 조절기로 설정 될 수있다 :

  • fan_timer_active - 부울 반환 true 팬 타이머가 미리 프로그램 된 시간 동안 종사하는 경우
  • fan_timer_duration - INT, 시간 (분)의 길이 팬이 실행되도록 설정되어 있는지

이 값을 함께 사용하여 특정 시간 동안 팬 타이머를 시작합니다 (팬 켜기). 당신은 또한 사용할 수 있습니다 fan_timer_timeout 팬이 실행 중지로 설정되어있는 경우의 타임 스탬프를 결정하는 값입니다.

당신은 항상 변경할 수 있습니다 fan_timer_duration 가 독립적 인 - hvac_mode 또는 구조 점유 상태 (멀리).

성공 또는 실패시 다음과 같은 응답을 기대할 수 있습니다.

  • 200 OK
  • 400 잘못된 요청

팬을 켜라는 명령이 예상 된 결과를 생성하지 못하면 팬이 이미 연결되어 있기 때문일 수 있습니다 (사용자가 수동으로 또는 일정에 따라 또는 HVAC 가열 / 냉각 주기로 인해).

속도 제한

시스템 또는 배터리 성능에 영향을 미칠 수있는 과도한 장치 호출로부터 보호하기 위해 속도 제한을 적용합니다. 정상적인 조건에서 Nest 기기는 난방 및 냉방 시스템의 저전압 전선을 통해 배터리를 충전합니다. 하지만 단시간에 과도한 전화가 걸려 배터리 잔량이 부족 해지면 Nest 온도 조절기가 Wi-Fi를 꺼서 전력을 절약합니다.

실제로 이는 정의 된 기간 내에 장치에 걸 수있는 통화 수를 제한한다는 것을 의미합니다. 이 한도를 초과하면 오류 응답과 한도를 초과했다는 메시지가 표시됩니다.

자세한 내용은 데이터 속도 제한을 .

전력 제약

경우에 따라 온도 조절기에 배터리 전원이 부족하여 수정 요청을 처리 할 수 ​​없습니다. 이 경우 오류 응답과 장치가 현재 요청을 처리 할 수 ​​없다는 메시지가 표시됩니다. 이 경우 다시 시도하기 전에 배터리를 재충전 할 시간을주십시오.

에 대해 자세히 알아보기 Nest 인공 지능 온도 조절기 낮은 배터리 상태 .

오류 메시지

일부 상태에서는 특정 기능을 사용할 수 없게됩니다. 이러한 규칙은 에너지를 보존하거나 편안함과 안전을 제공하기 위해 마련되었습니다.

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

Wi-Fi / 연결 문제

장치가 오프라인이면 수정이 허용되지 않습니다. 데이터 모델에서 디바이스의 온라인 상태를 관찰하고 적절하게 UI를 표시 할 수 있습니다.