Tek bir kod satırıyla herhangi bir web sitesine canlı hava durumu kartı ekleyin; arka uç (backend) kurmanıza veya tarayıcıda API anahtarlarınızı ifşa etmenize gerek kalmaz. Emlak ilanları, seyahat ve etkinlik sayfaları, mekanlar ve kontrol panelleri için idealdir.
Sorun
Bir web sitesi yönetiyorsanız, canlı yerel hava durumunu göstermek genellikle bir hava durumu API’sine kaydolmayı, proxy için sunucu kodu yazmayı, kotanızı aşmamak için yanıtları önbelleğe almayı ve anahtarları istemci tarafı kodundan gizlemeyi gerektirir. Bu başlı başına bir projedir. Oysa siz sadece bir kart eklemek istiyordunuz.
Nasıl çalışır
Özel bir bileşen (custom element) gömün ve hepsi bu kadar:
<script
src="https://app.weatherintouch.com/embed.js"
data-api-base="https://api.weatherintouch.com"
></script>
<wx-weather-card
lat="50.08"
lon="14.44"
lang="en"
theme="auto"
></wx-weather-card>
Kart bir Shadow DOM içinde oluşturulur, böylece stilleri sitenizin CSS’i ile asla çakışmaz. Mevcut hava koşullarını ve isteğe bağlı olarak kısa bir tahmini gösterir. iframe mi tercih ediyorsunuz? Yüksekliğini postMessage ile otomatik ayarlayan bir varyantımız da mevcut. Tüm yapılandırma nitelikler (attributes) üzerinden yapılır: koordinatlar, dil, tema ve API anahtarınız.
Neden farklı
- Paylaşımlı önbellek. Widget’ınız, ana uygulamayla aynı hava durumu önbelleğini kullanır. Sitenizdeki bir kart ile bir ziyaretçinin aynı koordinatlardaki ana uygulama sekmesi iki değil, yalnızca bir API çağrısı tüketir.
- Anahtar sızıntısı yok. Veriler arka uçtaki toplu (batch) uç nokta üzerinden sunulur; API anahtarınızın kapsamı belirlenmiştir ve köken (origin) kısıtlamasına sahiptir. Sayfada asla ham bir sağlayıcı anahtarı açığa çıkmaz.
- Stil çakışması yok. Shadow DOM izolasyonu sayesinde kart her sitede aynı görünür.
- Hesaba özel köken (origin) izin listesi. Kartınızın tam olarak hangi alan adlarında (domain) görüntülenebileceğini siz kontrol edersiniz.
Fiyatlandırma
Gömülebilir widget bir Pro özelliğidir. Tüm sitelerinizde güvenle kullanabilmeniz için size özel bir API anahtarı ve köken (origin) izin listesi içerir.
SSS
Nasıl ekleyebilirim? Script etiketini ve koordinatlarınızı içeren <wx-weather-card> bileşenini ekleyin veya iframe varyantını kullanın.
Özel bileşen mi yoksa iframe mi? Özel bileşen (custom element) daha sıkı bir entegrasyon sağlar (tema, düzen); iframe ise en izole ve eklemesi en basit olan yöntemdir.
Tema uygulayabilir miyim? Evet. theme="auto|light|dark" kullanabilirsiniz; ayrıca kart, desteklenen yerlerde sitenizin vurgu (accent) renklerine de uyum sağlar.
İstek sınırları (rate limits) nelerdir? Toplu (batch) uç nokta sınırlandırılmıştır ve önbellek öncelikli çalışır. Aynı koordinatlar tekilleştirildiği için normal kullanımlarda sınırların çok altında kalırsınız.
Weather InTouch’ı kaynak göstermem gerekir mi? Evet. Veri sağlayıcılarımızın koşulları gereği, kartın üzerinde küçük bir atıf bağlantısı yer alır.