API termostat

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

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

Semua di bawah nilai-nilai yang ditemukan di bawah masing-masing devices/thermostats/ device_id dalam dokumen JSON.

device_id

Pengenal unik Nest Thermostat.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
Kembali	string Contoh: "peyiJNo0IldT2YlIVtYaGQ"
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

lokal

Menentukan preferensi bahasa dan wilayah (atau negara).

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /locale
Kembali	string Contoh: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

versi perangkat lunak

Versi perangkat lunak.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
Kembali	string Contoh: "4.0"
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

struktur_id

Struktur pengidentifikasi unik.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
Kembali	string Contoh: "VqFabWH21nw..."
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

nama

Nama tampilan perangkat. Bisa nama kamar apa saja dari daftar yang kami sediakan, atau nama khusus.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /name
Kembali	string Contoh: "lorong"
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

nama_panjang

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

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
Kembali	string Contoh: "Termostat Lorong (lantai atas)"
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

terakhir_koneksi

Timestamp dari interaksi yang sukses terakhir dengan layanan Nest, di ISO 8601 Format.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
Kembali	string Contoh: "2016-12-31T23:59:59.000Z"
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

sedang on line

Status koneksi perangkat dengan layanan Nest.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
Kembali	boolean Nilai: benar, salah
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

bisa_keren

Kemampuan sistem untuk mendinginkan (memiliki AC).

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
Kembali	boolean Nilai: benar, salah
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

bisa_panas

Kemampuan sistem untuk memanaskan.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
Kembali	boolean Nilai: benar, salah
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

is_using_emergency_heat

Status Panas Darurat dalam sistem dengan pompa panas untuk pendinginan.

Saat Pemanas Darurat menyala:

• Pengguna dapat menyesuaikan suhu target pada perangkat, tetapi tidak dapat mengubah mode sampai Panas Darurat dimatikan
• The hvac_mode masih bisa diubah melalui API

Lihat Apa Panas Darurat? untuk informasi lebih lanjut tentang bagaimana Nest Thermostat mendukung Pemanasan Darurat.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
Kembali	boolean Nilai: benar, salah
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

has_fan

Kemampuan sistem untuk mengontrol kipas secara independen dari pemanasan atau pendinginan.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
Kembali	boolean Nilai: benar, salah
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

fan_timer_aktif

Menunjukkan jika pengatur waktu kipas diaktifkan; digunakan dengan fan_timer_duration untuk menghidupkan kipas untuk durasi yang telah ditetapkan (ditentukan pengguna).

Lihat lanjutan Fan Control untuk informasi lebih lanjut tentang bagaimana pelanggan mengatur durasi penggemar.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
Kembali	boolean Nilai: benar, salah
Mengakses	Baca tulis
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

fan_timer_timeout

Timestamp menampilkan saat kipas timer mencapai 0 (berhenti waktu), di ISO 8601 Format.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
Kembali	string Contoh: "2016-12-31T23:59:59.000Z"
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

has_leaf

Ditampilkan saat termostat diatur ke suhu hemat energi.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
Kembali	boolean Nilai: benar, salah
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

suhu_skala

Fahrenheit atau Celcius; digunakan dengan tampilan suhu.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
Kembali	string enum Nilai: "F", "C"
Mengakses	Baca tulis
Tersedia di	Baca baca: Baca termostat / v1-v6 Baca/tulis termostat / v1-v6 Menulis: Baca/tulis termostat / v5-v6

target_temperature_f

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

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
Kembali	number Contoh: 72
Jarak	50-90
Mengakses	Baca tulis
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

target_temperature_c

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

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
Kembali	number Contoh: 21.5
Jarak	9-32
Mengakses	Baca tulis
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

target_temperature_high_f

Suhu target maksimum, ditampilkan dalam seluruh derajat Fahrenheit (1°F). Digunakan ketika hvac_mode = heat-cool (Panas • modus Keren).

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
Kembali	number Contoh: 80
Mengakses	Baca tulis
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

target_temperature_high_c

Suhu target maksimum, ditampilkan dalam setengah derajat Celcius (0,5°C). Digunakan ketika hvac_mode = heat-cool (Panas • modus Keren).

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
Kembali	number Contoh: 24.5
Mengakses	Baca tulis
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

target_temperature_low_f

Suhu target minimum, ditampilkan dalam seluruh derajat Fahrenheit (1°F). Digunakan ketika hvac_mode = heat-cool (Panas • modus Keren).

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
Kembali	number Contoh: 65
Mengakses	Baca tulis
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

target_temperature_low_c

Suhu target minimum, ditampilkan dalam setengah derajat Celcius (0,5°C). Digunakan ketika hvac_mode = heat-cool (Panas • modus Keren).

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
Kembali	number Contoh: 19.5
Mengakses	Baca tulis
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

eco_temperature_high_f

