O Google está comprometido em promover a equidade racial para as comunidades negras. Veja como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

Longe & amp; ETA

Longe

Na API ninho, o conceito de "Home" ou "Away" tem um efeito poderoso sobre os comportamentos de poupança de energia do ninho e características de conveniência.

Como Casa e trabalha fora

Nest utiliza uma variedade de sinais para detectar a presença humana em uma casa. Se Nest detecta nenhuma presença por um período prolongado de tempo, ele automaticamente define o lar de Longe. Quando se detecta a presença humana, ele retorna a estrutura para o estado inicial.

Reagindo às mudanças no Início / status Longe abre uma ampla gama de oportunidades para o seu produto. Por exemplo, seus produtos podem:

  • Desligue as luzes quando a casa vai para longe para economizar energia
  • Enviar uma notificação se a porta da garagem é aberto quando a casa é afastado
  • Tocar música quando a casa muda para casa

Como ETA funciona

Em alguns casos, os usuários têm um aplicativo de terceiro-party que usa GPS para fornecer tempo estimado de chegada (ETA) de dados para a API do ninho. Em outros casos, o usuário pode usar um aplicativo para inserir manualmente o seu ETA. Ou talvez o ETA está calcluated com base na programação regular do usuário.

aplicativos do ETA que estão integrados com o Nest Thermostat causa o termostato para começar o aquecimento ou arrefecimento da casa antes que o usuário chega.

Quando o ETA / termostato integração existe na conta do usuário, os dados ETA está disponível para outros trabalha com desenvolvedores de ninho para usar em suas obras com integrações ninho.

Após a ETA é a entrada para o serviço Nest, outros trabalhos com integração Nest pode usá-lo como um sinal para preparar a casa para a chegada do usuário.

  1. O ETA é escrito por um desenvolvedor Nest usando o somente para gravação PUT eta chamada de API .
  2. O Nest Thermostat usa esses dados.
  3. Se outros desenvolvedores quiser usá-lo, também, eles podem usar o read-only GET eta_begin chamada de API .
dados ETA

O ponto importante a ter em mente é que os dados da ETA devem ser introduzidas pelo 3º festa. Nest atualmente não fornece dados ETA. Se os dados ETA não foi escrito, a API Nest retorna o padrão "1970-01-01T00: 00.000Z: 00" valor.

Suponha, por exemplo, que você é um fornecedor de iluminação. Você pode obter os dados do ETA fornecidos pelo ETA / termostato integração e usá-lo como um sinal para acender as luzes.

Desta forma, não é só a temperatura confortável, as luzes também estão em quando o usuário chega em casa.

Reagindo às mudanças no status ETA abre uma ampla gama de oportunidades para o seu produto. Por exemplo, seus produtos podem:

  • Ligue a TV como o usuário se aproxima de casa
  • Abra a porta da garagem quando o usuário está quase em casa
  • Tenha a música já jogar quando o usuário retorna para casa

permissões de distância

Os seguintes níveis de permissão de acesso estão disponíveis para valores de dados Longe relacionados- :



Acesso

longe ler
Longe de leitura / gravação

ETA leitura

ETA leitura / gravação

Fumaça + CO leitura alarme
termostato leitura
Termostato de leitura / gravação
away sim sim sim
eta_begin (somente leitura) sim sim
eta objeto (somente escrita) sim

Para mais informações, consulte o Visão geral das permissões .

características de distância

Home and Away

A away valor de dados pode dizer se Nest pensa que a estrutura está ocupada. Os valores possíveis são:

Valor Descrição
home Há alguém na estrutura. Este estado pode ser definido:
• pela Nest se ele tem um alto nível de confiança a partir de dados do sensor de movimento
• pelo usuário através do aplicativo Nest , o Nest Thermostat, ou seu produto
• algorithmically via ETA
away Não há uma na estrutura. O utilizador definir explicitamente a estrutura a distância, quer através da aplicação Nest , o Nest Thermostat, ou seu produto.
unknown Se nenhum dispositivo estão associados com a estrutura, então o estado de distância é unknown .

A API Nest fornece a capacidade de definir diretamente Home and Away, bem como ouvir as alterações a estes estados. No entanto, quando a criação Home and Away, isso deve ser feito como o aplicativo Nest faz isso: como o resultado de uma solicitação explícita do usuário. Tentando definir algorithmically este estado corre o risco de criar uma experiência de usuário confuso e é proibido pelas políticas de design Nest .

Esteja ciente de que os usuários sempre tenham a capacidade de definir manualmente o / estado Away Home.

Saiba mais sobre como os usuários definir Casa e estados de distância .

ETA

Longe

ETA é um objecto com campos que podem ser fixados sobre uma estrutura. Ele é usado para deixar Nest sabe que um usuário é esperado para voltar para casa em um momento específico. Ao configurar o ETA, um produto gera uma única trip_id e fornece uma janela prevista de chegada, especificado pelos seguintes valores:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Porque as circunstâncias em torno de viagens podem mudar devido ao tráfego, planos usuário alterados, e outros eventos, os produtos devem atualizar ETA periodicamente como os avanços de viagem, fornecendo Ninho com um fluxo de horários de chegada estimados (5 minutos é um intervalo ideal).

Quanto mais informações que recebemos, mais confiantes de que podemos estar na confiabilidade das entradas do ETA, o que nos torna mais confiantes ao tomar medidas para preparar a casa.

ETA é independente do estado de origem. Se o tempo de chegada de uma ETA em conflito com outro ETA, o tempo de chegada mais cedo tem prioridade.

Fazer uma chamada de gravação ETA

ETA lógica é dependente da presença de um termostato na estrutura. Se nenhum termostato existe na estrutura, as chamadas feitas para o objeto ETA falhar com o "Não emparelhado dispositivos" mensagem de erro. Este erro ocorre mesmo se outros tipos de dispositivos de existirem na estrutura (por exemplo, um ninho Cam ou um ninho Protect).

valores de dados

Uma chamada ETA requer os seguintes valores de dados:

Nome Tipo Descrição
trip_id corda identificador de viagem única ETA
estimated_arrival_window_begin corda timestamp
Deve ser maior que NOW , na ISO 8601 formato
estimated_arrival_window_end corda timestamp
Deve ser maior que estimated_arrival_window_begin , na ISO 8601 formato

Devido à possibilidade de desistências de conexão em comunicações GPS, sugerimos um fluxo de amostras, idealmente uma vez a cada 5 minutos.

Cada chamada ETA deve incluir um único trip_id cadeia de caracteres que você define na chamada inicial. Outros parâmetros podem mudar com chamadas sucessivas para o mesmo trip_id .

Uma chamada ETA retorna um código de status HTTP 200 OK em caso de sucesso.

Exemplos

Ondulação
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 uma ETA

Para cancelar um eta, envie estimated_arrival_window_begin = 0 . Verifique se você está enviando um número inteiro (0) neste chamar, não uma string ( "0"), ou a chamada falhará.

Mensagens de erro

Para obter informações sobre o que os erros de chamadas API significa e como lidar com eles, ver mensagens de erro .