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
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Ausente y ETA

Lejos

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 fuera

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 entre en modo 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 cambie 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 la escribe un desarrollador de Nest mediante la llamada a la API PUT eta solo escritura.
  2. El termostato Nest usa estos datos.
  3. Si otros desarrolladores también quieren usarlo, pueden usar la llamada a la API de solo lectura GET eta_begin .
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 forma, no solo la temperatura es agradable, 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 los valores de datos relacionados con Ausente :



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 si si si
eta_begin (solo lectura) si si
objeto eta (solo escritura) si

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

Funciones de distancia

En casa y lejos

El valor de los datos away puede indicarle si Nest cree que la estructura está ocupada. 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 Nest , el termostato Nest o su producto
• algorítmicamente a través de ETA
away No hay nadie en la estructura. El usuario ha configurado explícitamente la estructura como ausente, ya sea a través de la aplicación Nest , el termostato Nest o su producto.
unknown Si no hay dispositivos asociados con la estructura, se unknown estado ausente.

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

Tenga en cuenta que los usuarios siempre tienen la capacidad de configurar manualmente el estado En casa / Ausente.

Obtén más información sobre cómo los usuarios establecen los estados En casa y Ausente .

ETA

Lejos

ETA es un objeto con campos que se pueden configurar en una estructura. Se utiliza para que Nest sepa que se espera que un usuario regrese a casa a una hora específica. Al establecer la ETA, un producto genera un trip_id único y proporciona una ventana de llegada esperada, especificada 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, lo que proporciona a Nest un flujo de tiempos estimados de llegada (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 fallan con el mensaje de error "No hay dispositivos emparejados" . 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 de 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 formato ISO 8601
estimated_arrival_window_end cuerda Marca de tiempo
Debe ser mayor que estimated_arrival_window_begin , en formato ISO 8601

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 de ETA debe incluir una cadena trip_id única que defina en la llamada inicial. Otros parámetros pueden cambiar con llamadas sucesivas al mismo trip_id .

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

Ejemplos

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, envíe 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 qué significan los errores de llamada a la API y cómo manejarlos, consulte Mensajes de error .