Google стремится продвигать расовую справедливость для черных сообществ. Смотри как.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

В гостях расчетное время прибытия

Прочь

В Nest API концепция «Дома» или «Вне дома» оказывает мощное влияние на функции энергосбережения и удобства Nest.

Как работает Home and Away

Гнездо использует различные сигналы для обнаружения присутствия человека в доме. Если Nest не обнаруживает присутствия в течение длительного периода времени, он автоматически устанавливает для дома значение Away. Когда он обнаруживает присутствие человека, он возвращает структуру в исходное состояние.

Реакция на изменения статуса Home / Away открывает широкий спектр возможностей для ваших продуктов. Например, ваши продукты могут:

  • Выключите свет, когда дом уходит, чтобы сохранить энергию
  • Отправьте уведомление, если дверь гаража открыта, когда дома нет гостей
  • Воспроизведение музыки, когда дом переключается на дом

Как работает ETA

В некоторых случаях пользователи имеют стороннее приложение, которое использует GPS для предоставления данных о предполагаемом времени прибытия (ETA) в API Nest. В других случаях пользователь может использовать приложение для ручного ввода своего ETA. Или, может быть, ETA рассчитывается на основе обычного графика пользователя.

Приложения ETA, интегрированные с Nest Thermostat, приводят к тому, что термостат начинает нагревать или охлаждать дом до прибытия пользователя.

Когда интеграция ETA / термостат существует в учетной записи пользователя, данные ETA доступны для использования другими разработчиками Works с Nest в их интеграциях Works с Nest.

После ввода ETA в службу Nest другая интеграция с Works with Nest может использовать ее в качестве сигнала для подготовки дома к прибытию пользователя.

  1. ETA написана разработчиком Nest с использованием API-вызова PUT eta только для записи.
  2. Гнездовой термостат использует эти данные.
  3. Если другие разработчики тоже хотят его использовать, они могут использовать API-вызов GET eta_begin только для GET eta_begin .
Данные ETA

Важно помнить, что данные ETA должны вводиться третьей стороной. В настоящее время Nest не предоставляет данные ETA. Если данные ETA не были записаны, Nest API возвращает значение по умолчанию «1970-01-01T00: 00: 00.000Z».

Предположим, например, что вы поставщик освещения. Вы можете получить данные ETA, предоставленные интеграцией ETA / термостат, и использовать их в качестве сигнала для включения освещения.

Таким образом, температура не только комфортна, но и свет включается, когда пользователь приходит домой.

Реакция на изменения статуса ETA открывает широкий спектр возможностей для ваших продуктов. Например, ваши продукты могут:

  • Включите телевизор, когда пользователь подходит к дому
  • Откройте дверь гаража, когда пользователь почти дома
  • Музыка уже играет, когда пользователь возвращается домой

Выездные разрешения

Для значений данных, связанных с гостями, доступны следующие уровни доступа:



доступ

Прочь прочел
Прочь читать / писать

ETA читать

ETA чтение / запись

Дым + CO сигнал тревоги прочитан
Термостат читать
Термостат для чтения / записи
away да да да
eta_begin (только для чтения) да да
eta объект (только запись) да

Для получения дополнительной информации см. Обзор разрешений .

В гостях

Дома и в гостях

Значение away данных может сказать вам, думает ли Нест, что структура занята. Возможные значения:

Стоимость Описание
home В структуре есть кто-то. Это состояние может быть установлено:
• Nest, если он имеет высокую достоверность данных датчика движения
• пользователем через приложение Nest, термостат Nest или ваш продукт
• алгоритмически через ETA
away Там нет никого в структуре. Пользователь явно отключил структуру, используя приложение Nest , Nest Thermostat или ваш продукт.
unknown Если никакие устройства не связаны со структурой, то состояние отсутствия unknown .

Nest API предоставляет возможность напрямую устанавливать Home и Away, а также прослушивать изменения этих состояний. Однако при настройке Home и Away это должно быть сделано так, как это делает приложение Nest : в результате явного запроса пользователя. Попытка алгоритмически установить это состояние рискует создать запутанный пользовательский интерфейс и запрещена политиками проектирования Nest .

Имейте в виду, что пользователи всегда могут вручную установить состояние «Домой / В гостях».

Узнайте больше о том, как пользователи устанавливают состояния «Домой» и «Гости» .

расчетное время прибытия

Прочь

ETA - это объект с полями, которые можно установить в структуре. Он используется, чтобы Nest знал, что пользователь должен вернуться домой в определенное время. При настройке ETA продукт генерирует уникальный trip_id и предоставляет ожидаемое окно прибытия, определяемое следующими значениями:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Поскольку обстоятельства, связанные с поездками, могут изменяться из-за трафика, измененных планов пользователей и других событий, продукты должны периодически обновлять ETA в ходе поездки, предоставляя Nest поток предполагаемого времени прибытия (5 минут - идеальный интервал).

Чем больше информации мы получаем, тем больше мы можем быть уверены в надежности входных данных ETA, что делает нас более уверенными при принятии мер по подготовке дома.

ETA не зависит от государства проживания. Если время прибытия ETA конфликтует с другим ETA, самое раннее время прибытия имеет приоритет.

Сделайте звонок ETA

ETA логика зависит от наличия термостата в конструкции. Если в структуре нет термостата, вызовы, сделанные к объекту ETA, завершаются неудачно с сообщением об ошибке «Нет сопряженных устройств» . Эта ошибка возникает, даже если в структуре существуют другие типы устройств (например, Nest Cam или Nest Protect).

Значения данных

Для вызова ETA требуются следующие значения данных:

название Тип Описание
trip_id строка Уникальный идентификатор поездки ETA
estimated_arrival_window_begin строка Отметка
Должно быть больше, чем NOW , в формате ISO 8601
estimated_arrival_window_end строка Отметка
Должно быть больше, чем estimated_arrival_window_begin , в формате ISO 8601

Из-за возможности потери соединения в GPS-связи мы предлагаем поток образцов, в идеале, каждые 5 минут.

Каждый вызов ETA должен включать уникальную строку trip_id которую вы определяете при первоначальном вызове. Другие параметры могут изменяться при последовательных вызовах к одному и trip_id же trip_id .

При успешном вызове ETA возвращается код состояния HTTP 200 OK.

Примеры

Curl
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..."

Отменить ETA

Чтобы отменить eta, отправьте estimated_arrival_window_begin = 0 . Убедитесь, что в этом вызове вы отправляете целое число (0), а не строку («0»), иначе вызов не удастся.

Сообщения об ошибках

Для получения информации о том, что означают ошибки вызова API и как их обрабатывать, см. Сообщения об ошибках .