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

온도 조절기

온도 조절기 제어

Nest Learning ThermostatTM은 직관적이고 사용하기 쉬운 인터넷 연결 기기로, 집에서의 사용 패턴에 관해 지속적으로 학습하여 편안함을 최적화하고 에너지를 절약합니다. 사용자는 인터넷이 연결된 모든 곳에서 냉난방을 제어할 수 있습니다.

이러한 기능을 지원하려면 단순한 setpoint 기반 프로그램을 뛰어넘는 정교한 제어 시스템이 필요합니다. Nest는 대부분의 온도 조절기에 비해 상당한 연산 성능이 필요한 다양한 알고리즘 (예: Early On, True Radiant, AirwaveTM)을 제공합니다. Nest Thermostat은 이러한 고급 기능을 제공하는 데 필요한 전력을 보유하고 있습니다.

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

  • 집 이름 및 기기 '장소 이름'(집 위치)
  • 맞춤 온도 조절기 라벨
  • 온라인 상태 및 마지막 연결 정보
  • 현재 및 희망 온도
  • 온도 모드
  • 절전 온도
  • 온도 시간
  • 온도 범위 (F/C 설정)
  • 온도 잠금 상태, 잠겨 있는 경우 최소/최대 잠긴 온도 값
  • 팬 타이머 시간 및 HVAC 모드
  • 습도
  • 직사광선 차단

온도 조절기 권한

모든 Thermostat API 데이터 값에 대한 읽기 액세스 권한을 부여하려면 클라이언트의 온도 조절기 읽기 권한을 선택합니다.

모든 Thermostat API 데이터 값에 대한 읽기 액세스 권한과 일부 값에 대한 추가 쓰기 액세스 권한을 얻으려면 클라이언트에 대한 온도 조절기 읽기/쓰기 권한을 선택합니다. 이 권한 수준을 사용하면 다음을 업데이트할 수 있습니다.

  • 희망 온도
  • HVAC 모드
  • 팬 타이머

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

  • 온도 범위
  • 온도 조절기 라벨

온도 조절기 식별자

기기

Nest 기기는 유형별로 ID 배열로 나열되며, 기기 경로를 통해 기기를 고유하게 식별하는 데 사용할 수 있습니다. 따라서 온도 조절기 ID가 "peyiJNo..."이면 API를 통해 devices/thermostats/peyiJNo...에서 온도 조절기 기기를 로드할 수 있습니다.

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

이름

이름 속성 2개가 제공됩니다. 더 짧은 name 속성은 사용자 인터페이스 라벨에 표시되고 name_long는 긴 형식 텍스트에 사용됩니다.

name

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

이름 이름 길게 지정

name_long

이 예에서 name_long는 "Office (위층)"입니다.

메시지의 긴 이름

라벨

장소 이름 (라벨)
장소 이름 (라벨)

권한 버전 v5부터 API를 통해 맞춤 온도 조절기 라벨을 추가할 수 있습니다. Nest 앱에서는 장소 이름 뒤에 괄호로 라벨이 표시됩니다.

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

위치

where_id

  • name를 나타내는 고유한 Nest 생성 식별자
  • where_id은 읽기 전용이며, 호출에서 자동으로 생성되어 name를 만듭니다.

Nest 온도 조절기, Nest Protect, Nest Cam의 이름을 자세히 알아보세요.

where_name

온도 조절기 권한을 선택하면 기기 객체 (devices/thermostats)에서 기기 where_name에 액세스할 수 있습니다.

기타 메타데이터

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

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

온도 조절기 기능

온도 조절기 모드

  • 난방 또는 냉방 모드(heat, cool)를 선택하면 온도 조절기가 집 온도를 원하는 온도로 조정합니다.
  • 난방 • 냉방 모드(heat-cool)를 선택하면 온도 조절기가 선호하는 온도 범위 내에서 집을 편안하게 유지합니다.
  • 절전 온도(eco)를 선택하면 온도 조절기가 에너지 절약 알고리즘을 적용하여 집을 편안하게 유지하고 에너지 사용량을 줄입니다. 이 모드의 온도 조절기는 ECO를 표시합니다.