Suhu Ramah Lingkungan Maksimum, ditampilkan dalam seluruh derajat Fahrenheit (1°F). Digunakan ketika hvac_mode = eco .

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
Kembali	number Contoh: 80
Mengakses	hanya baca
Tersedia di	Baca termostat / v6 Baca/tulis termostat / v6

eco_temperature_high_c

Suhu Eco Maksimum, ditampilkan dalam setengah derajat Celcius (0,5°C). Digunakan ketika hvac_mode = eco .

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_c
Kembali	number Contoh: 24.5
Mengakses	hanya baca
Tersedia di	Baca termostat / v6 Baca/tulis termostat / v6

eco_temperature_low_f

Suhu Ramah Lingkungan Minimum, ditampilkan dalam seluruh derajat Fahrenheit (1°F). Digunakan ketika hvac_mode = eco .

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
Kembali	number Contoh: 65
Mengakses	hanya baca
Tersedia di	Baca termostat / v6 Baca/tulis termostat / v6

eco_temperature_low_c

Suhu Ramah Lingkungan Minimum, ditampilkan dalam setengah derajat Celcius (0,5°C). Digunakan ketika hvac_mode = eco .

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_c
Kembali	number Contoh: 19.5
Mengakses	hanya baca
Tersedia di	Baca termostat / v6 Baca/tulis termostat / v6

away_temperature_high_f (DIHAPUS)

Suhu jauh maksimum, ditampilkan dalam seluruh derajat Fahrenheit (1°F).

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
Kembali	number Contoh: 80
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

away_temperature_high_c (DIHAPUS)

Suhu jauh maksimum, ditampilkan dalam setengah derajat Celcius (0,5°C).

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
Kembali	number Contoh: 24.5
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

away_temperature_low_f (DIHAPUS)

Suhu jauh minimum, ditampilkan dalam seluruh derajat Fahrenheit (1°F).

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
Kembali	number Contoh: 65
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

away_temperature_low_c (DIHAPUS)

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

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
Kembali	number Contoh: 19.5
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

hvac_mode

Menunjukkan mode pemanasan/pendinginan sistem HVAC, seperti Heat•Cool untuk sistem dengan kapasitas pemanasan dan pendinginan, atau Eco Temperatures untuk penghematan energi.

• hvac_mode dapat diubah jika Thermostat yang terkunci
• target_temperature_f dan target_temperature_c tidak dapat diubah jika hvac_mode = off atau eco

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
Kembali	string enum Nilai: "panas", "dingin", "panas-dingin", "eko", "mati"
Mengakses	Baca tulis
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

ambient_temperature_f

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

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
Kembali	number Contoh: 72
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

ambient_temperature_c

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

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
Kembali	number Contoh: 21.5
Mengakses	hanya baca
Tersedia di	Baca termostat / v1-v6 Baca/tulis termostat / v1-v6

kelembaban

Kelembaban, dalam format persen (%), diukur pada perangkat, dibulatkan ke 5% terdekat.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
Kembali	number Contoh: 35
Jarak	0-100
Mengakses	hanya baca
Tersedia di	Baca termostat / v2-v6 Baca/tulis termostat / v2-v6

hvac_state

Menunjukkan apakah sistem HVAC aktif memanaskan, mendinginkan, atau mati. Gunakan nilai ini untuk menunjukkan status aktivitas HVAC.

Ketika off , sistem HVAC tidak aktif pemanasan atau pendinginan. hvac_state independen dari operasi fan.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
Kembali	string enum Nilai: "pemanasan", "pendinginan", "mati"
Mengakses	hanya baca
Tersedia di	Baca termostat / v3-v6 Baca/tulis termostat / v3-v6

dimana_id

Yang unik,-Nest dihasilkan identifier yang mewakili name , nama tampilan perangkat.

Pelajari lebih lanjut tentang di mana nama untuk Termostat Nest ,Nest Melindungi dan Nest Cams .

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
Kembali	string Contoh: "d6reb_OZTM..."
Mengakses	hanya baca
Tersedia di	Baca termostat / v4-v6 Baca/tulis termostat / v4-v6

terkunci

Status Kunci Termostat. Ketika benar, Thermostat Lock fitur diaktifkan, dan membatasi kisaran suhu untuk min / max nilai-nilai ini: locked_temp_min_f , locked_temp_max_f , locked_temp_min_c , dan locked_temp_max_c .

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
Kembali	boolean Nilai: benar, salah
Mengakses	hanya baca
Tersedia di	Baca termostat / v5-v6 Baca/tulis termostat / v5-v6

terkunci_temp_min_f

Minimum Thermostat Lock suhu, ditampilkan secara keseluruhan derajat Fahrenheit (1 ° F). Digunakan ketika is_locked adalah true .

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
Kembali	string Contoh: 65
Mengakses	hanya baca
Tersedia di	Baca termostat / v5-v6 Baca/tulis termostat / v5-v6

terkunci_temp_max_f

