En Google, luchamos por la equidad racial de la comunidad negra. Más información

Estructura

Estructuras

Las estructuras de nidos representan estructuras físicas en el mundo real. Por lo general, la casa de un usuario, sirven como un punto de organización para los dispositivos y almacenarán datos que se aplican a toda la casa.

El API Nest proporciona acceso a los siguientes datos de nivel de estructura, dependiendo del nivel de permisos concedidos:

  • Nombre de estructura y dispositivo "donde nombre" (ubicación en la casa)
  • La lista de dispositivos en el hogar.
  • Estado de los eventos de energía ( energía de las horas pico )
  • Estado ausente
  • ETA del usuario
  • Estado de seguridad
  • codigo postal

Algunas características a nivel de estructura se tratan en guías API independientes y más detalladas:

Permisos de estructura

Para acceder a ... Seleccione...
La mayoría de los valores de datos en la structures objeto De distancia , ETA , energía , o Código postal permisos
El name valor de datos en la structures objeto Estructura de lectura / escritura permiso

Vea cómo funcionan los permisos en el API de referencia interactiva .

Identificadores de estructura

Nombre

El nombre de la estructura predeterminado es "Inicio", pero puede ser cualquier cadena que elija el usuario. Cuando se elige la estructura de lectura / escritura permiso, se puede cambiar la estructura de name .

Donde

wheres es un conjunto de objetos sobre una estructura, que contiene donde identificadores ( where_id y name ). Uso wheres para crear a medida en que los nombres, o norma de acceso donde los nombres.

El acceso a la wheres objeto requiere la cámara , Smoke + CO alarma , o termostato permisos.

where_id

  • Un identificador único, generado Nest-que representa name
  • where_id es de sólo lectura, y se crea automáticamente en la llamada para crear una costumbre en name

name

  • El nombre para mostrar del dispositivo; puede ser cualquier nombre de habitación de una lista que proporcionamos o un nombre personalizado
  • Para crear una costumbre en name , hacer una llamada POST para escribir una nueva, personalizada, en name ; la where_id se devuelve en la llamada
  • Consideraciones
    • name no puede ser editado o borrado después de la creación
    • name debe ser único dentro de la estructura
    • Si un dispositivo está emparejado a una estructura, donde la costumbre name asociado con el dispositivo es accesible desde el /structures/ ruta
    • Para mover un dispositivo con una costumbre en name de una estructura diferente, desvincular el dispositivo, y luego volver a acoplar el dispositivo con el nombre deseado

Más información acerca de los nombres de termostatos Nest , Nest Protect y Nido de levas .

Otros metadatos

Todos los valores de datos son de solo lectura, a menos que se especifique lo contrario.

Valor de los datos Descripción
structure_id Una cadena que representa de forma única esta estructura. Cada desarrollador verá un ID diferente para la misma estructura, pero varios productos del mismo desarrollador verán el mismo ID
country_code Un código de país ISO 3166-1 alpha-2 que se asigna a la ubicación registrada de la estructura.
postal_code Código postal o postal, según el país
time_zone Un IANA zona horaria cadena que se asigna a la zona horaria de la estructura

Características de la estructura

Estados de alarma de humo y CO

Cuando se elige Humo + CO permiso de lectura , puede acceder a smoke_alarm_state y co_alarm_state en el structures objeto. Estos mismos valores de datos también están disponibles en el objeto de dispositivo ( devices/smoke_co_alarms ).

Ver el Humo + CO guía de alarma para obtener más información sobre estos estados.

Muchos valores de datos trabajan juntos para determinar cómo se comportan los dispositivos en una estructura.

  • Cuando una estructura away estado se pone a away la palabra "ECO" se visualiza en el termostato Nest, en el idioma preferido del usuario
  • Cuando una estructura away estado se pone a away , se puede:
    • conjunto fan_timer_active
    • cambio target_temperature_f o target_temperature_c
  • Cuando una estructura away estado se establece en home , se puede:
    • hacer una llamada ETA (establecer la identificación del viaje y la ventana de llegada)
  • Cuando parada de emergencia está activo, no se puede establecer fan_timer_active
  • Cuando la calefacción de emergencia está activado, no se puede puede establecer la estructura a away

Varias estructuras

Es posible que un usuario tenga más de una estructura adjunta a su cuenta de Nest, por lo que su producto debe ofrecer un medio para que el usuario elija entre las estructuras disponibles (un selector de estructura).

Selector de estructura

Por ejemplo, al configurar ETA, es importante que el usuario pueda elegir una estructura para el destino ETA. De manera similar, un usuario podría tener dos detectores de humo en la "sala de estar" de dos casas diferentes. Si necesita hacer una correlación de estructura con su propio concepto de hogar, le recomendamos que lo haga durante el proceso de autorización.

Aprender cómo los usuarios a administrar dispositivos en varias estructuras .

Máximos de dispositivo

Hay límites en la cantidad de dispositivos que admite Nest en una estructura.

Tipo de dispositivo Max por estructura
Termostato Nest 20
Cámaras Nest 10
Nest Protect 18

Error de mensajes

Para obtener información sobre lo que los errores de llamada a la API significan y cómo manejarlos, ver los mensajes de error .