집에는 재택 또는 외출과 같은 두 가지 상태가 있습니다. 집에서 움직임이 감지되지 않으면 집의 재택 및 외출 모드로 구조가 변경되며, 집의 온도 조절기에서 절전 온도를 자동으로 사용 설정합니다.

hvac_mode와 온도 값이 함께 작동하는 방식

hvac_mode의 값에 따라 API에서 특정 온도 데이터 값에만 액세스할 수 있습니다.

HVAC 모드 액세스할 수 있는 온도 데이터 값
heat 또는 cool target_temperature_f 또는 target_temperature_c
heat-cool target_temperature_low_f, target_temperature_high_f
또는
target_temperature_low_c, target_temperature_high_c
eco eco_temperature_low_f, eco_temperature_high_f
또는
eco_temperature_low_c, eco_temperature_high_c
off 없음

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

시나리오 hvac_mode을 변경할 수 있나요?
온도 잠금이 사용 설정됨 Yes
긴급 종료가 활성 상태임 No
긴급 난방 사용 설정됨 No
can_cool 또는 can_heat 값은 false입니다. No

절전 온도

절전 온도를 사용하면 사용자가 집에 있는지와 상관없이 에너지를 절약할 수 있습니다. 제품에 에너지 절약 동작을 구현할 때 hvac_modeeco으로 전환하는 것이 좋습니다.

절전 온도 엔드포인트는 Nest API에서 온도 조절기 읽기 및 읽기/쓰기 v6 권한부터 사용할 수 있습니다.

절전 모드 및 비 절전 모드 간 전환

제품이 절전 모드에서 직접 목표 온도를 관리할 필요는 없어야 합니다. 집이 외출 모드로 설정된 경우 목표 온도가 표시되지 않지만 사용자 선택에 따라 내부적으로 설정됩니다. 온도 조절기가 꺼짐으로 설정되어 있으면 희망 온도가 관찰되지 않습니다.

희망 온도를 직접 변경해야 한다면 두 개의 별도 호출로 변경해야 합니다.

  1. hvac_modeeco를 제외한 다른 값으로 변경합니다.
  2. 적절한 target_temperature 데이터 값 수정

온도 조절기 읽기 및 읽기/쓰기 v6 권한부터 API를 통해 previous_hvac_mode에 액세스하여 HVAC 모드 전환을 지원할 수 있습니다. previous_hvac_mode는 기기가 "eco"로 전환되기 전에 hvac_mode를 저장하는 데 사용됩니다.

예를 들어 Nest Thermostat에서 절전 온도 (hvac_mode = "eco")를 사용하고 있으며 previous_hvac_mode를 사용할 수 있으며 제품을 target_temperature로 설정하려면 먼저 다음을 해야 합니다.

  1. previous_hvac_mode 가입
  2. hvac_modeprevious_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" 또는 이 속성은 각 온도 조절기에 의해 설정되므로, 사용자가 단일 집에 체온계에 하나씩 두 개의 온도 조절기를 포함할 수 있습니다. 온도 값을 표시할 때 사용자 환경설정을 염두에 두세요.

권한 버전 v5부터 API를 통해 온도 범위를 변경할 수 있습니다.

타겟 및 주변 온도 필드에는 _f_c 변형이 있어 온도를 표시할 때 일관된 반올림을 수용할 수 있습니다.

온도 디스플레이

온도 조절기

희망 온도 정보를 표시할 때 종속 값 temperature_scale, hvac_mode, 구조 away 상태를 고려하세요.

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

  • hvac_modeheat-cool로 설정되어 있으면 Nest Thermostat은 낮음 및 높은 설정치를 글머리기호 문자 (•)로 구분하여 표시합니다. 그렇지 않으면 Nest Thermostat에서 목표 온도만 표시합니다.
  • hvac_modeoff로 설정되어 있으면 단어 'OFF'\'가 Nest 온도 조절기에 사용자가 선호하는 언어로 표시됩니다.
  • hvac_modeeco로 설정되어 있으면 'ECO"라는 단어가 Nest 온도 조절기에 사용자가 선호하는 언어로 표시됩니다.

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

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

  • 희망 온도: 13°C
  • 주변 온도: 19.3°C

