Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Uzakta & amp; ETA

Uzakta

Nest API'sinde, "Ev" veya "Dışarıda" kavramının Nest'in enerji tasarrufu ve rahatlık özelliklerinin davranışları üzerinde güçlü bir etkisi vardır.

Evde ve Dışarıda Nasıl Çalışır

Nest, bir Evdeki insan varlığını tespit etmek için çeşitli sinyaller kullanır. Nest uzun bir süre boyunca herhangi bir durum tespit etmezse, evi otomatik olarak Uzakta olarak ayarlar. İnsanın varlığını tespit ettiğinde, yapıyı Yuva durumuna döndürür.

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

  • Ev enerjiden tasarruf etmek için evden uzaklaştığında ışıkları kapatın
  • Ev uzaktayken garaj kapısı açıksa bildirim gönderin
  • Ev Ana Ekrana 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) verilerini sağlamak için GPS kullanan bir üçüncü taraf uygulaması vardır. Diğer durumlarda, kullanıcı ETA'sını manuel olarak girmek için bir uygulama kullanabilir. Veya belki de ETA, kullanıcının düzenli programına göre hesaplanır.

Nest Thermostat ile entegre olan ETA uygulamaları, termostatın kullanıcı gelmeden önce ısınmaya veya soğutulmasına neden olur.

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

ETA Nest hizmetine girdikten sonra, Nest ile başka bir Works entegrasyonu, evi kullanıcının varışına hazırlamak için bir sinyal olarak kullanabilir.

  1. ETA, bir Nest geliştiricisi tarafından salt yazılan PUT eta API çağrısı kullanılarak yazılmıştır.
  2. Nest Thermostat bu verileri kullanır.
  3. Diğer geliştiriciler de kullanmak istiyorsa, salt okunur GET eta_begin API çağrısını kullanabilirler .
ETA verileri

Unutulmaması gereken önemli nokta, ETA verilerinin bir üçüncü taraf tarafından girilmesi gerektiğidir. Nest şu anda ETA verisi sağlamıyor. ETA verileri yazılmadıysa, 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 varsayın. ETA / termostat entegrasyonu tarafından sağlanan ETA verilerini alabilir ve ışıkları açmak için bir sinyal olarak kullanabilirsiniz.

Bu şekilde, 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 evdeyken garaj kapısını açın
  • Kullanıcı eve döndüğünde müziğin çalmasını sağlayın

Dışarıda izinler

Uzakta ilgili veri değerleri için aşağıdaki erişim izni düzeyleri kullanılabilir:



Giriş

Dışarıda okuyun
Dışarıda okuma / yazma

ETA okuması

ETA okuma / yazma

Duman + CO alarmı okuma
Termostat okuma
Termostat okuma / yazma
away Evet Evet Evet
eta_begin (salt okunur) Evet Evet
eta nesnesi (yalnızca yazma) Evet

Daha fazla bilgi için İzinlere Genel Bakış konusuna bakın.

Dışarıda özellikler

Ev ve uzak

away veri değeri Nest'in yapının dolu olup olmadığını düşünmesini sağlayabilir. Olası değerler:

değer Açıklama
home Yapıda biri var. Bu durum ayarlanabilir:
• Hareket sensörü verilerinden yüksek düzeyde güven duyuyorsa Nest tarafından
• kullanıcı tarafından Nest uygulaması , Nest Termostatı veya ürününüz üzerinden
• ETA üzerinden algoritmik
away Yapıda kimse yok. Kullanıcı, Nest uygulaması , Nest Thermostat veya ürününüz aracılığıyla yapıyı açıkça uzaklara ayarlamıştır.
unknown Yapıyla hiçbir aygıt ilişkilendirilmezse, çıkış durumu unknown .

Nest API, doğrudan Ev ve Dışarıda'yı ayarlama ve bu durumlardaki değişiklikleri dinleme olanağı sağlar. Ancak, Ana Sayfa ve Dışarıda ayarı yapılırken, Nest uygulamasının yaptığı gibi: açık bir kullanıcı isteğinin sonucu olarak yapılmalıdır. Bu durumu algoritmik olarak ayarlamaya çalışmak kafa karıştırıcı bir kullanıcı deneyimi yaratma riski taşır ve Nest tasarım politikaları tarafından yasaklanmıştır.

Kullanıcıların her zaman Ev / Dışarı durumunu manuel olarak ayarlayabileceğini unutmayın.

Kullanıcıların Ev ve Dışarıda durumlarını nasıl ayarladığı hakkında daha fazla bilgi edinin .

ETA

Uzakta

ETA , bir yapı üzerinde ayarlanabilen alanları olan bir nesnedir. Nest'e bir kullanıcının belirli bir zamanda eve dönmesi beklendiğini bildirmek için kullanılır. ETA ayarlanırken, ürün benzersiz bir trip_id üretir ve aşağıdaki değerlerle belirtilen beklenen bir varış penceresi sağlar:

  • estimated_arrival_window_begin
  • estimated_arrival_window_end

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

Ne kadar fazla bilgi alırsak, ETA girişlerinin güvenilirliğine o kadar güvenebiliriz ki bu da evi hazırlamak için harekete geçerken bizi daha güvende hissettirir.

ETA kendi ülkesinden bağımsızdır. Bir ETA'nın varış zamanı başka bir ETA ile çakışırsa, en erken varış zamanı önceliklidir.

ETA yazma çağrısı yapma

ETA mantığı, yapıdaki bir Termostatın varlığına bağlıdır. Yapıda termostat yoksa, ETA nesnesine yapılan çağrılar "Eşlenmiş cihaz yok" hata mesajıyla başarısız olur. Bu hata, yapıda başka tür aygıtlar 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:

ad tip Açıklama
trip_id sicim Benzersiz ETA gezi tanımlayıcısı
estimated_arrival_window_begin sicim Zaman Damgası
ISO 8601 biçiminde NOW daha büyük olmalıdır
estimated_arrival_window_end sicim Zaman Damgası
Daha büyük olmalıdır estimated_arrival_window_begin içinde, 8601 ISO biçimi

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

Her ETA çağrısı, ilk çağrıda tanımladığınız benzersiz bir trip_id dizesi trip_id . Diğer parametreler, aynı trip_id yapılan art arda çağrılarla trip_id .

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

Örnekler

Kıvrım
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..."

Bir ETA'yı iptal etme

Bir etayı iptal etmek için tahmini_arrival_window_begin estimated_arrival_window_begin = 0 gönderin. Bu çağrıda bir dize ("0") değil, bir tamsayı (0) gönderip göndermediğinizi kontrol edin, aksi takdirde çağrı başarısız olur.

Hata mesajları

API çağrı hatalarının ne anlama geldiği ve bunların nasıl ele alınacağı hakkında bilgi için, bkz. Hata Mesajları .