Google is committed to advancing racial equity for Black communities. See how.

Poza domem i ETA

Z dala

W Nest API pojęcie „Dom” lub „Poza domem” ma potężny wpływ na zachowanie funkcji oszczędzania energii i wygody Nest.

Jak działa W domu i Poza domem

Nest używa różnych sygnałów do wykrywania obecności człowieka w domu. Jeśli Nest wykryje nieobecność przez dłuższy czas, automatycznie ustawi dom jako Poza domem. Gdy wykryje obecność człowieka, przywraca strukturę do stanu Home.

Reagowanie na zmiany statusu W domu/Poza domem otwiera szerokie możliwości dla Twoich produktów. Na przykład Twoje produkty mogą:

  • Wyłącz światła, gdy dom przechodzi w tryb Poza domem, aby oszczędzać energię
  • Wyślij powiadomienie, jeśli brama garażowa jest otwarta, gdy dom jest poza domem
  • Odtwarzaj muzykę, gdy dom przełączy się na Dom

Jak działa ETA

W niektórych przypadkach użytkownicy korzystają z aplikacji innej firmy, która korzysta z GPS, aby dostarczać dane szacowanego czasu przybycia (ETA) do interfejsu Nest API. W innych przypadkach użytkownik może użyć aplikacji, aby ręcznie wprowadzić swój ETA. A może ETA jest obliczana na podstawie regularnego harmonogramu użytkownika.

Aplikacje ETA zintegrowane z Nest Thermostat powodują, że termostat zaczyna nagrzewać lub chłodzić dom przed przybyciem użytkownika.

Gdy integracja ETA/termostat istnieje na koncie użytkownika, dane ETA są dostępne dla innych programistów Works with Nest do wykorzystania w ich integracjach Works with Nest.

Po wprowadzeniu ETA do usługi Nest, kolejna integracja Works with Nest może wykorzystać ją jako sygnał do przygotowania domu na przybycie użytkownika.

  1. ETA jest napisany przez programistę gniazdem wykorzystaniem zapisu tylko PUT eta wywołania API .
  2. Nest Thermostat wykorzystuje te dane.
  3. Jeśli inni deweloperzy chcą z niego korzystać również mogą używać tylko do odczytu GET eta_begin wywołania API .
dane ETA

Ważną kwestią, o której należy pamiętać, jest to, że dane ETA muszą być wprowadzane przez stronę trzecią. Nest nie udostępnia obecnie danych ETA. Jeśli dane ETA nie zostały zapisane, Nest API zwraca domyślną wartość „1970-01-01T00:00:00.000Z”.

Załóżmy na przykład, że jesteś sprzedawcą oświetlenia. Możesz uzyskać dane ETA dostarczone przez integrację ETA/termostat i wykorzystać je jako sygnał do włączenia światła.

W ten sposób nie tylko zapewniona jest komfortowa temperatura, ale także światła zapalają się, gdy użytkownik wraca do domu.

Reagowanie na zmiany statusu ETA otwiera szerokie możliwości dla Twoich produktów. Na przykład Twoje produkty mogą:

  • Włącz telewizor, gdy użytkownik zbliża się do domu
  • Otwórz bramę garażową, gdy użytkownik jest już prawie w domu
  • Odtwarzaj muzykę, gdy użytkownik wróci do domu

Uprawnienia nieobecności

Następujące poziomy uprawnień dostępu są dostępne dla dala powiązanych wartości danych :



Dostęp

Przeczytaj na wyjeździe
Poza domem, odczyt/zapis

ETA przeczytaj

ETA odczyt/zapis

Alarm dymu + CO przeczytany
Odczyt termostatu
Termostat odczyt/zapis
away tak tak tak
eta_begin (tylko do odczytu) tak tak
eta obiekt (tylko odczyt) tak

Aby uzyskać więcej informacji, zobacz Omówienie uprawnień .

Funkcje wyjazdowe

W domu i na wyjeździe

away wartość danych może powiedzieć, czy uważa, że struktura Nest jest zajęte. Możliwe wartości to:

