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

Deplasman ve tahmini varış süresi

Uzakta

Nest API'sinde "Ev" veya "Dışarıda" kavramı, Nest'in enerji tasarrufu ve kolaylık özelliklerinin davranışları üzerinde güçlü bir etkiye sahiptir.

Evde ve Dışarıda nasıl çalışır?

Nest, bir Evde insan varlığını algılamak için çeşitli sinyaller kullanır. Nest, uzun bir süre hiçbir varlık algılamazsa, evi otomatik olarak Uzakta olarak ayarlar. İnsan varlığını algıladığında yapıyı Ev durumuna döndürür.

Evde/Dışarıda durumundaki değişikliklere tepki vermek, ürünleriniz için çok çeşitli fırsatlar sunar. Örneğin, ürünleriniz şunları yapabilir:

  • Enerji tasarrufu için ev Dışarıda moduna geçtiğinde ışıkları kapatın
  • Ev Uzaktayken garaj kapısı açıksa bir bildirim gönderin
  • Ev, Ev moduna geçtiğinde müzik çalın

ETA nasıl çalışır?

Bazı durumlarda, kullanıcıların Nest API'sine tahmini varış zamanı (ETA) verileri sağlamak için GPS kullanan bir üçüncü taraf uygulaması vardır. Diğer durumlarda, kullanıcı ETA'larını manuel olarak girmek için bir uygulama kullanabilir. Veya ETA, kullanıcının düzenli programına göre hesaplanıyor olabilir.

Nest Thermostat ile entegre ETA uygulamaları, termostatın kullanıcı gelmeden önce evi ısıtmaya veya soğutmaya başlamasına neden olur.

Kullanıcının hesabında ETA/termostat entegrasyonu mevcut olduğunda, ETA verileri diğer Works with Nest geliştiricilerinin Works with Nest entegrasyonlarında kullanmaları için kullanılabilir.

ETA, Nest hizmetine girildikten sonra, başka bir Works with Nest entegrasyonu, evi kullanıcının gelişine hazırlamak için bir sinyal olarak kullanabilir.

  1. ETA salt kullanarak bir Nest geliştirici tarafından yazılan PUT eta API çağrısı .
  2. Nest Thermostat bu verileri kullanır.
  3. Diğer geliştiricilerin kullanmak istiyorsanız da onlar salt okunur kullanabilirsiniz GET eta_begin API çağrısı .
ETA verileri

Akılda tutulması gereken önemli nokta, ETA verilerinin 3. bir tarafça girilmesi gerektiğidir. Nest şu anda ETA verileri sağlamıyor. ETA verileri yazılmamışsa, Nest API varsayılan "1970-01-01T00:00:00.000Z" değerini döndürür.

Örneğin, bir aydınlatma satıcısı olduğunuzu varsayalım. ETA/termostat entegrasyonunun sağladığı ETA verilerini alabilir ve ışıkları yakmak için sinyal olarak kullanabilirsiniz.

Bu sayede sadece sıcaklık rahat olmakla kalmaz, aynı zamanda kullanıcı eve geldiğinde ışıklar da yanar.

ETA durumundaki değişikliklere tepki vermek, ürünleriniz için çok çeşitli fırsatlar sunar. Örneğin, ürünleriniz şunları yapabilir:

  • Kullanıcı eve yaklaşırken TV'yi açın
  • Kullanıcı neredeyse eve geldiğinde garaj kapısını açın
  • Kullanıcı eve döndüğünde müzik zaten çalıyor

izinler

Aşağıdaki erişim izin düzeyleri için kullanılabilir Dışarıda alakalı veri değerlerinin :



Giriş

uzakta oku
Uzakta okuma/yazma

tahmini varış zamanı

ETA okuma/yazma

Duman+CO alarm okuması
Termostat okuma
Termostat okuma/yazma
away Evet Evet Evet
eta_begin (salt okunur) Evet Evet
eta nesnesi (yazma için) Evet

Daha fazla bilgi için, bkz izinler Genel Bakış .

Uzakta özellikleri

Ev ve uzak

away Nest yapısı işgal edilmiş düşünürse veri değeri söyleyebilirim. Olası değerler şunlardır:

