Vložte kartu s aktuálním počasím na jakýkoli web pomocí jediného řádku kódu – bez nutnosti vytvářet vlastní backend nebo vystavovat API klíče v prohlížeči. Ideální pro realitní weby, stránky o cestování a událostech, prezentace míst konání nebo přehledové panely.
Problém
Pokud provozujete web, zobrazování aktuálního místního počasí obvykle znamená registraci k API pro počasí, psaní serverového kódu pro proxy, ukládání odpovědí do mezipaměti (aby nedošlo k vyčerpání limitů) a zabezpečení klíčů před klientským kódem. To už je celý projekt. Vy jste přitom chtěli jen obyčejnou kartu.
Jak to funguje
Stačí vložit vlastní prvek a máte hotovo:
<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>
Karta se vykresluje uvnitř Shadow DOM, takže se její styly nikdy nestřetnou s CSS vašeho webu. Zobrazuje aktuální podmínky a volitelně i krátkou předpověď. Dáváte přednost iframe? K dispozici je varianta, která automaticky upravuje svou výšku pomocí postMessage. Veškerá konfigurace probíhá přes atributy – souřadnice, jazyk, motiv a váš API klíč.
V čem se liší
- Sdílená mezipaměť. Váš widget čte ze stejné mezipaměti předpovědí jako hlavní aplikace. Karta na vašem webu a otevřená záložka hlavní aplikace u návštěvníka na stejných souřadnicích spotřebují pouze jedno volání na server – nikoli dvě.
- Žádný únik klíčů. Data poskytuje dávkový koncový bod na backendu; váš API klíč má omezený rozsah a povolené domény, takže se na stránce nikdy neobjeví nechráněný klíč poskytovatele.
- Žádné narušení stylu. Izolace pomocí Shadow DOM zaručuje, že karta bude vypadat na každém webu stejně.
- Seznam povolených domén pro každého klienta. Máte plnou kontrolu nad tím, které konkrétní domény mohou vaši kartu vykreslit.
Ceník
Vložitelný widget je funkcí plánu Pro – obsahuje API klíč pro každého klienta a seznam povolených domén, takže jej můžete nasadit na všech svých webech.
Často kladené dotazy
Jak widget vložím? Přidejte značku skriptu a prvek <wx-weather-card> se svými souřadnicemi – nebo použijte variantu s iframe.
Vlastní prvek, nebo iframe? Vlastní prvek (custom element) nabízí těsnější integraci (přizpůsobení motivu, rozvržení); iframe poskytuje nejvyšší míru izolace a představuje nejjednodušší způsob vložení.
Mohu upravit motiv? Ano – pomocí theme="auto|light|dark". Karta navíc tam, kde je to možné, respektuje vaši doplňkovou barvu.
Jaké jsou limity počtu požadavků? Dávkový koncový bod má omezenou propustnost a upřednostňuje mezipaměť. Běžné používání se snadno vejde do limitů, protože duplicitní požadavky na stejné souřadnice se odstraňují.
Musím uvádět Weather InTouch jako zdroj? Ano – karta obsahuje malý odkaz na zdroj, což je v souladu s podmínkami našich poskytovatelů dat.