API termostat

Nest API berfungsi dengan semua model Nest Learning ThermostatTM, kecuali untuk Thermostat E dengan Heat Link di EU.

Pengguna dapat menambahkan beberapa Nest Thermostat ke grup devices/thermostats, hingga maksimum per struktur. Saat melakukan panggilan ke lokasi data ini, Anda dapat mengakses data Nest Thermostat (nilai data untuk perangkat dalam struktur).

Semua nilai di bawah ini ditemukan pada setiap devices/thermostats/device_id dalam dokumen JSON.

ID_perangkat

ID unik Nest Thermostat.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/device_id
Hasilstring
Contoh: "peyiJNo0IldT2YlIVtYaGQ"
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

locale

Menentukan preferensi bahasa dan wilayah (atau negara).

Detail
https://developer-api.nest.com/devices/thermostats/device_id/locale
Hasilstring
Contoh: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

versi_software

Versi software.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/software_version
Hasilstring
Misalnya: "4,0"
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

struktur_id

Menyusun ID unik.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/structure_id
Hasilstring
Contoh: "VqFabWH21nw..."
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

nama

Nama tampilan perangkat. Dapat berupa nama ruang apa pun dari daftar yang kami berikan, atau nama kustom.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/name
Hasilstring
Contoh: "Hallway"
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

nama_panjang

Nama tampilan panjang perangkat. Mencakup label (label) kustom, yang dibuat oleh pengguna, atau melalui wheres.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/name_long
Hasilstring
Misalnya: "Termostat Thermostat (uptairs)"
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

koneksi_terakhir

Stempel waktu interaksi terakhir yang berhasil dengan layanan Nest, dalam format ISO 8601.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/last_connection
Hasilstring
Contoh: "2016-12-31T23:59:59.000Z"
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

is_online [online]

Status koneksi perangkat dengan layanan Nest.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/is_online
Hasilboolean
Nilai: benar (true), salah (false)
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

bisa_keren

Kemampuan sistem untuk mendinginkan (memiliki AC).

Detail
https://developer-api.nest.com/devices/thermostats/device_id/can_cool
Hasilboolean
Nilai: benar (true), salah (false)
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

kalor_panas

Kemampuan sistem untuk menghangatkan.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/can_heat
Hasilboolean
Nilai: benar (true), salah (false)
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

menggunakan_emergency_heat

Status Hangat Darurat dalam sistem dengan pompa kalor untuk pendingin.

Saat Sistem Pemanas Darurat aktif:

  • Pengguna dapat menyesuaikan suhu target di perangkat, tetapi tidak dapat mengubah mode hingga Sistem Pemanas Darurat dinonaktifkan
  • hvac_mode masih dapat diubah melalui API

Lihat Apa itu Batas Darurat ? untuk informasi selengkapnya tentang cara Nest Thermostat mendukung Sistem Pemanas Darurat.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/is_using_emergency_heat
Hasilboolean
Nilai: benar (true), salah (false)
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

punya_penggemar

Kemampuan sistem untuk mengontrol kipas secara independen dari penghangat atau pendingin.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/has_fan
Hasilboolean
Nilai: benar (true), salah (false)
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

kipas_waktu_aktif

Menunjukkan apakah timer kipas berinteraksi; digunakan dengan fan_timer_duration untuk mengaktifkan kipas selama durasi preset yang ditentukan pengguna.

Baca bagian Kontrol Penggemar Lanjutan untuk mengetahui informasi lebih lanjut tentang cara pelanggan menetapkan durasi kipas.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_active
Hasilboolean
Nilai: benar (true), salah (false)
Aksesbaca/tulis
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

kipas_waktu_waktu_habis

Stempel waktu yang muncul saat timer kipas mencapai 0 (waktu berhenti), dalam format ISO 8601.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_timeout
Hasilstring
Contoh: "2016-12-31T23:59:59.000Z"
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

punya_daun

Ditampilkan saat termostat disetel ke suhu hemat energi.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/has_leaf
Hasilboolean
Nilai: benar (true), salah (false)
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

skala_suhu

Fahrenheit atau Celsius; digunakan dengan tampilan suhu.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/temperature_scale
Hasilstring enum
Nilai: "F", "C"
Aksesbaca/tulis
Tersedia diBaca:
Pembacaan termostat / v1-v6
Pembacaan/penulisan Thermostat / v1-v6
Tulis:
Pembacaan termostat/tulis / v5-v6

