Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Ausente y ETA

Fuera

En la API de Nest, el concepto de "En casa" o "Ausente" tiene un efecto poderoso en el comportamiento de las funciones de conveniencia y ahorro de energía de Nest.

Cómo funciona En casa y Ausente

Nest utiliza una variedad de señales para detectar la presencia humana en una casa. Si Nest no detecta presencia durante un período de tiempo prolongado, automáticamente establece la casa en Ausente. Cuando detecta la presencia humana, devuelve la estructura al estado de origen.

Reaccionar a los cambios en el estado En casa / Ausente abre una amplia gama de oportunidades para sus productos. Por ejemplo, sus productos pueden:

  • Apague las luces cuando la casa pase a Ausente para ahorrar energía
  • Envíe una notificación si la puerta del garaje está abierta cuando la casa está Ausente
  • Reproducir música cuando la casa cambia a Inicio

Cómo funciona ETA

En algunos casos, los usuarios tienen una aplicación de terceros que usa GPS para proporcionar datos de tiempo estimado de llegada (ETA) a la API de Nest. En otros casos, el usuario puede usar una aplicación para ingresar manualmente su ETA. O tal vez la ETA se calcule según el horario regular del usuario.

Las aplicaciones ETA que están integradas con el termostato Nest hacen que el termostato comience a calentar o enfriar la casa antes de que llegue el usuario.

Cuando existe la integración de ETA / termostato en la cuenta del usuario, los datos de ETA están disponibles para que otros desarrolladores de Works with Nest los utilicen en sus integraciones de Works with Nest.

Una vez que se ingresa la ETA en el servicio Nest, otra integración Works with Nest puede usarla como señal para preparar la casa para la llegada del usuario.

  1. La ETA está escrito por un desarrollador Nido utilizando la escritura de sólo PUT eta llamada a la API .
  2. El termostato Nest usa estos datos.
  3. Si otros desarrolladores quieren utilizar, también, se puede utilizar el de sólo lectura GET eta_begin llamada a la API .
Datos ETA

El punto importante a tener en cuenta es que los datos de ETA deben ser ingresados ​​por un tercero. Actualmente, Nest no proporciona datos ETA. Si los datos de ETA no se han escrito, la API de Nest devuelve el valor predeterminado "1970-01-01T00: 00: 00.000Z".

Suponga, por ejemplo, que es un vendedor de iluminación. Puede obtener los datos ETA proporcionados por la integración ETA / termostato y usarlos como una señal para encender las luces.

De esta manera, no solo la temperatura es cómoda, las luces también se encienden cuando el usuario llega a casa.

Reaccionar a los cambios en el estado de la ETA abre una amplia gama de oportunidades para sus productos. Por ejemplo, sus productos pueden:

  • Encienda el televisor cuando el usuario se acerque a casa
  • Abra la puerta del garaje cuando el usuario esté casi en casa.
  • Tener música ya en reproducción cuando el usuario regrese a casa.

Permisos ausentes

Los siguientes niveles de permisos de acceso están disponibles para valores de datos Lejos-relacionados :



Acceso

Lejos leer
Lectura / escritura ausente

ETA leído

ETA lectura / escritura

Lectura de alarma de humo + CO
Termostato leído
Termostato lectura / escritura
away
eta_begin (sólo lectura)
eta objeto (sólo escritura)

Para obtener más información, consulte la Descripción general de permisos .

Funciones de distancia

En casa y lejos

La away valor de datos puede decir si Nido cree que la estructura está ocupado. Los posibles valores son:

Valor Descripción
home Hay alguien en la estructura. Este estado se puede configurar:
• por Nest si tiene una gran confianza en los datos del sensor de movimiento
• por el usuario a través de la aplicación de Nest , el termostato Nest, o su producto
• algorítmicamente a través de ETA
away No hay nadie en la estructura. El usuario ha establecido explícitamente la estructura a distancia, ya sea a través de la aplicación de Nest , el termostato Nest, o su producto.
unknown Si no hay dispositivos están asociados a la estructura, entonces el estado de distancia es unknown .

La API de Nest ofrece la posibilidad de configurar directamente En casa y Ausente, así como escuchar cambios en estos estados. Sin embargo, al establecer y fuera de casa, debe hacerse como la aplicación de Nest hace: como el resultado de una solicitud explícita del usuario. Tratando de establecer algoritmos este estado corre el riesgo de crear una experiencia de usuario confuso y está prohibido por las políticas de diseño Nido .

Tenga en cuenta que los usuarios siempre tienen la capacidad de establecer manualmente el estado Local / Visitante.

Más información sobre cómo los usuarios establecen Inicio y estados de distancia .

ETA

Fuera

ETA es un objeto con campos que se pueden configurar en una estructura. Se utiliza para informar a Nest de que se espera que un usuario regrese a casa a una hora específica. Cuando se ajusta la ETA, un producto genera una única trip_id y proporciona una ventana prevista de llegada, especificado por los siguientes valores:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Debido a que las circunstancias en torno a los viajes pueden cambiar debido al tráfico, los planes de usuario modificados y otros eventos, los productos deben actualizar la ETA periódicamente a medida que avanza el viaje, proporcionando a Nest un flujo de tiempos de llegada estimados (5 minutos es un intervalo ideal).

Cuanta más información recibamos, más confianza podemos estar en la confiabilidad de las entradas de ETA, lo que nos da más confianza a la hora de tomar medidas para preparar la casa.

ETA es independiente del estado de origen. Si la hora de llegada de una ETA entra en conflicto con otra ETA, la hora de llegada más temprana tiene prioridad.

Hacer una llamada de escritura de ETA

La lógica de ETA depende de la presencia de un termostato en la estructura. Si no existe un termostato en la estructura, las llamadas realizadas al objeto ETA fallar con el "No dispositivos emparejados" mensaje de error. Este error ocurre incluso si existen otros tipos de dispositivos en la estructura (por ejemplo, una Nest Cam o un Nest Protect).

Valores de datos

Una llamada ETA requiere los siguientes valores de datos:

Nombre Tipo Descripción
trip_id cuerda Identificador único de viaje ETA
estimated_arrival_window_begin cuerda Marca de tiempo
Debe ser mayor que NOW , en la norma ISO 8601 de formato
estimated_arrival_window_end cuerda Marca de tiempo
Debe ser mayor que estimated_arrival_window_begin , en la norma ISO 8601 de formato

Debido a la posibilidad de interrupciones de la conexión en las comunicaciones GPS, sugerimos un flujo de muestras, idealmente una vez cada 5 minutos.

Cada llamada ETA debe incluir una única trip_id cadena que se define en la llamada inicial. Otros parámetros pueden cambiar con llamadas sucesivas a la misma trip_id .

Una llamada ETA devuelve un código de estado HTTP 200 OK en caso de éxito.

Ejemplos de

Rizo
curl --location-trusted -X PUT -d \
  '{"trip_id":"sample-trip-id","estimated_arrival_window_begin":"2014-10-31T22:42:00.000Z","estimated_arrival_window_end":"2014-10-31T23:59:59.000Z"}' \
  "http://developer-api.nest.com/structures/5af48890-b516-11e3-9eff-123139166438/eta.json?auth=c.VG6bfzyOxAltaih6P4v..."

Cancelar una ETA

Para cancelar una ETA, enviar estimated_arrival_window_begin = 0 . Compruebe que está enviando un número entero (0) en esta llamada, no una cadena ("0"), o la llamada fallará.

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 .