Google은 블랙 커뮤니티를위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 방법을보십시오.
이 페이지는 Cloud Translation API를 통해 번역되었습니다.
Switch to English

온도 조절기

온도 조절기 제어

Nest Learning Thermostat ™ 는 인터넷 연결 장치로 직관적이고 사용하기 쉬우 며 집안의 사용 패턴을 지속적으로 학습하여 편안함을 최적화하고 에너지를 절약합니다. 사용자는 인터넷 연결이 가능한 어디에서나 냉난방을 제어 할 수 있습니다.

이러한 기능을 지원하려면 간단한 설정 점 기반 프로그램을 능가하는 정교한 제어 시스템이 필요합니다. Nest는 대부분의 온도 조절기와 비교할 때 상당한 양의 계산 능력이 필요한 광범위한 알고리즘 (예 : Early On , True Radiant , Airwave ™ )을 제공합니다. Nest 온도 조절기는 이러한 고급 기능을 제공하는 데 필요한 성능을 갖추고 있습니다.

Nest API 는 제품이 Nest 알고리즘을 방해하거나 예기치 않은 동작으로 사용자를 놀라게하지 않고도 HVAC 시스템을 제어 할 수 있도록 설계되었습니다. Nest 온도 조절기에 대한 다음 데이터에 액세스 할 수 있습니다.

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

온도 조절기 권한

모든 Thermostat API 데이터 값에 대한 읽기 액세스 권한을 얻으려면 클라이언트에 대한 Thermostat 읽기 권한을 선택하십시오.

모든 Thermostat API 데이터 값에 대한 읽기 액세스 및 값 선택을위한 추가 쓰기 액세스를 위해서는 클라이언트에 대한 Thermostat 읽기 / 쓰기 권한을 선택하십시오. 이 권한 수준을 통해 다음을 업데이트 할 수 있습니다.

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

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

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

온도 조절기 식별자

장치

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

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

이름

두 가지 이름 속성이 제공됩니다. 더 짧은 name 속성은 사용자 인터페이스 레이블에 표시되고 name_long 은 긴 형식의 텍스트에 사용됩니다.

name

이 예에서 name 은 "Hallway"또는 "Hallway (West)"입니다.

이름긴 이름

name_long

이 예에서 name_long 은 "Office (Upstairs)"입니다.

메시지에서 긴 이름

상표

이름 (라벨)
이름 (라벨)

권한 버전 v5 부터 API를 통해 사용자 지정 온도 조절기 레이블을 추가 할 수 있습니다. Nest 앱에서 레이블은 위치 이름 뒤에 괄호 안에 표시됩니다.

권한 버전 v6 부터 온도 조절기 레이블을 읽을 수도 있습니다.

어디

where_id

  • name 을 나타내는 고유 한 Nest 생성 식별자
  • where_id 는 읽기 전용이며 호출시 자동으로 작성되어 사용자 정의 위치 name 을 작성합니다.

Nest 온도 조절기 , Nest ProtectsNest Cam의 이름에 대해 자세히 알아보십시오.

where_name

서모 스탯 권한 을 선택하면 장치 객체 ( devices/thermostats )에서 where_name 장치에 액세스 할 수 있습니다.

다른 메타 데이터

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

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

온도 조절기 기능

온도 조절기 모드

HVAC 시스템에는 4 가지 "켜기"상태 ( heat , cool , heat-cool , eco )와 하나의 "끄기"상태 ( off )가 있습니다. 이러한 상태를 사용하여 hvac_mode 및 온도 데이터 값을 통해 편안함과 에너지 절약을 관리합니다.

  • Heat 또는 Cool 모드 ( heat , cool )를 선택하면 서모 스탯이 홈을 목표 온도로 조정합니다.
  • 난방 • 냉방 모드 ( heat-cool )를 선택하면 서모 스탯이 원하는 온도 범위 내에서 편안하게 집을 유지할 수 있습니다.
  • Eco Temperatures (eco)를 선택하면 서모 스탯이 에너지 절약 알고리즘을 적용하여 집을 편안하게 유지하고 에너지 사용량을 줄입니다. 이 모드의 온도 조절기는 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 none

일부 시나리오에서는 hvac_mode 변경에 대한 특별한 규칙이 있습니다.