suhu_target_f

Suhu yang diinginkan, dalam derajat penuh Fahrenheit (1°F). Digunakan saat hvac_mode = heat atau cool.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_f
Hasilnumber
Contoh: 72
Rentang50-90
Aksesbaca/tulis
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

suhu_target_c

Suhu yang diinginkan, dalam setengah derajat Celsius (0,5°C). Digunakan saat hvac_mode = heat atau cool.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_c
Hasilnumber
Contoh: 21,5
Rentang9-32
Aksesbaca/tulis
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

suhu_target_tinggi_f

Suhu target maksimum, ditampilkan dalam derajat derajat penuh (1°F). Digunakan saat hvac_mode = heat-cool (Tingkatan •Mode dingin).

Detail
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_f
Hasilnumber
Contoh: 80
Aksesbaca/tulis
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

suhu_target_tinggi_c

Suhu target maksimum, ditampilkan dalam setengah derajat Celsius (0,5°C). Digunakan saat hvac_mode = heat-cool (Heat•Mode dingin).

Detail
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_high_c
Hasilnumber
Contoh: 24,5
Aksesbaca/tulis
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

target_temperature_low_f

Suhu target minimum, yang ditampilkan dalam derajat derajat Fahrenheit (1°F). Digunakan saat hvac_mode = heat-cool (Tingkatan •Mode dingin).

Detail
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_f
Hasilnumber
Contoh: 65
Aksesbaca/tulis
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

suhu_target_rendah_c

Suhu target minimum, ditampilkan dalam setengah derajat Celsius (0,5°C). Digunakan saat hvac_mode = heat-cool (Heat•Mode dingin).

Detail
https://developer-api.nest.com/devices/thermostats/device_id/target_temperature_low_c
Hasilnumber
Misalnya: 19,5
Aksesbaca/tulis
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

eco_temperature_high_f

Suhu Hemat Energi Maksimum, ditampilkan dalam derajat derajat penuh (1°F). Digunakan saat hvac_mode = eco.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_f
Hasilnumber
Contoh: 80
Akseshanya baca
Tersedia diPembacaan termostat / v6
Pembacaan/penulisan / v6 termostat

eco_temperature_high_c

Suhu Hemat Energi Maksimum, ditampilkan dalam setengah derajat Celsius (0,5°C). Digunakan saat hvac_mode = eco.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_c
Hasilnumber
Contoh: 24,5
Akseshanya baca
Tersedia diPembacaan termostat / v6
Pembacaan/penulisan / v6 termostat

eco_temperature_low_f

Suhu Hemat Energi Minimum, yang ditampilkan dalam derajat derajat penuh (1°F). Digunakan saat hvac_mode = eco.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_f
Hasilnumber
Contoh: 65
Akseshanya baca
Tersedia diPembacaan termostat / v6
Pembacaan/penulisan / v6 termostat

eco_temperature_low_c

Suhu Hemat Energi Minimum, ditampilkan dalam setengah derajat Celsius (0,5°C). Digunakan saat hvac_mode = eco.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_c
Hasilnumber
Misalnya: 19,5
Akseshanya baca
Tersedia diPembacaan termostat / v6
Pembacaan/penulisan / v6 termostat

perbarui_temperature_high_f (TIDAK DIGUNAKAN LAGI)

Suhu maksimum maksimum, yang ditampilkan dalam derajat derajat penuh (1°F).

Detail
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_f
Hasilnumber
Contoh: 80
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

perbarui_temperature_high_c (TIDAK DIGUNAKAN LAGI)

Suhu pergi maksimum, ditampilkan dalam setengah derajat Celsius (0,5 °C).

Detail
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_high_c
Hasilnumber
Contoh: 24,5
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

perbarui_temperature_low_f (TIDAK DIGUNAKAN LAGI)

Suhu minimum minimum, yang ditampilkan dalam derajat derajat penuh (1°F).

Detail
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_f
Hasilnumber
Contoh: 65
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

perbarui_temperature_low_c (TIDAK DIGUNAKAN LAGI)

Suhu minimum minimum, ditampilkan dalam setengah derajat Celsius (0,5°C).