Wartość Opis
home Ktoś jest w strukturze. Ten stan można ustawić:
• przez Nest, jeśli ma wysoki poziom zaufania do danych czujnika ruchu
• przez użytkownika za pośrednictwem aplikacji Nest , z gniazdem termostatu lub produktu
• algorytmicznie przez ETA
away W strukturze nie ma nikogo. Użytkownik wyraźnie określać strukturę do daleko, albo za pośrednictwem aplikacji Nest , z gniazdem termostatu lub produktu.
unknown Jeśli żadne z urządzeń nie są związane ze strukturą, to państwo dalej jest unknown .

Interfejs Nest API umożliwia bezpośrednie ustawianie W domu i Poza domem, a także nasłuchiwanie zmian tych stanów. Jednak, gdy ustawienie siebie i na wyjeździe, to powinno być wykonane jako aplikacja Nest to robi: w wyniku wyraźne żądanie użytkownika. Starając się algorytmicznie ustawić ten stan ryzykuje tworząc mylące interfejs użytkownika i jest zabronione przez politykę projektowych Nest .

Należy pamiętać, że użytkownicy zawsze mają możliwość ręcznego ustawiania Home / stan hotelu.

Dowiedz się więcej na temat w jaki sposób użytkownicy ustawić Dom i członkowskich do .

ETA

Z dala

ETA jest obiektem z pól, które mogą być ustawione na konstrukcji. Służy do poinformowania Nest, że użytkownik powinien wrócić do domu o określonej godzinie. Podczas ustawiania ETA produkt generuje unikalny trip_id i zapewnia oczekiwany okno przybyciu, określony przez następujące wartości:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Ponieważ okoliczności wokół podróży mogą się zmieniać ze względu na ruch uliczny, zmienione plany użytkowników i inne zdarzenia, produkty powinny okresowo aktualizować ETA w miarę postępu podróży, zapewniając Nestowi strumień szacowanych czasów przyjazdu (5 minut to idealny odstęp).

Im więcej otrzymamy informacji, tym bardziej możemy być pewni wiarygodności danych wejściowych ETA, co daje nam większą pewność podczas podejmowania działań mających na celu przygotowanie domu.

ETA jest niezależna od państwa macierzystego. Jeśli czas przybycia ETA koliduje z innym ETA, pierwszeństwo ma najwcześniejszy czas przybycia.

Zadzwoń na pisanie ETA

Logika ETA jest zależna od obecności termostatu w konstrukcji. Jeśli termostat nie istnieje w strukturze połączeń wykonywanych do obiektu ETA nie z „No sparowanych urządzeń” komunikat o błędzie. Ten błąd występuje, nawet jeśli w strukturze istnieją inne typy urządzeń (na przykład kamera Nest Cam lub Nest Protect).

Wartości danych

Połączenie ETA wymaga następujących wartości danych:

Nazwa Rodzaj Opis
trip_id strunowy Unikalny identyfikator podróży ETA
estimated_arrival_window_begin strunowy Znak czasu
Musi być większa niż NOW w ISO 8601 Format
estimated_arrival_window_end strunowy Znak czasu
Musi być większa niż estimated_arrival_window_begin w ISO 8601 Format

Ze względu na możliwość zerwania połączenia w komunikacji GPS proponujemy strumień próbek, najlepiej raz na 5 minut.

Każde wywołanie ETA musi zawierać unikalny trip_id ciąg znaków, który można zdefiniować w początkowej rozmowy. Inne parametry mogą ulec zmianie z kolejnych połączeń z tym samym trip_id .

Wywołanie ETA zwraca kod stanu HTTP 200 OK w przypadku powodzenia.

Przykłady

Kędzior
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..."

Anuluj ETA

Aby anulować eta, wyślij estimated_arrival_window_begin = 0 . Sprawdź, czy w tym wywołaniu wysyłasz liczbę całkowitą (0), a nie ciąg („0”), w przeciwnym razie wywołanie zakończy się niepowodzeniem.

Komunikaty o błędach

Aby uzyskać informacje o tym, co znaczy błędy wywołania API i jak sobie z nimi radzić, patrz Komunikaty o błędach .