섭씨 온도는 마지막 자리를 '.t&5'로 설정한 정수 또는 십진수 값으로 표시합니다.

  • 희망 온도: 12°C
  • 주변 온도: 16.5°C

온도 조절기 앞에 리프 아이콘이 표시되면 온도 조절기가 에너지 절약 온도로 설정되고 has_leaf = true이 됩니다.

잎

온도 조절기

사용자는 제한된 온도 범위 내에서만 조정되도록 Nest Thermostat을 잠글 수 있습니다. 권한 버전 v5부터 is_locked를 확인하여 온도 잠금이 사용 설정되어 있는지 확인하고 사용 설정된 경우 API를 통해 온도 잠금 최솟값/최댓값을 읽을 수 있습니다.

잠금 온도는 쌍의 최댓값과 최솟값으로 지정해야 하며 is_locked = true인 경우에만 작성할 수 있습니다.

습도

습도는 백분율 (%) 형식으로, 기기에서 측정되었으며 가장 가까운 5%로 반올림됩니다.

직사광선 차단

직사광선 차단 기술은 Nest Thermostat의 온도를 자동으로 조정하여 기기의 직사광선으로 인해 발생하는 열 급증을 보정합니다.

이러한 데이터 값은 직사광선 차단이 사용 설정되어 있는지 또는 온도를 적극적으로 보정하고 있는지를 알려줍니다.

  • sunlight_correction_enabled
    • 부울, 직사광선 차단이 사용 설정된 경우 true를 반환합니다.
  • sunlight_correction_active - 부울입니다. 직사광선 차단이 활성화되어 있으면 온도 조절기가 직사광선에 있음을 나타내는 true가 반환됩니다.

선풍기

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

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

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

  • fan_timer_active - 부울입니다. 팬 타이머가 사전 프로그래밍된 기간 동안 참여하면 true를 반환합니다.
  • fan_timer_duration - 팬이 가동되도록 설정된 시간 (분)

이러한 값을 함께 사용하여 특정 기간 동안 팬 타이머를 시작 (팬 켜기)합니다. fan_timer_timeout 값을 사용하여 팬이 중지되도록 설정된 시점의 타임스탬프를 확인할 수도 있습니다.

언제든지 fan_timer_duration를 변경할 수 있습니다. 이는 hvac_mode 또는 점유 상태 (외출)와는 별개입니다.

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

  • 200 확인
  • 400 잘못된 요청

팬을 켜는 명령어에서 기대한 결과가 도출되지 않는다면 팬이 수동으로 작동하거나, 일정에 따라 또는 HVAC 난방/냉방 주기로 인해 팬이 이미 참여하고 있는 것일 수 있습니다.

비율 제한

속도 제한을 적용하여 기기의 과도한 호출로부터 시스템이나 배터리 성능에 영향을 줄 수 있습니다. 일반적인 조건에서는 Nest 기기가 난방 및 냉방 시스템의 저전압선에서 배터리를 충전합니다. 그러나 단기간에 과도하게 자주 전화를 걸거나 배터리 수준이 부족하면 Nest Thermostat은 Wi-Fi를 사용 중지하여 전력을 절약합니다.

실제로 이는 지정된 기간 내에 기기로 호출할 수 있는 횟수를 제한합니다. 이 한도를 초과하면 오류 응답과 한도를 초과했음을 알리는 메시지가 표시됩니다.

자세한 내용은 데이터 속도 제한을 참조하세요.

전력 제약

경우에 따라 온도 조절기에 수정 요청을 처리하는 데 필요한 배터리 전원이 충분하지 않을 수 있습니다. 이 경우 현재 오류 요청을 처리할 수 없음을 나타내는 메시지가 표시됩니다. 그런 경우 그런 다음 배터리를 충전한 후 다시 시도해 보세요.

Nest Learning Thermostat의 배터리 부족 상태에 관해 자세히 알아보세요.

오류 메시지

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

API 호출 오류의 의미와 처리 방법을 알아보려면 오류 메시지를 참조하세요.

Wi-Fi / 연결 문제

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