Değer Açıklama
home Yapıda biri var. Bu durum ayarlanabilir:
• Nest tarafından hareket sensörü verilerinden yüksek bir güvene sahipse
• aracılığı kullanıcı tarafından Nest uygulamasından , Nest Termostat veya ürününüz
• ETA aracılığıyla algoritmik olarak
away Yapıda kimse yok. Kullanıcı açıkça ya vasıtasıyla, uzak bir yapı oluşturmuştur Nest uygulamasından , Nest Termostat veya ürününüz.
unknown Hiçbir cihazlar yapıyla ilişkilidir, o zaman uzak durumudur unknown .

Nest API, Evde ve Dışarıda'yı doğrudan ayarlama ve bu durumlarda yapılan değişiklikleri dinleme olanağı sağlar. Ev ayarlama ve Dışarıda olduğu gibi Ancak, yapılmalı Nest uygulaması yapar: Açık bir kullanıcı isteği sonucu olarak. Algoritmik bu durumu belirtmek için çalışılıyor bir kafa karıştırıcı bir kullanıcı deneyimi oluşturma riskini taşımaktadır ve yasakladığı Nest tasarım politikaları .

Kullanıcıların her zaman elle Ev / Deplasman durumunu ayarlamak yeteneğine sahip olduğunu unutmayın.

Diğer konularla ilgili bilgi kullanıcıları Ev ve Deplasman durumlarını ayarlamak nasıl .

tahmini varış süresi

Uzakta

ETA bir yapı üzerinde ayarlanabilir alanları ile bir nesnedir. Nest'e bir kullanıcının belirli bir zamanda eve dönmesinin beklendiğini bildirmek için kullanılır. ETA ayarlarken, bir ürünün benzersiz üretir trip_id ve aşağıdaki değerlere göre belirlenen varış beklenen penceresi sağlar:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

Yolculuklarla ilgili koşullar trafik, değişen kullanıcı planları ve diğer olaylar nedeniyle değişebileceğinden, ürünler yolculuk ilerledikçe ETA'yı periyodik olarak güncellemeli ve Nest'e tahmini varış süreleri akışı sağlamalıdır (5 dakika ideal bir aralıktır).

Ne kadar çok bilgi alırsak, ETA girdilerinin güvenilirliğinden o kadar emin olabiliriz, bu da evi hazırlamak için harekete geçerken bizi daha çok güvende hissettirir.

ETA, ana eyaletten bağımsızdır. Bir ETA'nın varış zamanı başka bir ETA ile çelişiyorsa, en erken varış zamanı önceliklidir.

ETA yazma araması yapın

ETA mantığı, yapıda bir Termostatın varlığına bağlıdır. Hiçbir termostat yapısında varsa, başarısız ETA nesnesine yapılan aramaları "Hiçbir cihaz eşleştirilmiş" hata iletisi. Bu hata, yapıda başka türde cihazlar olsa bile oluşur (örneğin, Nest Cam veya Nest Protect).

Veri değerleri

Bir ETA çağrısı aşağıdaki veri değerlerini gerektirir:

isim Tür Açıklama
trip_id dize Benzersiz ETA seyahat tanımlayıcısı
estimated_arrival_window_begin dize zaman damgası
Daha büyük olmalıdır NOW içinde, 8601 ISO biçimi
estimated_arrival_window_end dize zaman damgası
Daha büyük olmalıdır estimated_arrival_window_begin içinde, 8601 ISO biçimi

GPS iletişiminde bağlantı kesintileri olasılığı nedeniyle, ideal olarak her 5 dakikada bir örnek akışı öneriyoruz.

Her ETA çağrı benzersiz içermelidir trip_id , ilk çağrıda tanımlamak o dizeyi. Diğer parametreler aynı arda çağrılar ile değiştirebilir trip_id .

Bir ETA çağrısı, başarı durumunda 200 OK HTTP durum kodu döndürür.

Örnekler

kıvırmak
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'yı iptal et

Bir eta iptal etmek için göndermek estimated_arrival_window_begin = 0 . Bu aramada bir dize ("0") değil bir tamsayı (0) gönderdiğinizi kontrol edin, aksi takdirde arama başarısız olur.

Hata mesajları

API çağrısı hataları anlama ve bunların nasıl işleneceğine, gördükleri hakkında bilgi için Hata Mesajları .