Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Struttura

strutture

Le strutture del nido rappresentano le strutture fisiche nel mondo reale. In genere la casa di un utente, funge da punto di organizzazione per i dispositivi e memorizzerà i dati che si applicano a tutta la casa.

L' API Nest fornisce l'accesso ai seguenti dati a livello di struttura, a seconda del livello delle autorizzazioni concesse:

  • Nome struttura e dispositivo "dove nome" (posizione nella casa)
  • L'elenco dei dispositivi in ​​casa
  • Stato dell'evento energetico ( ora di punta dell'energia )
  • Stato assente
  • Utente ETA
  • Stato di sicurezza
  • CAP o codice postale

Alcune funzionalità a livello di struttura sono descritte in guide API separate e più dettagliate:

Autorizzazioni per la struttura

Per l'accesso a ... Selezionare...
La maggior parte dei valori dei dati nell'oggetto structures Autorizzazioni via , ETA , energia o codice postale
Il valore dei dati del name nell'oggetto structures Autorizzazione di lettura / scrittura della struttura

Scopri come funzionano le autorizzazioni nel Riferimento API interattivo .

Identificatori di struttura

Nome

Il nome della struttura viene impostato automaticamente su "Home" ma può essere qualsiasi stringa scelta dall'utente. Quando si sceglie l'autorizzazione di lettura / scrittura della struttura, è possibile modificare il name della struttura.

Dov 'è

wheres è un oggetto impostato su una struttura, contenente where_id identificativi ( where_id e name ). Utilizzare wheres per creare su misura in cui i nomi, o l'accesso standard in cui i nomi.

L'accesso al wheres oggetto richiede Camera , fumo + CO allarme , o termostato permessi.

where_id

  • Un identificatore univoco, generato da Nest, che rappresenta il name
  • where_id è di sola lettura e viene creato automaticamente nella chiamata per creare un name dove personalizzato

name

  • Il nome visualizzato del dispositivo; può essere qualsiasi nome di stanza da un elenco che forniamo o un nome personalizzato
  • Per creare un name personalizzato dove, effettuare una chiamata POST per scrivere un nuovo name personalizzato; il where_id viene restituito nella chiamata
  • considerazioni
    • name non può essere modificato o cancellato dopo la creazione
    • name deve essere univoco all'interno della struttura
    • Se un dispositivo è accoppiato a una struttura, la personalizzazione in cui il name associato al dispositivo è accessibile dal percorso /structures/
    • Per spostare un dispositivo con un name personalizzato in una struttura diversa, disaccoppiare il dispositivo, quindi associare nuovamente il dispositivo al nome desiderato

Ulteriori informazioni sui nomi di Nest Thermostats , Nest Protects e Nest Cams .

Altri metadati

Tutti i valori dei dati sono di sola lettura, se non diversamente specificato.

Valore dei dati Descrizione
structure_id Una stringa che rappresenta in modo univoco questa struttura. Ogni sviluppatore vedrà un ID diverso per la stessa struttura, ma più prodotti dello stesso sviluppatore vedranno lo stesso ID
country_code Un codice paese ISO 3166-1 alpha-2 che mappa alla posizione registrata della struttura
postal_code Codice postale o CAP, a seconda del paese
time_zone Una stringa di fuso orario IANA che mappa al fuso orario della struttura

Caratteristiche della struttura

Stati di allarme fumo e CO

Quando si sceglie l' autorizzazione di lettura Smoke + CO , è possibile accedere a smoke_alarm_state e co_alarm_state nell'oggetto structures . Questi stessi valori di dati sono disponibili anche nell'oggetto dispositivo ( devices/smoke_co_alarms ).

Vedere la guida allarmi Smoke + CO per ulteriori informazioni su questi stati.

Molti valori di dati lavorano insieme per determinare il comportamento dei dispositivi in ​​una struttura.

  • Quando uno stato di away struttura è impostato su away la parola "ECO" viene visualizzata sul termostato Nest, nella lingua preferita dell'utente
  • Quando uno stato away struttura è impostato su away , è possibile:
    • imposta fan_timer_active
    • cambia target_temperature_f o target_temperature_c
  • Quando uno stato away struttura è impostato su home , è possibile:
    • effettuare una chiamata ETA (impostare ID viaggio e finestra di arrivo)
  • Quando l' arresto di emergenza è attivo, non è possibile impostare fan_timer_active
  • Quando il riscaldamento di emergenza è abilitato, non è possibile impostare la struttura su away

Strutture multiple

È possibile che un utente abbia più di una struttura collegata al proprio Account Nest, quindi il tuo prodotto dovrebbe offrire all'utente la possibilità di scegliere tra le strutture disponibili (un selettore di strutture).

Selettore di strutture

Ad esempio, quando si imposta ETA, è importante che l'utente sia in grado di scegliere una struttura per la destinazione ETA. Allo stesso modo, un utente potrebbe avere due rilevatori di fumo nel "soggiorno" di due case diverse. Se devi fare una correlazione strutturale con il tuo concetto di casa, ti consigliamo di farlo durante il processo di autorizzazione.

Scopri come gli utenti gestiscono i dispositivi in ​​più strutture .

Numero massimo di dispositivi

Esistono limiti al numero di dispositivi supportati da Nest in una struttura.

Tipo di dispositivo Max per struttura
Termostato Nest 20
Videocamere Nest 10
Nest Protect 18

Messaggio di errore

Per informazioni sul significato degli errori di chiamata API e su come gestirli, vedere Messaggi di errore .