Camera API

Nest API berfungsi dengan semua model Nest CamTM.

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

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

id_perangkat

ID unik Nest Cam.

Detail
https://developer-api.nest.com/devices/cameras/device_id/device_id
Menampilkanstring
Contoh: "awJo6rH..."
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

software_version

Versi software.

Detail
https://developer-api.nest.com/devices/cameras/device_id/software_version
Menampilkanstring
Contoh: "4.0"
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

id_struktur

Membuat ID unik.

Detail
https://developer-api.nest.com/devices/cameras/device_id/structure_id
Menampilkanstring
Contoh: "VqFabWH21nw..."
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

di mana_id

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

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

Detail
https://developer-api.nest.com/devices/cameras/device_id/where_id
Menampilkanstring
Contoh: "d6reb_OZTM..."
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

nama_di mana

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

Detail
https://developer-api.nest.com/devices/cameras/device_id/where_name
Menampilkanstring
Contoh: "Hallway"
Akseshanya baca
Tersedia diKamera baca / v3
Baca kamera + gambar / v4
Baca kamera/tulis / v3
Kamera baca/tulis + gambar / v4

nama

Nama tampilan perangkat; dapat berupa nama ruangan apa pun dari daftar yang kami berikan, atau nama kustom.

Detail
https://developer-api.nest.com/devices/cameras/device_id/name
Menampilkanstring
Contoh: "Hallway"
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

nama_panjang

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

Detail
https://developer-api.nest.com/devices/cameras/device_id/name_long
Menampilkanstring
Contoh: "Hallway Nest Cam (lantai atas)"
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

is_online [online_is]

Status koneksi perangkat dengan layanan Nest.

Detail
https://developer-api.nest.com/devices/cameras/device_id/is_online
Menampilkanboolean
Nilai: benar, salah
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

is_streaming

Status kamera, baik aktif maupun tidak aktif melakukan streaming video, atau nonaktif. Lihat Cara kerja kamera dengan Bantuan Mode Di Rumah/Pergi untuk informasi selengkapnya.

Detail
https://developer-api.nest.com/devices/cameras/device_id/is_streaming
Menampilkanboolean
Nilai: benar, salah
Aksesbaca/tulis
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

is_audio_input_enabled

Status mikrofon kamera, baik aktif maupun tidak, atau nonaktif. Pelajari lebih lanjut setelan audio Nest Cam.

Detail
https://developer-api.nest.com/devices/cameras/device_id/is_audio_input_enabled
Menampilkanboolean
Nilai: benar, salah
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

last_is_online_change [perubahan_online_terakhir]

Stempel waktu yang mengidentifikasi perubahan terakhir pada status online, dalam format ISO 8601.

Detail
https://developer-api.nest.com/devices/cameras/device_id/last_is_online_change
Menampilkanstring
Contoh: "2016-12-29T18:42:00.000Z"
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

is_video_history_enabled

Status langganan Nest Aware (langganan aktif atau tidak).

Detail
https://developer-api.nest.com/devices/cameras/device_id/is_video_history_enabled
Menampilkanboolean
Nilai: benar, salah
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

url_web

URL web (deep link) ke streaming video live di home.nest.com.

Detail
https://developer-api.nest.com/devices/cameras/device_id/web_url
Menampilkanstring
Contoh: "https://home.nest.com/cameras/device_id?auth=camera_token"
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

url_aplikasi

URL aplikasi (deep link) ke streaming video live di aplikasi Nest.

Detail
https://developer-api.nest.com/devices/cameras/device_id/app_url
Menampilkanstring
Contoh: "nestmobile://cameras/device_id?auth=camera_token"
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

is_public_share_enabled

Pengguna dapat memilih untuk membagikan videonya dan membuatnya dapat dilihat oleh siapa saja. Ketika berbagi publik diaktifkan, Anda dapat membaca public_share_url.

Detail
https://developer-api.nest.com/devices/cameras/device_id/is_public_share_enabled
Menampilkanboolean
Nilai: benar, salah
Akseshanya baca
Tersedia diKamera membaca + gambar / v3-v4
Kamera baca/tulis + gambar / v3-v4

