API Camera

L'API Nest funziona con tutti i modelli Nest CamTM.

Gli utenti possono aggiungere più Nest Cam al gruppo devices/cameras, fino al massimo per struttura. Quando effettui una chiamata a questa posizione dei dati, puoi accedere ai dati di Nest Cam (valori dei dati per i dispositivi nella struttura).

Tutti i valori seguenti sono riportati sotto ogni devices/cameras/device_id nel documento JSON.

ID_dispositivo

Identificatore univoco di Nest Cam.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/device_id
Restituiscestring
Esempio: "awJo6rH..."
Accessosola lettura
Disponibile inLettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Lettura/scrittura fotocamera / v1-v3
Lettura/scrittura fotocamera + immagini / v1-v4

versione_software

Versione software.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/software_version
Restituiscestring
Esempio: "4.0"
Accessosola lettura
Disponibile inLettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Lettura/scrittura fotocamera / v1-v3
Lettura/scrittura fotocamera + immagini / v1-v4

struttura_id

Identificatore univoco della struttura.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/structure_id
Restituiscestring
Esempio: "VqFabWH21nw..."
Accessosola lettura
Disponibile inLettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Lettura/scrittura fotocamera / v1-v3
Lettura/scrittura fotocamera + immagini / v1-v4

dove_id

Un identificatore univoco generato da Nest che rappresenta name, il nome visualizzato del dispositivo.

Scopri di più su dove si trovano i nomi di Nest Thermostat, Nest Protect e Nest Cam.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/where_id
Restituiscestring
Esempio: "d6reb_OZTM..."
Accessosola lettura
Disponibile inLettura fotocamera/v1-v3
Lettura fotocamera + immagini/v1-v4
Lettura/scrittura fotocamera/v1-v3
Lettura/scrittura fotocamera + immagini/v1-v4

dove_nome

Il nome visualizzato del dispositivo. Associata a Nest Cam where_id. Può essere qualsiasi nome di una stanza da un elenco fornito da noi o un nome personalizzato. Scopri di più su dove si trovano i nomi di Nest Thermostat, Nest Protect e Nest Cam.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/where_name
Restituiscestring
Esempio: "Corridoio"
Accessosola lettura
Disponibile inLettura della fotocamera/v3
Lettura della fotocamera + immagini/v4
Lettura/scrittura della fotocamera/v3
Lettura/scrittura della fotocamera + immagini/v4

name

Nome visualizzato del dispositivo; può essere il nome di una stanza da un elenco fornito o un nome personalizzato.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/name
Restituiscestring
Esempio: "Corridoio"
Accessosola lettura
Disponibile inLettura fotocamera/v1-v3
Lettura fotocamera + immagini/v1-v4
Lettura/scrittura fotocamera/v1-v3
Lettura/scrittura fotocamera + immagini/v1-v4

nome_lungo

Nome visualizzato lungo del dispositivo. Include un'etichetta personalizzata (creata dall'utente) o tramite wheres.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/name_long
Restituiscestring
Esempio: "Corridoio Nest Cam (piano superiore)"
Accessosola lettura
Disponibile inLettura fotocamera/v1-v3
Lettura fotocamera + immagini/v1-v4
Lettura/scrittura fotocamera/v1-v3
Lettura/scrittura fotocamera + immagini/v1-v4

is_online

Stato di connessione del dispositivo con il servizio Nest.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/is_online
Restituisceboolean
Valori: vero, falso
Accessosola lettura
Disponibile inLettura fotocamera/v1-v3
Lettura fotocamera + immagini/v1-v4
Lettura/scrittura fotocamera/v1-v3
Lettura/scrittura fotocamera + immagini/v1-v4

is_streaming

Stato della videocamera, video in streaming attivo o spento oppure spento. Consulta l'articolo Come funziona la videocamera con A casa/Fuori casa per ulteriori informazioni.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/is_streaming
Restituisceboolean
Valori: vero, falso
Accessolettura/scrittura
Disponibile inLettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Lettura/scrittura fotocamera / v1-v3
Lettura/scrittura fotocamera + immagini / v1-v4

is_audio_input_enabled

Stato del microfono della videocamera, acceso o in ascolto oppure disattivato. Scopri di più sulle impostazioni audio di Nest Cam.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/is_audio_input_enabled
Restituisceboolean
Valori: vero, falso
Accessosola lettura
Disponibile inLettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Lettura/scrittura fotocamera / v1-v3
Lettura/scrittura fotocamera + immagini / v1-v4

ultimo_cambio_online

Timestamp che identifica l'ultima modifica apportata allo stato online in formato ISO 8601.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/last_is_online_change
Restituiscestring
Esempio: "2016-12-29T18:42:00.000Z"
Accessosola lettura
Disponibile inLettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Lettura/scrittura fotocamera / v1-v3
Lettura/scrittura fotocamera + immagini / v1-v4

is_video_history_enabled