Detail
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_c
Hasilnumber
Misalnya: 19,5
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

mode_hvac

Menunjukkan mode penghangat/penyejuk sistem HVAC, seperti Heat•Cool untuk sistem dengan kapasitas penghangat dan pendingin, atau Suhu Hemat Energi untuk penghematan energi.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode
Hasilstring enum
Nilai: "heat", "cool", "heat-cool", "eco", "off"
Aksesbaca/tulis
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

suhu_sunyi_f

Suhu, diukur pada perangkat, dalam derajat derajat penuh (1°F).

Detail
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_f
Hasilnumber
Contoh: 72
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

suhu_suhu_c

Suhu, diukur pada perangkat, dalam setengah derajat Celsius (0,5°C).

Detail
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_c
Hasilnumber
Contoh: 21,5
Akseshanya baca
Tersedia diPembacaan termostat / v1-v6
Pembacaan/penulisan termostat / v1-v6

kelembapan

Kelembapan, dalam persen (%) format, yang diukur di perangkat, dibulatkan ke 5% terdekat.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/humidity
Hasilnumber
Contoh: 35
Rentang0-100
Akseshanya baca
Tersedia diPembacaan termostat / v2-v6
Pembacaan/penulisan / pemutaran termostat v2-v6

hvac_state

Menunjukkan apakah sistem HVAC aktif menghangatkan, menyejukkan, atau nonaktif. Gunakan nilai ini untuk menunjukkan status aktivitas HVAC.

Saat off, sistem HVAC tidak menghangatkan atau menyejukkan secara aktif. hvac_state tidak bergantung pada operasi kipas.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/hvac_state
Hasilstring enum
Nilai: "pemanasan", "sejuk", "nonaktif"
Akseshanya baca
Tersedia diTermostat baca / v3-v6
Pembacaan/penulisan termostat / v3-v6

id_mana

ID unik yang dibuat Nest yang mewakili name, nama tampilan perangkat.

Pelajari lebih lanjut tempat nama untuk Nest Thermostat, Nest Protect, dan Nest Cam.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/where_id
Hasilstring
Contoh: "d6reb_OZTM..."
Akseshanya baca
Tersedia diPembacaan termostat / v4-v6
Pembacaan/penulisan / pemerolehan v4-v6

_dikunci

Status Kunci Termostat. Jika benar, fitur Kunci Termostat akan diaktifkan, dan membatasi rentang suhu ke nilai minimum/maksimum ini: locked_temp_min_f, locked_temp_max_f, locked_temp_min_c, dan locked_temp_max_c.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/is_locked
Hasilboolean
Nilai: benar (true), salah (false)
Akseshanya baca
Tersedia diPembacaan termostat / v5-v6
Pembacaan/penulisan termostat / v5-v6

smart_temp_min_f terkunci

Suhu minimum Kunci Termostat, yang ditampilkan dalam derajat derajat penuh (1°F). Digunakan saat is_locked adalah true.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_f
Hasilstring
Contoh: 65
Akseshanya baca
Tersedia diPembacaan termostat / v5-v6
Pembacaan/penulisan termostat / v5-v6

terkunci_temp_max_f

Suhu maksimum Kunci Termostat, yang ditampilkan dalam derajat derajat penuh (1°F). Digunakan saat is_locked adalah true.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_f
Hasilstring
Contoh: 80
Akseshanya baca
Tersedia diPembacaan termostat / v5-v6
Pembacaan/penulisan termostat / v5-v6

terkunci_temp_min_c

Suhu minimum Kunci Termostat, yang ditampilkan dalam suhu setengah derajat Celsius (0,5°C). Digunakan saat is_locked adalah true.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_min_c
Hasilstring
Misalnya: 19,5
Akseshanya baca
Tersedia diPembacaan termostat / v5-v6
Pembacaan/penulisan termostat / v5-v6

terkunci_temp_max_c

Suhu maksimum Kunci Termostat, ditampilkan dalam tampilan setengah setengah Celsius (0,5°C). Digunakan saat is_locked adalah true.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/locked_temp_max_c
Hasilstring
Contoh: 24,5
Akseshanya baca
Tersedia diPembacaan termostat / v5-v6
Pembacaan/penulisan termostat / v5-v6

label