aktivitas_zona

Menampilkan array semua Zona Aktivitas yang ditentukan.

Zona Aktivitas digunakan untuk memantau peristiwa gerakan dalam area streaming video yang ditentukan pengguna. Memerlukan Nest Aware.

Detail
https://developer-api.nest.com/devices/cameras/device_id/activity_zones
Menampilkanarray
Contoh: [ {"name" : "string1", "id" : "string2"},... ]

string1 adalah nama zona, baik yang ditentukan pengguna maupun yang dihasilkan secara otomatis saat zona dibuat.
string2 adalah ID yang ditetapkan oleh Nest saat Zona Aktivitas dibuat.
Akseshanya baca
Tersedia diKamera membaca + gambar / v3-v4
Kamera baca/tulis + gambar / v3-v4

url_bagikan_publik

Anda dapat mengakses URL ini saat pengguna membuat streaming streaming video menjadi publik.

Detail
https://developer-api.nest.com/devices/cameras/device_id/public_share_url
Menampilkanstring
Contoh: "https://video.nest.com/live/string1?string2"

string1 adalah nama streaming video, baik yang ditentukan pengguna maupun yang dibuat otomatis saat streaming disetel ke publik.
Akseshanya baca
Tersedia diKamera membaca + gambar / v3-v4
Kamera baca/tulis + gambar / v3-v4

url_snapshot

Ambil gambar sesuai permintaan. Menampilkan URL gambar yang diambil dari streaming video live. Kamera harus aktif dan melakukan streaming secara aktif.

Gunakan kolom ini untuk mendapatkan ringkasan dari streaming video live.

  • snapshot_url - menampilkan URL gambar yang diambil dari streaming video live
  • Mengharuskan kamera aktif dan melakukan streaming secara aktif

Kualitas snapshot dari API hanya throughput 1080p jika Anda:

  • melihat streaming kamera secara aktif dalam aplikasi (web_url)
  • melihat streaming publik secara aktif (app_url)
  • berlangganan Nest Aware

Jika Anda tidak aktif melihat streaming atau tidak memiliki langganan Nest Aware, API tidak memiliki sumber 1080p untuk mengambil snapshot pada resolusi tersebut dan menghasilkan gambar berkualitas lebih rendah. Selain itu, bandwidth jaringan lokal yang rendah dapat menyebabkan resolusi snapshot API turun di bawah 1080p dengan adanya Nest Aware.

Pelajari persyaratan bandwidth untuk Kamera Nest lebih lanjut.

Batas kapasitas berlaku untuk panggilan ini, bergantung pada status langganan Nest Aware.

Detail
https://developer-api.nest.com/devices/cameras/device_id/snapshot_url
Menampilkanstring
Contoh: "string1/device_id/string2?auth=camera_token"
Akseshanya baca
Tersedia diKamera membaca + gambar / v3-v4
Kamera baca/tulis + gambar / v3-v4

peristiwa_terakhir

Objek ini menangkap informasi tentang peristiwa terakhir yang memicu notifikasi.

Beberapa kolom dan beberapa kombinasi izin memerlukan langganan Nest Aware untuk mengakses informasi peristiwa terakhir.

Semua nilai di bawah ini ditemukan dalam setiap devices/cameras/device_id/last_event di dokumen JSON.

memiliki_suara

Peristiwa suara - suara terdeteksi.

Detail
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_sound
Menampilkanboolean
Nilai: benar, salah
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

has_motion

Peristiwa gerakan - gerakan terdeteksi.

Detail
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_motion
Menampilkanboolean
Nilai: benar, salah
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

has_person [nama_orang]

Peristiwa orang - orang terdeteksi.

Detail
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_person
Menampilkanboolean
Nilai: benar, salah
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

start_time

Waktu mulai acara, dalam format ISO 8601.

Detail
https://developer-api.nest.com/devices/cameras/device_id/last_event/start_time
Menampilkanstring
Contoh: "2016-12-29T00:00:00.000Z"
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

end_time

Waktu berakhir acara, dalam format ISO 8601.