Stato dell'abbonamento Nest Aware (abbonamento attivo o meno).

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/is_video_history_enabled
Restituisceboolean
Valori: vero, falso
Accessosola lettura
Disponibile inLettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Lettura/scrittura fotocamera / v1-v3
Lettura/scrittura fotocamera + immagini / v1-v4

URL_web

URL web (link diretto) al video stream in diretta all'indirizzo home.nest.com.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/web_url
Restituiscestring
Esempio: "https://home.nest.com/cameras/device_id?auth=camera_token"
Accessosola lettura
Disponibile inLettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Lettura/scrittura fotocamera / v1-v3
Lettura/scrittura fotocamera + immagini / v1-v4

URL_app

URL dell'app (link diretto) al video stream in diretta nell'app Nest.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/app_url
Restituiscestring
Esempio: "nestmobile://cameras/device_id?auth=camera_token"
Accessosola lettura
Disponibile inLettura fotocamera/v1-v3
Lettura fotocamera + immagini/v1-v4
Lettura/scrittura fotocamera/v1-v3
Lettura/scrittura fotocamera + immagini/v1-v4

is_public_share_enabled

Gli utenti possono scegliere di condividere il loro video e renderlo visibile a tutti. Quando la condivisione pubblica è abilitata, puoi leggere public_share_url.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/is_public_share_enabled
Restituisceboolean
Valori: vero, falso
Accessosola lettura
Disponibile inLettura della fotocamera + immagini/v3-v4
Lettura/scrittura della fotocamera + immagini/v3-v4

zone_attività

Restituisce un array di tutte le Zone attive definite.

Le Zone attive vengono utilizzate per monitorare gli eventi di movimento all'interno delle aree definite dall'utente del video stream. Richiede Nest Aware.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/activity_zones
Restituiscearray
Esempio: [ {"name" : "string1", "id" : "string2"},... ]

string1 è il nome della zona, definito dall'utente o generato automaticamente quando la zona viene creata.
string2 è un identificatore assegnato da Nest al momento della creazione della Zona attiva.
Accessosola lettura
Disponibile inLettura della fotocamera + immagini/v3-v4
Lettura/scrittura della fotocamera + immagini/v3-v4

Public_share_url

Puoi accedere a questo URL quando un utente rende pubblico il proprio video stream.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/public_share_url
Restituiscestring
Esempio: "https://video.nest.com/live/string1?string2"

string1 è il nome del video stream, definito dall'utente o generato automaticamente quando lo stream è impostato come pubblico.
Accessosola lettura
Disponibile inLettura della fotocamera + immagini / v3-v4
Lettura/scrittura della fotocamera + immagini / v3-v4

URL_istantanea

Acquisisci un'immagine on demand. Restituisce l'URL di un'immagine acquisita dal video stream in diretta. Richiede che la videocamera sia accesa e attiva in streaming.

Utilizza questo campo per ottenere un'istantanea dal video stream in diretta.

  • snapshot_url: restituisce l'URL di un'immagine acquisita dal video stream in diretta
  • Richiede che la videocamera sia accesa e attiva in streaming

La qualità dello snapshot dell'API è di 1080p solo se sei:

  • visualizzazione attiva del flusso della videocamera nell'applicazione (web_url)
  • visualizzazione attiva dello stream pubblico (app_url)
  • hai sottoscritto un abbonamento a Nest Aware

Se non stai guardando attivamente lo stream o non hai un abbonamento Nest Aware, l'API non ha un'origine 1080p da cui recuperare uno snapshot a quella risoluzione e genera un'immagine di qualità inferiore. Inoltre, se la larghezza di banda della rete locale è bassa, la risoluzione degli snapshot dell'API potrebbe diminuire di 1080p con Nest Aware.

Scopri di più sui requisiti di larghezza di banda per le videocamere Nest.

A questa chiamata vengono applicate le limitazioni, a seconda dello stato di abbonamento di Nest Aware.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/snapshot_url
Restituiscestring
Esempio: "string1/device_id/string2?auth=camera_token"
Accessosola lettura
Disponibile inLettura della fotocamera + immagini/v3-v4
Lettura/scrittura della fotocamera + immagini/v3-v4

ultimo_evento

Questo oggetto acquisisce le informazioni sull'ultimo evento che ha attivato una notifica.

Alcuni campi e alcune combinazioni di autorizzazioni richiedono un abbonamento Nest Aware per accedere alle informazioni sull'ultimo evento.

Tutti i valori seguenti sono riportati sotto ogni devices/cameras/device_id/last_event nel documento JSON.

has_sound

Evento sonoro: è stato rilevato un suono.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_sound
Restituisceboolean
Valori: vero, falso
Accessosola lettura
Disponibile inLettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Lettura/scrittura fotocamera / v1-v3
Lettura/scrittura fotocamera + immagini / v1-v4

has_motion

Evento di movimento: è stato rilevato un movimento.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_motion
Restituisceboolean
Valori: vero, falso
Accessosola lettura
Disponibile inLettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Lettura/scrittura fotocamera / v1-v3
Lettura/scrittura fotocamera + immagini / v1-v4