Label kustom termostat. Muncul dalam tanda kurung, setelah nama tempat.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/label
Hasilstring
Contoh: "Ruang atas", "Ruang tamu", "Ruang bermain"
Aksesbaca/tulis
Tersedia diBaca:
Termostat baca / v6
Baca/tulis Termostat / v6
Tulis:
Baca/tulis Termostat / v5 -v6

sunlight_Koreksi_diaktifkan

Status Sunblock aktif. Digunakan dengan sunlight_correction_active. Saat true, teknologi Sunblock diaktifkan, dan Termostat otomatis menyesuaikan cahaya matahari langsung, dengan membaca dan menyetel suhu yang tepat.

Untuk mengetahui informasi selengkapnya, lihat Apa Sunblock?

Detail
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_enabled
Hasilboolean
Nilai: benar (true), salah (false)
Akseshanya baca
Tersedia diPembacaan termostat / v6
Pembacaan/penulisan / v6 termostat

sunlight_Koreksi_aktif

Status aktif pemblokiran matahari. Digunakan dengan sunlight_correction_enabled. Jika true, menunjukkan bahwa Termostat terletak di bawah sinar matahari langsung.

Untuk mengetahui informasi selengkapnya, lihat Apa Sunblock?

Detail
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_active
Hasilboolean
Nilai: benar (true), salah (false)
Akseshanya baca
Tersedia diPembacaan termostat / v6
Pembacaan/penulisan / v6 termostat

dengan_nama

Nama tampilan perangkat. Ditautkan dengan Termostat where_id. Dapat berupa nama ruangan apa pun dari daftar yang kami berikan, atau nama kustom. Pelajari lebih lanjut tempat nama untuk Nest Thermostat, Nest Protect, dan Nest Cam.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/where_name
Hasilstring
Contoh: "Hallway"
Akseshanya baca
Tersedia diPembacaan termostat / v6
Pembacaan/penulisan / v6 termostat

fan_time__duration

Menentukan durasi (dalam menit) saat kipas disetel untuk berjalan.

Setelan fan_timer_active akan mengaktifkan kipas. Nilai fan_timer_timeout menunjukkan stempel waktu saat fan_timer_duration ditetapkan ke akhir.

Untuk mempelajari cara pelanggan menyetel timer kipas, lihat Durasi Timer.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_duration
Hasilint
Nilai: 15, 30, 45, 60, 120, 240, 480, 720
Aksesbaca/tulis
Tersedia diBaca:
Termostat baca / v6
Baca/tulis Termostat / v6
Tulis:
Baca/tulis Termostat / v6

waktu_untuk_target

Waktu, dalam menit, yang diperlukan sampai struktur mencapai suhu target.

Lihat Waktu ke Suhu untuk informasi selengkapnya.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target
Hasilstring enum
Nilai: "~0", "<5", "~15", "~90", "120"
Akseshanya baca
Tersedia diPembacaan termostat / v6
Pembacaan/penulisan / v6 termostat

waktu_untuk_target_pelatihan

Saat dalam mode pelatihan, Nest Thermostat mempelajari sistem HVAC dan menemukan waktu yang diperlukan untuk mencapai suhu target. Jika Termostat memiliki informasi yang cukup untuk membuat perkiraan waktu yang wajar untuk mencapai suhu target, nilai ini akan berubah dari training menjadi ready.

Lihat Waktu ke Suhu untuk informasi selengkapnya.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target_training
Hasilstring enum
Nilai: "pelatihan", "siap"
Akseshanya baca
Tersedia diPembacaan termostat / v6
Pembacaan/penulisan / v6 termostat

mode_hvac_sebelumnya

Menampilkan hvac_mode yang dipilih terakhir. Digunakan saat beralih dari hvac_mode = eco di perangkat dengan firmware yang sudah tidak berlaku.

Untuk mempelajari lebih lanjut cara beralih antara mode Hemat Energi dan non-Eco, lihat Panduan Termostat.

Detail
https://developer-api.nest.com/devices/thermostats/device_id/previous_hvac_mode
Hasilstring
Nilai: "heat", "cool", "heat-cool", "off", kosong (tidak ada nilai)
Akseshanya baca
Tersedia diPembacaan termostat / v6
Pembacaan/penulisan / v6 termostat