Detail
https://developer-api.nest.com/devices/cameras/device_id/last_event/end_time
Menampilkanstring
Contoh: "2016-12-29T00:00:00.000Z"
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

url_expire_time

Stempel waktu, dalam format ISO 8601, yang mengidentifikasi berakhirnya URL terkait peristiwa ini:

Waktu habis masa berlaku dihitung sebagai: last_event/start_time + n hari (dengan n = 10 atau 30 hari, bergantung pada paket langganan Nest Aware).

Memerlukan Nest Aware.

Detail
https://developer-api.nest.com/devices/cameras/device_id/last_event/urls_expire_time
Menampilkanstring
Contoh: "2016-12-29T00:00:00.000Z"
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

url_web

URL web (deep link) ke peristiwa suara atau gerakan terakhir di home.nest.com. Digunakan untuk menampilkan peristiwa terakhir yang direkam, dan mengharuskan pengguna login ke akun.

Memerlukan Nest Aware. Jika URL peristiwa telah habis masa berlakunya atau perangkat tidak memiliki langganan aktif, nilai ini tidak akan disertakan dalam payload.

Lihat last_event/urls_expire_time untuk mengetahui informasi tentang waktu habis masa berlaku URL ini.

Detail
https://developer-api.nest.com/devices/cameras/device_id/last_event/web_url
Menampilkanstring
Contoh: "https://home.nest.com/cameras/device_id/cuepoints/string?auth=camera_token"
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

url_aplikasi

URL aplikasi Nest (deep link) ke peristiwa gerakan atau suara terakhir. Digunakan untuk menampilkan peristiwa yang terakhir dicatat, dan mengharuskan pengguna untuk login ke akun.

Memerlukan Nest Aware. Jika URL peristiwa telah habis masa berlakunya atau perangkat tidak memiliki langganan aktif, nilai ini tidak akan disertakan dalam payload.

Lihat last_event/urls_expire_time untuk mengetahui informasi tentang waktu habis masa berlaku URL ini.

Detail
https://developer-api.nest.com/devices/cameras/device_id/last_event/app_url
Menampilkanstring
Contoh: "nestmobile://cameras/device_id/cuepoints/string?auth=camera_token"
Akseshanya baca
Tersedia diKamera baca / v1-v3
Kamera dibaca + gambar / v1-v4
Kamera baca/tulis / v1-v3
Baca/tulis kamera + gambar / v1-v4

url_gambar

URL (link) ke file gambar yang diambil untuk peristiwa suara atau gerakan.

Memerlukan Nest Aware. Lihat last_event/urls_expire_time untuk mengetahui informasi tentang waktu habis masa berlaku URL ini.

Detail
https://developer-api.nest.com/devices/cameras/device_id/last_event/image_url
Menampilkanstring
Contoh: "https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token"
Akseshanya baca
Tersedia diKamera baca + gambar / v1-v4
Kamera baca/tulis + gambar / v1-v4

animasi_image_url

URL (link) ke file gif yang ditangkap untuk peristiwa suara atau gerakan.

Memerlukan Nest Aware.

Detail
https://developer-api.nest.com/devices/cameras/device_id/last_event/animated_image_url
Menampilkanstring
Contoh: "https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token"
Akseshanya baca
Tersedia diKamera baca + gambar / v1-v4
Kamera baca/tulis + gambar / v1-v4

id_zona_aktivitas

ID untuk Zona Aktivitas yang mendeteksi peristiwa gerakan.

Memerlukan Nest Aware. Jika digunakan dengan array activity_zones, Anda bisa mendapatkan nama zona dari ID ini.

Jika last_event/has_motion adalah

  • true = menampilkan ID zona aktivitas yang mendeteksi peristiwa gerakan
  • false = menampilkan array kosong
Detail
https://developer-api.nest.com/devices/cameras/device_id/last_event/activity_zone_ids
Menampilkanarray
Contoh: [ string1, string2,... ]
Akseshanya baca
Tersedia diKamera membaca + gambar / v3-v4
Kamera baca/tulis + gambar / v3-v4