ha_persona

Evento persona: è stata rilevata una persona.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_person
Restituisceboolean
Valori: vero, falso
Accessosola lettura
Disponibile inLettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Lettura/scrittura fotocamera / v1-v3
Lettura/scrittura fotocamera + immagini / v1-v4

start_time

Ora di inizio dell'evento, in formato ISO 8601.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/last_event/start_time
Restituiscestring
Esempio: "2016-12-29T00:00:00.000Z"
Accessosola lettura
Disponibile inLettura fotocamera/v1-v3
Lettura fotocamera + immagini/v1-v4
Lettura/scrittura fotocamera/v1-v3
Lettura/scrittura fotocamera + immagini/v1-v4

end_time

Ora di fine dell'evento, nel formato ISO 8601.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/last_event/end_time
Restituiscestring
Esempio: "2016-12-29T00:00:00.000Z"
Accessosola lettura
Disponibile inLettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Lettura/scrittura fotocamera / v1-v3
Lettura/scrittura fotocamera + immagini / v1-v4

urls_expire_time

Timestamp, in formato ISO 8601, che identifica la scadenza dei seguenti URL correlati agli eventi.

La scadenza è calcolata come segue: last_event/start_time + n giorni (dove n = 10 o 30 giorni, a seconda del piano di abbonamento Nest Aware).

Richiede Nest Aware.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/last_event/urls_expire_time
Restituiscestring
Esempio: "2016-12-29T00:00:00.000Z"
Accessosola lettura
Disponibile inLettura fotocamera/v1-v3
Lettura fotocamera + immagini/v1-v4
Lettura/scrittura fotocamera/v1-v3
Lettura/scrittura fotocamera + immagini/v1-v4

URL_web

URL web (link diretto) all'ultimo evento sonoro o di movimento all'indirizzo home.nest.com. Utilizzato per visualizzare l'ultimo evento registrato e richiede l'accesso dell'utente all'account.

Richiede Nest Aware. Se l'URL dell'evento è scaduto o il dispositivo non ha un abbonamento attivo, questo valore non è incluso nel payload.

Leggi le last_event/urls_expire_time per informazioni sulla scadenza di questo URL.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/last_event/web_url
Restituiscestring
Esempio: "https://home.nest.com/cameras/device_id/cuepoints/string?auth=camera_token"
Accessosola lettura
Disponibile inLettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Lettura/scrittura fotocamera / v1-v3
Lettura/scrittura fotocamera + immagini / v1-v4

URL_app

URL dell'app Nest (link diretto) all'ultimo evento sonoro o di movimento. Consente di visualizzare l'ultimo evento registrato e richiede che l'utente abbia eseguito l'accesso all'account.

Richiede Nest Aware. Se l'URL dell'evento è scaduto o il dispositivo non ha un abbonamento attivo, questo valore non è incluso nel payload.

Leggi le last_event/urls_expire_time per informazioni sulla scadenza di questo URL.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/last_event/app_url
Restituiscestring
Esempio: "nestmobile://cameras/device_id/cuepoints/string?auth=camera_token"
Accessosola lettura
Disponibile inLettura fotocamera/v1-v3
Lettura fotocamera + immagini/v1-v4
Lettura/scrittura fotocamera/v1-v3
Lettura/scrittura fotocamera + immagini/v1-v4

image_url

URL (link) al file immagine acquisito per un evento sonoro o di movimento.

Richiede Nest Aware. Leggi le last_event/urls_expire_time informazioni sulla data di scadenza dell'URL.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/last_event/image_url
Restituiscestring
Esempio: "https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token"
Accessosola lettura
Disponibile inLettura fotocamera + immagini/v1-v4
Lettura/scrittura fotocamera + immagini/v1-v4

animazione_immagine_url

URL (link) al file gif acquisito per un evento sonoro o di movimento.

Richiede Nest Aware.

Dettagli
https://developer-api.nest.com/devices/cameras/device_id/last_event/animated_image_url
Restituiscestring
Esempio: "https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token"
Accessosola lettura
Disponibile inLettura fotocamera + immagini/v1-v4
Lettura/scrittura fotocamera + immagini/v1-v4

activity_zone_id [id_area_attività]

Identificatori per le Zone attive che hanno rilevato un evento di movimento.

Richiede Nest Aware. Se utilizzato con l'array activity_zones, è possibile ottenere il nome zona da questi ID.

Se last_event/has_motion è

  • true = restituisce gli ID zona attiva che hanno rilevato un evento di movimento
  • false = restituisce un array vuoto
Dettagli
https://developer-api.nest.com/devices/cameras/device_id/last_event/activity_zone_ids
Restituiscearray
Esempio: [ string1, string2,... ]
Accessosola lettura
Disponibile inLettura della fotocamera + immagini / v3-v4
Lettura/scrittura della fotocamera + immagini / v3-v4