Nest API hoạt động với tất cả mô hình Nest Learning ThermostatTM, ngoại trừ Máy điều nhiệt E có đường liên kết nhiệt ở Liên minh Châu Âu.
Người dùng có thể thêm nhiều Nest Thermostat vào nhóm devices/thermostats
, tối đa
cấu trúc tối đa.
Khi gọi đến vị trí dữ liệu này, bạn có thể truy cập dữ liệu của Nest Thermostat
(giá trị dữ liệu cho các thiết bị trong cấu trúc).
Bạn có thể tìm thấy tất cả các giá trị bên dưới trong mỗi devices/thermostats/device_id
trong tài liệu JSON.
device_id [mã_thiết_bị]
Giá trị nhận dạng duy nhất của Nest Thermostat.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/device_id |
|
Trả lại hàng | string Ví dụ: "peyiJNo0IldT2YlIVtYaGQ" |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
ngôn ngữ
Chỉ định lựa chọn ưu tiên về ngôn ngữ và khu vực (hoặc quốc gia).
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locale |
|
Trả lại hàng | string Ví dụ: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL" |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
phiên bản phần mềm
Phiên bản phần mềm.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/software_version |
|
Trả lại hàng | string Ví dụ: "4.0" |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
cấu trúc_id
Định cấu trúc giá trị nhận dạng duy nhất.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/structure_id |
|
Trả lại hàng | string Ví dụ: "VqFabWH21nw..." |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
tên
Tên hiển thị của thiết bị. Có thể là bất kỳ tên phòng nào từ danh sách mà chúng tôi cung cấp hoặc tên tùy chỉnh.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/name |
|
Trả lại hàng | string Ví dụ: "Hallway" |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
name_long
Tên hiển thị dài của thiết bị. Bao gồm một nhãn (tùy chỉnh) do người dùng tạo
hoặc thông qua wheres
.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/name_long |
|
Trả lại hàng | string Ví dụ: "Hallway Thermostat (cầu thang)" |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
Last_ connection
Dấu thời gian của lần tương tác thành công gần đây nhất với dịch vụ Nest, ở định dạng ISO 8601.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/last_connection |
|
Trả lại hàng | string Ví dụ: "2016-12-31T23:59:59.000Z" |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
is_online
Trạng thái kết nối thiết bị với dịch vụ Nest.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/is_online |
|
Trả lại hàng | boolean Giá trị: true, false |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
can_cool
Khả năng làm mát hệ thống (có điều hòa).
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/can_cool |
|
Trả lại hàng | boolean Giá trị: true, false |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
nhiệt_hàng_có thể
Khả năng sưởi ấm hệ thống.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/can_heat |
|
Trả lại hàng | boolean Giá trị: true, false |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
là_sử_dụng_để_nhận_dạng_sử_dụng
Trạng thái sưởi ấm khẩn cấp trong các hệ thống có chế độ bơm nhiệt để làm mát.
Khi tính năng Sưởi ấm khẩn cấp đang bật:
- Người dùng có thể điều chỉnh nhiệt độ mục tiêu trên thiết bị, nhưng không thể thay đổi chế độ cho đến khi tính năng Sưởi ấm khẩn cấp tắt
- Bạn vẫn có thể thay đổi
hvac_mode
thông qua API
Hãy xem bài viết Thời gian khẩn cấp là gì? để biết thêm thông tin về cách Nest Thermostat hỗ trợ chế độ Sưởi ấm khẩn cấp.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/is_using_emergency_heat |
|
Trả lại hàng | boolean Giá trị: true, false |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
có_người hâm mộ
Hệ thống có thể điều khiển quạt một cách độc lập với chế độ sưởi ấm hoặc làm mát.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/has_fan |
|
Trả lại hàng | boolean Giá trị: true, false |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
quạt_thời_gian_vận_chuyển
Cho biết liệu bộ hẹn giờ cho người hâm mộ có tương tác hay không; sử dụng với
fan_timer_duration
để bật quạt trong khoảng thời gian đặt trước (do người dùng chỉ định).
Hãy xem Tùy chọn kiểm soát dành cho người hâm mộ để biết thêm thông tin về cách khách hàng đặt thời lượng quạt.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_active |
|
Trả lại hàng | boolean Giá trị: true, false |
Truy cập | đọc/ghi |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
quạt_timer_timeout
Dấu thời gian hiển thị thời gian hẹn giờ của quạt đạt 0 (thời gian ngừng), ở định dạng ISO 8601.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_timeout |
|
Trả lại hàng | string Ví dụ: "2016-12-31T23:59:59.000Z" |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
có_ lá
Hiển thị khi máy điều nhiệt được đặt ở nhiệt độ tiết kiệm năng lượng.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/has_leaf |
|
Trả lại hàng | boolean Giá trị: true, false |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
nhiệt độ_tính_thang
độ F hoặc độ C; dùng để hiển thị nhiệt độ.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/temperature_scale |
|
Trả lại hàng | string enum Giá trị: "F", "C" |
Truy cập | đọc/ghi |
Có trong | Đọc: Đọc máy điều nhiệt / v1-v6 Đọc/ghi máy điều nhiệt / v1-v6 Viết: Đọc máy điều nhiệt/write / v5-v6 |
target_temperature_f
Nhiệt độ mong muốn, ở độ F đầy đủ (1°F). Được sử dụng khi
hvac_mode
= heat
hoặc cool
.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_f |
|
Trả lại hàng | number Ví dụ: 72 |
Dải ô | 50-90 |
Truy cập | đọc/ghi |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
target_temperature_c
Nhiệt độ mong muốn, ở nửa nửa độ C (0,5°C). Được sử dụng khi
hvac_mode
= heat
hoặc cool
.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_c |
|
Trả lại hàng | number Ví dụ: 21,5 |
Dải ô | 9-32 |
Truy cập | đọc/ghi |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
target_temperature_high_f
Nhiệt độ mục tiêu tối đa, hiển thị ở toàn bộ độ F (1°F).
Dùng khi hvac_mode
= heat-cool
(Chế độ Heat•Làm mát).
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_f |
|
Trả lại hàng | number Ví dụ: 80 |
Truy cập | đọc/ghi |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
target_temperature_high_c
Nhiệt độ mục tiêu tối đa, hiển thị bằng nửa độ C (0,5°C). Được sử dụng
khi hvac_mode
= heat-cool
(chế độ Heat•Làm mát).
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_c |
|
Trả lại hàng | number Ví dụ: 24,5 |
Truy cập | đọc/ghi |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
target_temperature_low_f
Nhiệt độ mục tiêu tối thiểu, hiển thị ở toàn độ F (1°F).
Dùng khi hvac_mode
= heat-cool
(Chế độ Heat•Làm mát).
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_f |
|
Trả lại hàng | number Ví dụ: 65 |
Truy cập | đọc/ghi |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
target_ temperature_thấp_c
Nhiệt độ mục tiêu tối thiểu, hiển thị bằng nửa độ C (0,5°C). Được sử dụng
khi hvac_mode
= heat-cool
(chế độ Heat•Làm mát).
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_c |
|
Trả lại hàng | number Ví dụ: 19,5 |
Truy cập | đọc/ghi |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
Eco_ temperature_high_f
Nhiệt độ tiết kiệm năng lượng tối đa, hiển thị ở toàn bộ độ F (1°F). Được sử dụng
khi hvac_mode
= eco
.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_f |
|
Trả lại hàng | number Ví dụ: 80 |
Truy cập | Chỉ đọc |
Có trong | Máy điều nhiệt đã đọc / v6 Máy điều nhiệt/đọc/ghi / v6 |
Eco_ temperature_cao_c
Nhiệt độ tiết kiệm năng lượng tối đa, hiển thị bằng 0,5 độ C. Được sử dụng
khi hvac_mode
= eco
.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_c |
|
Trả lại hàng | number Ví dụ: 24,5 |
Truy cập | Chỉ đọc |
Có trong | Máy điều nhiệt đã đọc / v6 Máy điều nhiệt/đọc/ghi / v6 |
Eco_ temperature_thấp_f
Nhiệt độ tiết kiệm năng lượng tối thiểu, hiển thị ở độ F (1°F) toàn bộ. Được sử dụng
khi hvac_mode
= eco
.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_f |
|
Trả lại hàng | number Ví dụ: 65 |
Truy cập | Chỉ đọc |
Có trong | Máy điều nhiệt đã đọc / v6 Máy điều nhiệt/đọc/ghi / v6 |
Eco_ temperature_thấp_c
Nhiệt độ tiết kiệm năng lượng tối thiểu, hiển thị bằng 0,5 độ C. Được sử dụng
khi hvac_mode
= eco
.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_c |
|
Trả lại hàng | number Ví dụ: 19,5 |
Truy cập | Chỉ đọc |
Có trong | Máy điều nhiệt đã đọc / v6 Máy điều nhiệt/đọc/ghi / v6 |
cách_nhiệt_độ_cao_không_giới_hạn_(ĐPRE NGPRENG HOẠT Đ (NG)
Nhiệt độ vắng mặt tối đa, hiển thị theo độ F (1°F) toàn bộ.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_f |
|
Trả lại hàng | number Ví dụ: 80 |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
cách_nhiệt_độ_cao_c. (ĐDE NGPRENG HOẠT Đ (NG)
Nhiệt độ vắng mặt tối đa, hiển thị bằng nửa độ C (0,5°C).
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_c |
|
Trả lại hàng | number Ví dụ: 24,5 |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
cách_nhiệt_độ_thấp]
Nhiệt độ vắng mặt tối thiểu, hiển thị ở độ F (1°F) toàn bộ.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_f |
|
Trả lại hàng | number Ví dụ: 65 |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
cách_nhiệt_độ_thấp_c.{0}ĐPRE NG (NG HOẠT Đ (NG)
Nhiệt độ vắng mặt tối thiểu, hiển thị bằng nửa độ C (0,5°C).
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_c |
|
Trả lại hàng | number Ví dụ: 19,5 |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
hvac_mode
Cho biết chế độ sưởi ấm/làm mát của hệ thống HVAC, chẳng hạn như Sưởi ấm/Làm mát đối với hệ thống có khả năng sưởi ấm và làm mát hoặc Nhiệt độ tiết kiệm năng lượng để tiết kiệm năng lượng.
- Bạn có thể thay đổi
hvac_mode
nếu máy điều nhiệt bị khóa - Không thể thay đổi
target_temperature_f
vàtarget_temperature_c
nếuhvac_mode
=off
hoặceco
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode |
|
Trả lại hàng | string enum Giá trị: "hot", "cool", "hot-cool", "eco", "off" |
Truy cập | đọc/ghi |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
môi trường xung quanh_nhiệt độ_f
Nhiệt độ đo bằng thiết bị (tính theo độ F) hoàn toàn (1°F).
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_f |
|
Trả lại hàng | number Ví dụ: 72 |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
môi trường môi trường xung quanh
Nhiệt độ đo bằng thiết bị (0,5°C) trên thiết bị.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_c |
|
Trả lại hàng | number Ví dụ: 21,5 |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v1-v6 Máy điều nhiệt/ghi / v1-v6 |
độ ẩm
Độ ẩm, ở định dạng phần trăm (%), được đo ở thiết bị, được làm tròn đến mức 5% gần nhất.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/humidity |
|
Trả lại hàng | number Ví dụ: 35 |
Dải ô | 0-100 |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v2-v6 Máy điều nhiệt/đọc/ghi / v2-v6 |
hvac_state
Cho biết hệ thống sưởi, thông gió và điều hòa đang chủ động sưởi ấm, làm mát hay đang tắt. Hãy sử dụng giá trị này để cho biết trạng thái hoạt động của dịch vụ HVAC.
Khi off
, hệ thống sưởi, thông gió và điều hòa không chủ động sưởi ấm hoặc làm mát. hvac_state
không phụ thuộc vào hoạt động của người hâm mộ.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/hvac_state |
|
Trả lại hàng | string enum Giá trị: "sưởi ấm", "làm mát", "tắt" |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v3-v6 Máy điều nhiệt đọc/ghi / v3-v6 |
where_id [mã_nhận_dạng]
Giá trị nhận dạng duy nhất do Nest tạo đại diện cho
name
– tên hiển thị của thiết bị.
Tìm hiểu thêm về vị trí của Nest Thermostat, Nest Protect và Nest Cam.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/where_id |
|
Trả lại hàng | string Ví dụ: "d6reb_OZTM..." |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v4-v6 Máy điều nhiệt đọc/ghi / v4-v6 |
bị khóa
Trạng thái Khóa máy điều nhiệt. Khi được đặt thành bật, tính năng Khóa nhiệt
sẽ được bật và hạn chế phạm vi nhiệt độ ở các giá trị tối thiểu/tối đa sau:
locked_temp_min_f
,
locked_temp_max_f
,
locked_temp_min_c
và
locked_temp_max_c
.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/is_locked |
|
Trả lại hàng | boolean Giá trị: true, false |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v5-v6 Máy điều nhiệt/ghi / v5 - 6 |
lock_min_f đã khóa
Nhiệt độ tối thiểu Khóa nhiệt, hiển thị ở toàn bộ độ F (1°F). Được sử dụng khi
is_locked
là true
.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_f |
|
Trả lại hàng | string Ví dụ: 65 |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v5-v6 Máy điều nhiệt/ghi / v5 - 6 |
quyết định tối đa
Nhiệt độ tối đa Khóa nhiệt, hiển thị theo toàn bộ độ F (1°F). Được sử dụng khi
is_locked
là true
.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_f |
|
Trả lại hàng | string Ví dụ: 80 |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v5-v6 Máy điều nhiệt/ghi / v5 - 6 |
lock_min_c
Nhiệt độ tối thiểu là Khóa nhiệt, hiển thị ở mức nửa độ C (0,5°C). Được sử dụng
khi is_locked
là true
.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_c |
|
Trả lại hàng | string Ví dụ: 19,5 |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v5-v6 Máy điều nhiệt/ghi / v5 - 6 |
lock_max_c
Nhiệt độ tối đa của Khóa nhiệt,
hiển thị bằng nửa độ C (0,5°C). Được sử dụng
khi is_locked
là true
.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_c |
|
Trả lại hàng | string Ví dụ: 24,5 |
Truy cập | Chỉ đọc |
Có trong | Đọc máy điều nhiệt / v5-v6 Máy điều nhiệt/ghi / v5 - 6 |
nhãn
Nhãn tùy chỉnh của máy điều nhiệt. Hiển thị trong dấu ngoặc đơn, sau tên vị trí.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/label |
|
Trả lại hàng | string Ví dụ: "Tầng trên", "Phòng khách", "Phòng vui chơi" |
Truy cập | đọc/ghi |
Có trong | Đọc: Đọc máy điều nhiệt / phiên bản 6 Đọc/ghi / phiên bản 6 của máy điều nhiệt Viết: Đọc/ghi máy điều nhiệt / phiên bản 5-v6 |
sun_Đính kèm
Trạng thái bật Sunblock. Đã sử dụng với
sunlight_correction_active
.
Khi true
, công nghệ Sunblock đang bật và Máy điều nhiệt
tự động điều chỉnh theo ánh nắng trực tiếp, đọc và đặt nhiệt độ chính xác.
Để biết thêm thông tin, hãy xemSunblock là gì?
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_enabled |
|
Trả lại hàng | boolean Giá trị: true, false |
Truy cập | Chỉ đọc |
Có trong | Máy điều nhiệt đã đọc / v6 Máy điều nhiệt/đọc/ghi / v6 |
sun_Correct_active
Chặn trạng thái hoạt động của tính năng Sunblock. Đã sử dụng với
sunlight_correction_enabled
.
Khi true
, cho biết rằng máy điều nhiệt đang ở dưới ánh nắng trực tiếp.
Để biết thêm thông tin, hãy xemSunblock là gì?
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_active |
|
Trả lại hàng | boolean Giá trị: true, false |
Truy cập | Chỉ đọc |
Có trong | Máy điều nhiệt đã đọc / v6 Máy điều nhiệt/đọc/ghi / v6 |
nơi_tên
Tên hiển thị của thiết bị. Liên kết với máy điều nhiệt
where_id
. Có thể là bất kỳ tên phòng nào từ
danh sách mà chúng tôi cung cấp hoặc tên tùy chỉnh. Tìm hiểu thêm về vị trí của Nest Thermostat, Nest Protect và Nest Cam.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/where_name |
|
Trả lại hàng | string Ví dụ: "Hallway" |
Truy cập | Chỉ đọc |
Có trong | Máy điều nhiệt đã đọc / v6 Máy điều nhiệt/đọc/ghi / v6 |
quạt_timer_duration
Chỉ định khoảng thời gian (tính bằng phút) mà quạt được thiết lập để chạy.
Chế độ cài đặt fan_timer_active
sẽ
bật quạt. Giá trị fan_timer_timeout
cho biết dấu thời gian khi fan_timer_duration
được đặt kết thúc.
Để tìm hiểu cách khách hàng đặt bộ hẹn giờ quạt, hãy xem Thời lượng đồng hồ hẹn giờ.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_duration |
|
Trả lại hàng | int Giá trị: 15, 30, 45, 60, 120, 240, 480, 720 |
Truy cập | đọc/ghi |
Có trong | Đọc: Đọc máy điều nhiệt / phiên bản 6 Đọc/ghi / phiên bản 6 của máy điều nhiệt Viết: Đọc/ghi / phiên bản 6 của máy điều nhiệt |
time_to_target
Thời gian, tính bằng phút, mà sẽ mất để cấu trúc đạt đến nhiệt độ mục tiêu.
Xem Thời gian đến nhiệt độ để biết thêm thông tin.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target |
|
Trả lại hàng | string enum Giá trị: "~0", "<5", "~15", "~90", "120" |
Truy cập | Chỉ đọc |
Có trong | Máy điều nhiệt đã đọc / v6 Máy điều nhiệt/đọc/ghi / v6 |
đào tạo thời gian_nhắm mục tiêu
Khi ở chế độ huấn luyện, Nest Thermostat tìm hiểu về hệ thống HVAC và
phát hiện thời gian cần thiết để đạt tới nhiệt độ mục tiêu. Khi
Máy điều nhiệt có đủ thông tin để đưa ra ước tính hợp lý về thời gian cần đạt
nhiệt độ mục tiêu, giá trị này sẽ thay đổi từ training
thành ready
.
Xem Thời gian đến nhiệt độ để biết thêm thông tin.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target_training |
|
Trả lại hàng | string enum Giá trị: "training", "sẵn sàng" |
Truy cập | Chỉ đọc |
Có trong | Máy điều nhiệt đã đọc / v6 Máy điều nhiệt/đọc/ghi / v6 |
chế độ giờ trước
Hiển thị hvac_mode
được chọn gần đây nhất. Dùng khi
chuyển đổi từ hvac_mode
= eco
trên thiết bị có chương trình cơ sở đã lỗi thời.
Để tìm hiểu thêm về cách chuyển sang chế độ Tiết kiệm năng lượng và chế độ không sinh thái, hãy xem Hướng dẫn dành cho máy điều nhiệt.
Thông tin chi tiết | |
---|---|
https://developer-api.nest.com/devices/thermostats/device_id/previous_hvac_mode |
|
Trả lại hàng | string Giá trị: "hot", "cool", "heater-cool", "off", (không có giá trị) |
Truy cập | Chỉ đọc |
Có trong | Máy điều nhiệt đã đọc / v6 Máy điều nhiệt/đọc/ghi / v6 |