Google jest zaangażowany w promowanie równości rasowej dla społeczności czarnych. Zobacz jak.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Poza domem & amp; ETA

Z dala

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

Jak działa tryb Home and Away

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

Reagowanie na zmiany statusu W domu / Na wyjeździe otwiera szeroki wachlarz możliwości dla Twoich produktów. Na przykład Twoje produkty mogą:

  • Wyłącz światła, gdy dom wychodzi na zewnątrz, aby oszczędzać energię
  • Wyślij powiadomienie, jeśli drzwi garażu są otwarte, gdy dom jest poza domem
  • Odtwarzaj muzykę, gdy dom przełącza się na Dom

Jak działa ETA

W niektórych przypadkach użytkownicy mają aplikację innej firmy, która wykorzystuje GPS do przekazywania danych o szacowanym czasie przybycia (ETA) do interfejsu API Nest. 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, które są zintegrowane z termostatem Nest, powodują, że termostat rozpoczyna ogrzewanie lub chłodzenie domu 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 integracji 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 napisane przez programistę Nest przy użyciu wywołania PUT eta API tylko do zapisu.
  2. Nest Thermostat wykorzystuje te dane.
  3. Jeśli inni programiści również chcą go używać, mogą użyć wywołania API GET eta_begin tylko do odczytu.
Dane ETA

Należy pamiętać, że dane ETA muszą być wprowadzone przez stronę trzecią. Nest nie podaje obecnie danych dotyczących czasu przyjazdu. 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 użyć ich jako sygnału do włączenia świateł.

W ten sposób nie tylko panuje komfortowa temperatura, ale również oświetlenie jest włączone, gdy użytkownik wraca do domu.

Reagowanie na zmiany statusu ETA otwiera szereg 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 wartości danych związanych z nieobecnością :



Dostęp

Czytaj dalej
Odczyt / zapis

ETA przeczytane

ETA do odczytu / zapisu

Odczyt alarmu dymu + CO
Odczyt termostatu
Odczyt / zapis termostatu
away tak tak tak
eta_begin (tylko do odczytu) tak tak
obiekt eta (tylko do zapisu) tak

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

Funkcje poza domem

W domu i poza domem

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

Wartość Opis
home Ktoś jest w strukturze. Ten stan można ustawić:
• firmy Nest, jeśli ma dużą pewność na podstawie danych z czujnika ruchu
• przez użytkownika za pośrednictwem aplikacji Nest, termostatu Nest lub Twojego produktu
• algorytmicznie przez ETA
away W strukturze nie ma nikogo. Użytkownik wyraźnie ustawił strukturę na nieobecną, za pośrednictwem aplikacji Nest, termostatu Nest lub twojego produktu.
unknown Jeśli ze strukturą nie są skojarzone żadne urządzenia, stan nieobecności jest unknown .

Nest API zapewnia możliwość bezpośredniego ustawiania Home i Away, a także nasłuchiwania zmian tych stanów. Jednak podczas ustawiania Home and Away należy to zrobić tak, jak robi to aplikacja Nest : w wyniku wyraźnego żądania użytkownika. Próba algorytmicznego ustawienia tego stanu grozi wprowadzeniem w błąd użytkownika i jest zabroniona przez zasady projektowania Nest .

Należy pamiętać, że użytkownicy zawsze mają możliwość ręcznego ustawienia stanu Dom / Poza domem.

Dowiedz się więcej o tym, jak użytkownicy ustawiają stany Dom i Poza domem .

ETA

Z dala

ETA to obiekt z polami, które można ustawić na konstrukcji. Służy do powiadomienia Nest, że użytkownik ma wrócić do domu o określonej godzinie. Podczas ustawiania ETA produkt generuje unikalny trip_id i zapewnia oczekiwane okno przybycia określone przez następujące wartości:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Ponieważ okoliczności wokół podróży mogą się zmieniać z powodu ruchu, zmienionych planów użytkownika i innych zdarzeń, produkty powinny okresowo aktualizować ETA w miarę postępu podróży, dostarczając Nestowi strumień szacunkowych czasów przybycia (5 minut to idealny interwał).

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

ETA jest niezależne od kraju pochodzenia. Jeśli czas przybycia ETA koliduje z innym ETA, pierwszeństwo ma najwcześniejszy czas przybycia.

Nawiąż kontakt pisemny z ETA

Logika ETA zależy od obecności termostatu w konstrukcji. Jeśli w strukturze nie ma termostatu, wywołania obiektu ETA kończą się niepowodzeniem i wyświetlają się komunikat o błędzie „Brak sparowanych urządzeń” . Ten błąd występuje nawet wtedy, gdy w strukturze istnieją inne typy urządzeń (na przykład Nest Cam lub Nest Protect).

Wartości danych

Wezwanie do ETA wymaga następujących wartości danych:

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

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

Każde wezwanie do ETA musi zawierać unikalny ciąg trip_id , który definiujesz w pierwszym połączeniu. Inne parametry mogą się zmieniać wraz z kolejnymi wywołaniami tego samego trip_id .

W przypadku pomyślnego wywołania ETA zwraca kod statusu HTTP 200 OK.

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ślijimate_arrival_window_begin estimated_arrival_window_begin = 0 . Sprawdź, czy w tym wywołaniu wysyłasz liczbę całkowitą (0), a nie ciąg znaków („0”), w przeciwnym razie wywołanie zakończy się niepowodzeniem.

Komunikaty o błędach

Aby uzyskać informacje o tym, co oznaczają błędy wywołań interfejsu API i jak sobie z nimi radzić, zobacz Komunikaty o błędach .