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

온도 조절기

온도 조절기 제어

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

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

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

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

온도 조절기 권한

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

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

  • 목표 온도
  • 공조 모드
  • 팬 타이머

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에 액세스 할 수있다 :

공조 모드 액세스할 수 있는 온도 데이터 값
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 온도 조절기 디스플레이에 표시되는 내용과 작동 방식을 결정합니다.

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

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

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

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

섭씨 온도는 정수 또는 소수 값으로 표시되며 마지막 숫자는 ".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 Thermostat은 전력을 절약하기 위해 Wi-Fi를 끕니다.

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

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

전력 제약

경우에 따라 온도 조절 장치의 배터리 전원이 수정 요청을 처리하기에 충분하지 않을 수 있습니다. 이 경우 장치가 현재 요청을 처리할 수 없음을 나타내는 오류 응답과 메시지를 받게 됩니다. 이 경우 다시 시도하기 전에 배터리를 재충전할 시간을 주십시오.

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

오류 메시지

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

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

Wi-Fi / 연결 문제

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