대본 hvac_mode 를 변경할 수 있습니까?
온도 잠금 이 활성화되었습니다
비상 차단 이 활성화되었습니다 아니
비상 열 이 활성화되었습니다 아니
can_cool 또는 can_heat 값이 false 아니

에코 온도

에코 온도를 사용하면 집에 있든 없든 에너지를 절약 할 수 있습니다. 제품에서 에너지 절약 동작을 구현할 때는 hvac_modeeco 전환하십시오.

Eco 온도 엔드 포인트온도 조절기 읽기 및 읽기 / 쓰기 v6 권한으로 시작하여 Nest API에서 사용할 수 있습니다.

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

제품이 에코 모드에서 직접 목표 온도를 관리 할 필요는 없습니다. 집이 떨어져있는 경우, 대상 온도는 표시되지 않지만 사용자 선택에 따라 내부적으로 설정됩니다. 온도 조절기가 OFF로 설정되어 있으면 목표 온도가 관찰되지 않습니다.

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

  1. hvac_modeeco 제외한 다른 값으로 변경하십시오.
  2. 적절한 target_temperature 데이터 값을 수정하십시오.

Thermostat 읽기 및 읽기 / 쓰기 v6 권한으로 시작하여 API를 통해 previous_hvac_mode 액세스하여 HVAC 모드 전환을 지원할 수 있습니다. previous_hvac_mode 는 장치가 "eco"로 전환되기 전에 장치의 hvac_mode 를 저장하는 데 사용됩니다.

예를 들어, Nest 온도 조절기가 Eco Temperatures ( hvac_mode = "eco" )를 사용하는 경우 previous_hvac_mode 를 사용할 수 있으며 제품에서 target_temperature 를 설정하려면 먼저 다음을 수행해야합니다.

  1. previous_hvac_mode 얻습니다
  2. hvac_modeprevious_hvac_mode 값으로 설정
  3. hvac_mode 가 더 이상 "eco"로 설정되어 있지 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 모드 ( heat , cool )를 선택하면 단일 target_temperature 가 설정됩니다
  • Heat • Cool 모드 ( heat-cool )를 선택한 경우, 목표 범위를 나타내는 두 가지 target_temperature 값이 설정됩니다.
  • 에코 모드 ( eco )를 선택하면 목표 온도 범위가 내부적으로 설정됩니다

또한 배관이 얼거나 집안에 과도하게 높은 온도를 방지하기위한 백스톱 안전 온도도 있습니다.

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

온도-시간

Time-to-Temperature를 사용하면 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_modeheat-cool 설정되면 Nest 온도 조절기는 낮은 설정 값과 높은 설정 값을 불릿 문자 (•)로 구분하여 표시합니다. 그렇지 않으면 Nest 온도 조절기가 대상 온도 만 표시합니다
  • hvac_modeoff 로 설정되면 "OFF"라는 단어가 Nest 온도 조절기에 사용자가 선호하는 언어로 표시됩니다
  • hvac_modeeco 로 설정되면 "ECO"라는 단어가 사용자가 선호하는 언어로 Nest 온도 조절기에 표시됩니다

디스플레이 온도 형식은 선택한 온도 눈금 (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 기술은 Nest 온도 조절기의 온도를 자동으로 조정하여 장치의 직사광선에서 발생하는 열 스파이크를 보정합니다.

이 데이터 값은 Sunblock이 활성화되어 있거나 온도를 적극적으로 수정하는지 알려줍니다.

부채

많은 HVAC 시스템에는 팬이 통합되어있어 팬을 독립적으로 제어 할 수 없습니다 . 가열 또는 냉각이 켜져있을 때 팬이 작동해야하므로 통합 팬에는 꺼짐 모드가 없습니다.

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

팬을 독립적으로 제어 할 수있는 경우 has_fantrue 로 설정되며 온도 조절기 읽기 / 쓰기 권한으로 다음 데이터 값을 설정할 수 있습니다.

  • 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 Learning Thermostat에서 배터리 부족 상태에 대해 자세히 알아보십시오.

오류 메시지

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

API 호출 오류의 의미 및 처리 방법에 대한 정보는 오류 메시지를 참조하십시오.

Wi-Fi / 연결 문제

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