Maksimum Thermostat Lock suhu, ditampilkan secara keseluruhan derajat Fahrenheit (1 ° F). Digunakan ketika is_locked adalah true .

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
Kembali	string Contoh: 80
Mengakses	hanya baca
Tersedia di	Baca termostat / v5-v6 Baca/tulis termostat / v5-v6

terkunci_temp_min_c

Minimum Thermostat Lock suhu, ditampilkan dalam ditampilkan dalam derajat setengah Celsius (0,5 ° C). Digunakan ketika is_locked adalah true .

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_c
Kembali	string Contoh: 19.5
Mengakses	hanya baca
Tersedia di	Baca termostat / v5-v6 Baca/tulis termostat / v5-v6

terkunci_temp_max_c

Maksimum Thermostat Lock suhu, ditampilkan dalam ditampilkan dalam derajat setengah Celsius (0,5 ° C). Digunakan ketika is_locked adalah true .

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_c
Kembali	string Contoh: 24.5
Mengakses	hanya baca
Tersedia di	Baca termostat / v5-v6 Baca/tulis termostat / v5-v6

label

Thermostat label kustom . Muncul dalam tanda kurung, setelah nama where.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /label
Kembali	string Contoh: "Lantai atas", "Ruang tamu", "Ruang Bermain"
Mengakses	Baca tulis
Tersedia di	Baca baca: Baca termostat / v6 Baca/tulis termostat / v6 Menulis: Baca/tulis termostat / v5-v6

sinar matahari_koreksi_diaktifkan

Status blokir tabir surya diaktifkan. Digunakan dengan sunlight_correction_active . Ketika true , teknologi Sunblock diaktifkan, dan Thermostat secara otomatis menyesuaikan diri dengan sinar matahari langsung, membaca dan pengaturan suhu yang benar.

Untuk info lebih lanjut, lihat Apa Sunblock?

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
Kembali	boolean Nilai: benar, salah
Mengakses	hanya baca
Tersedia di	Baca termostat / v6 Baca/tulis termostat / v6

sinar matahari_koreksi_aktif

Status aktif tabir surya. Digunakan dengan sunlight_correction_enabled . Ketika true , menunjukkan bahwa Thermostat terletak di sinar matahari langsung.

Untuk info lebih lanjut, lihat Apa Sunblock?

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
Kembali	boolean Nilai: benar, salah
Mengakses	hanya baca
Tersedia di	Baca termostat / v6 Baca/tulis termostat / v6

dimana_nama

Nama tampilan perangkat. Terkait dengan Thermostat where_id . Bisa nama kamar apa saja dari daftar yang kami sediakan, atau nama khusus. Pelajari lebih lanjut tentang di mana nama untuk Termostat Nest ,Nest Melindungi dan Nest Cams .

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
Kembali	string Contoh: "lorong"
Mengakses	hanya baca
Tersedia di	Baca termostat / v6 Baca/tulis termostat / v6

fan_timer_duration

Menentukan lama waktu (dalam menit) kipas diatur untuk bekerja.

The fan_timer_active pengaturan mengaktifkan kipas. The fan_timer_timeout nilai menunjukkan timestamp ketika fan_timer_duration diatur sampai akhir.

Untuk mempelajari bagaimana pelanggan mengatur kipas timer, lihat Timer Durasi .

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
Kembali	int Nilai: 15, 30, 45, 60, 120, 240, 480, 720
Mengakses	Baca tulis
Tersedia di	Baca baca: Baca termostat / v6 Baca/tulis termostat / v6 Menulis: Baca/tulis termostat / v6

waktu_ke_target

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

Lihat Time-to-Suhu untuk informasi lebih lanjut.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
Kembali	string enum Nilai: "~0", "<5", "~15", "~90", "120"
Mengakses	hanya baca
Tersedia di	Baca termostat / v6 Baca/tulis termostat / v6

waktu_ke_target_pelatihan

Saat dalam mode pelatihan, Nest Thermostat mempelajari sistem HVAC dan mengetahui berapa lama waktu yang diperlukan untuk mencapai suhu target. Ketika Thermostat memiliki informasi yang cukup untuk membuat perkiraan yang wajar dari waktu untuk mencapai target suhu, nilai ini akan berubah dari training ke ready .

Lihat Time-to-Suhu untuk informasi lebih lanjut.

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
Kembali	string enum Nilai: "pelatihan", "siap"
Mengakses	hanya baca
Tersedia di	Baca termostat / v6 Baca/tulis termostat / v6

sebelumnya_hvac_mode

Menampilkan terakhir yang dipilih hvac_mode . Digunakan ketika beralih dari hvac_mode = eco pada perangkat dengan firmware usang.

Untuk mempelajari lebih lanjut tentang beralih betwen Eco dan mode non-Eco, lihat Thermostat Panduan .

rincian
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
Kembali	string Nilai: "panas", "dingin", "panas-dingin", "mati", kosong (tidak ada nilai)
Mengakses	hanya baca
Tersedia di	Baca termostat / v6 Baca/tulis termostat / v6