Google se compromete a promover la equidad racial para las comunidades negras. Ver cómo.
Esta página se ha traducido con Cloud Translation API.
Switch to English

Lejos & amp; ETA

Lejos

En la API Nido, el concepto de "Inicio" o "No" tiene un poderoso efecto sobre los comportamientos de ahorro de energía de Nest y características de conveniencia.

Cómo hogar y trabaja fuera

Nido utiliza una variedad de señales para detectar la presencia humana en un hogar. Si Nido detecta ninguna presencia durante un período prolongado de tiempo, se establece automáticamente la casa a distancia. Cuando se detecta la presencia humana, devuelve la estructura para el estado de inicio.

Como reacción a los cambios en el Inicio / estado Ausente abre una amplia gama de oportunidades para sus productos. Por ejemplo, los productos pueden:

  • Apagar las luces cuando la casa entra en distancia a conservar la energía
  • Enviar una notificación si la puerta del garaje está abierta cuando la casa está lejos
  • Reproducir música cuando la casa cambia al Inicio

¿Cómo funciona la ETA

En algunos casos, los usuarios tienen una aplicación tercera partes que se utiliza el GPS para proporcionar la hora estimada de llegada (ETA) de datos a la API de Nest. En otros casos, el usuario puede utilizar una aplicación para introducir manualmente la ETA. O tal vez la ETA se calcluated basado en el horario habitual del usuario.

ETA aplicaciones que se integran con el termostato Nest causa el termostato para comenzar el calentamiento o enfriamiento de la casa antes de que llegue al usuario.

Cuando / existe la ETA termostato de la integración en la cuenta del usuario, los datos de ETA está disponible para otras obras con los desarrolladores de nido para utilizar en sus obras con integraciones nido.

Después de la ETA se introduce en el servicio Nido, otro trabaja con la integración Nido se puede utilizar como una 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 utiliza 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 de ETA

El punto importante a tener en cuenta es que los datos de ETA debe introducir una tercera parte. Nido actualmente no proporciona datos de ETA. Si los datos de ETA no se ha escrito, la API devuelve la jerarquía por defecto "1970-01-01T00: 00.000Z: 00" valor.

Supongamos, por ejemplo, que usted es un proveedor de iluminación. Usted puede obtener los datos proporcionados por la ETA ETA / termostato de integración y utilizarlo como una señal para encender las luces.

De esta manera, no sólo es la temperatura cómoda, las luces son también de cuando el usuario llega a casa.

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

  • Encienda el televisor y cuando el usuario se acerca a casa
  • Abrir la puerta del garaje cuando el usuario está casi en casa
  • Tienen música ya jugar cuando el usuario vuelve a casa

permisos de distancia

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



Acceso

lejos leer
Distancia de lectura / escritura

lectura ETA

ETA lectura / escritura

Humo + CO lectura de alarma
lectura del termostato
Termostato de lectura / escritura
away si si si
eta_begin (sólo lectura) si si
eta objeto (sólo escritura) si

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

características de distancia

En casa y lejos

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

Valor Descripción
home Hay alguien en la estructura. Este estado se puede configurar:
• Nido por si tiene un alto grado de confianza de los datos de sensor de movimiento
• por el usuario a través de la aplicación de Nest , el termostato Nest, o su producto
• algorítmica 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 Nido ofrece la posibilidad de fijar directamente y fuera de casa, así como escuchar los cambios a 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

Lejos

ETA es un objeto con campos que se pueden configurar en una estructura. Se utiliza para dar a conocer el nido que se espera que un usuario de volver a casa a una hora determinada. 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 las circunstancias alrededor de los viajes se pueden cambiar debido al tráfico, planes de usuario alterados, y otros eventos, los productos deben actualizar periódicamente ETA como los progresos de viaje, proporcionando Nido con una corriente de los tiempos estimados de llegada (5 minutos es un intervalo ideal).

Cuanto más información que recibimos, más confianza que puede estar en la fiabilidad de las entradas de ETA, lo que nos hace más seguros cuando se toman medidas para preparar la casa.

ETA es independiente del estado de origen. Si el tiempo de llegada de una ETA en conflicto con otra ETA, la primera hora de llegada tiene prioridad.

Hacer una llamada de escritura ETA

lógica ETA es dependiente 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 se produce incluso si existen otros tipos de dispositivos en la estructura (por ejemplo, un Nest Cam o un Nest Protect).

Los valores de datos

Una llamada de ETA requiere los siguientes valores de los datos:

Nombre Tipo Descripción
trip_id cuerda identificador único 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 abandonos de conexión en las comunicaciones GPS, sugerimos una corriente 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 de 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, enviar estimated_arrival_window_begin = 0 . Compruebe si está enviando un número entero (0) en esta convocatoria, 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 .