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

Ausente & amp; ETA

Lejos

En la API de Nest, el concepto de "Hogar" o "Ausente" tiene un poderoso efecto sobre el comportamiento de las características de ahorro de energía y conveniencia de Nest.

Cómo funciona Home and Away

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

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

  • Apague las luces cuando la casa se vaya para conservar energía
  • Enviar una notificación si la puerta del garaje está abierta cuando la casa está lejos
  • Reproduce música cuando la casa cambia a Inicio

Cómo funciona ETA

En algunos casos, los usuarios tienen una aplicación de terceros que utiliza GPS para proporcionar datos de hora estimada 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 calcula 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 el hogar antes de que llegue el usuario.

Cuando la integración de ETA / termostato existe 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.

Después de que el ETA ingresa al servicio Nest, otra integración de Works with Nest puede usarlo como una señal para preparar el hogar para la llegada del usuario.

  1. La ETA está escrita por un desarrollador de Nest utilizando la llamada PUT eta API de solo escritura.
  2. El termostato Nest utiliza estos datos.
  3. Si otros desarrolladores también quieren usarlo, pueden usar la llamada a la API GET eta_begin solo GET eta_begin .
Datos de ETA

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

Supongamos, por ejemplo, que usted 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, la temperatura no solo es cómoda, sino que las luces también están encendidas cuando el usuario llega a casa.

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

  • Encienda el televisor mientras el usuario se acerca a casa
  • Abra la puerta del garaje cuando el usuario esté casi en casa.
  • Tener música ya sonando cuando el usuario regrese a casa

Permisos fuera

Los siguientes niveles de permiso de acceso están disponibles para los valores de datos relacionados con Away :



Acceso

Lejos de leer
Lectura / escritura lejana

ETA leer

ETA lectura / escritura

Lectura de alarma de humo + CO
Lectura del termostato
Termostato de 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 los permisos .

Funciones lejanas

En casa y lejos

El valor de datos de away puede decirle si Nest cree que la estructura está ocupada. Los valores posibles son:

Valor Descripción
home Hay alguien en la estructura. Este estado se puede establecer:
• por Nest si tiene una alta confianza de 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 establecido explícitamente la estructura, 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, entonces se unknown estado de ausencia.

Nest API brinda la capacidad de configurar directamente Home y Away, así como escuchar los cambios en estos estados. Sin embargo, al configurar Home and Away, 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 Local / Ausente.

Obtenga más información sobre cómo los usuarios configuran los estados Local y Ausente .

ETA

Lejos

ETA es un objeto con campos que se pueden establecer en una estructura. Se utiliza para informar a Nest que se espera que un usuario regrese a casa a una hora específica. Al configurar 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 alrededor de los viajes pueden cambiar debido al tráfico, los planes de usuario alterados y otros eventos, los productos deben actualizar 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 tenemos en la confiabilidad de las entradas de ETA, lo que nos hace más seguros al tomar medidas para preparar el hogar.

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 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 "Sin dispositivos emparejados" . Este error ocurre incluso si existen otros tipos de dispositivos en la estructura (por ejemplo, una Nest Cam o una 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 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 conexión en las comunicaciones GPS, sugerimos un flujo de muestras, idealmente una vez cada 5 minutos.

Cada llamada ETA debe incluir una cadena de trip_id única que usted 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 un 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 llamadas de API y cómo manejarlos, consulte Mensajes de error .