Notice: We're retiring Works with Nest. See the home page for more information.
En Google, luchamos por la equidad racial de la comunidad negra. Más información
Esta página se ha traducido con Cloud Translation API.
Switch to English

Estructura

estructuras

geoprópolis representan estructuras físicas en el mundo real. Por lo general la casa de un usuario, que sirven como punto de organización para los dispositivos y almacenará los datos que se aplica 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 la estructura y el dispositivo "en nombre" (lugar de la casa)
  • La lista de dispositivos en el hogar
  • Estado de los eventos de energía ( energía de las horas pico )
  • estado de distancia
  • ETA usuario
  • estado de seguridad
  • codigo postal

Algunas de las características de nivel de estructura están cubiertos en las guías API separados, más detallada:

estructura permisos

Para el acceso 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 .

identificación de estructura

Nombre

El nombre de los valores predeterminados de la estructura a "Inicio", pero puede ser cualquier cadena que escoge el usuario. Cuando se elige la estructura de lectura / escritura permiso, se puede cambiar la estructura de name .

wheres

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 de visualización del dispositivo; puede ser cualquier nombre de la sala 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 los datos son de sólo 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 los productos múltiples del mismo desarrollador verá la misma ID
country_code Un ISO 3166-1 alfa-2 código de país que se asigna a la ubicación registrada de la estructura
postal_code Postal o código postal, dependiendo del país
time_zone Un IANA zona horaria cadena que se asigna a la zona horaria de la estructura

características de la estructura

De humo y CO estados de alarma

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 en conjunto para determinar cómo los dispositivos se comportan de 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:
    • realizar una llamada de ETA (Identificación del conjunto de viaje y ventana de la 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

estructuras múltiples

Es posible que un usuario tiene más de una estructura unida 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 establecer ETA, es importante que el usuario sea capaz de elegir una estructura para el destino de ETA. De un modo similar, un usuario podría tener dos detectores de humo en la "sala de estar" de dos casas diferentes. Si lo que necesita hacer correlación estructura con su propio concepto de un hogar, se recomienda hacer esto durante el proceso de autorización.

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

máximos de dispositivos

Hay límites a la cantidad de soportes dispositivos 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 .