Umieść kartę z aktualną pogodą na dowolnej stronie internetowej za pomocą jednej linijki kodu — bez budowania własnego backendu i bez ujawniania kluczy API w przeglądarce. Idealne rozwiązanie dla portali nieruchomości, stron turystycznych i eventowych, obiektów oraz paneli administracyjnych.
Problem
Jeśli prowadzisz stronę internetową, wyświetlanie aktualnej lokalnej pogody zazwyczaj oznacza rejestrację w API pogodowym, pisanie kodu serwerowego do pośredniczenia w zapytaniach, buforowanie odpowiedzi, aby nie przekroczyć limitów, oraz ukrywanie kluczy przed kodem po stronie klienta. To cały projekt. A Ty chciałeś tylko prostą kartę.
Jak to działa
Osadź niestandardowy element i gotowe:
<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 renderuje się wewnątrz Shadow DOM, więc jej style nigdy nie kolidują z CSS Twojej strony. Wyświetla aktualne warunki i, opcjonalnie, krótką prognozę. Wolisz iframe? Dostępny jest wariant, który automatycznie dostosowuje swoją wysokość za pomocą postMessage. Cała konfiguracja opiera się na atrybutach — współrzędnych, języku, motywie i Twoim kluczu API.
Co nas wyróżnia
- Współdzielona pamięć podręczna. Twój widżet korzysta z tego samego cache’u prognoz co główna aplikacja. Karta na Twojej stronie i otwarta karta głównej aplikacji u odwiedzającego dla tych samych współrzędnych to koszt jednego zapytania do dostawcy — nie dwóch.
- Brak wycieków kluczy. Dane serwuje nasz zbiorczy endpoint na backendzie; Twój klucz API ma ograniczony zakres i jest przypisany do konkretnej domeny. Nigdy nie umieszczasz surowego klucza dostawcy na stronie.
- Brak konfliktów stylów. Izolacja Shadow DOM sprawia, że karta wygląda tak samo na każdej stronie.
- Biała lista domen dla każdego klienta. Masz pełną kontrolę nad tym, na jakich domenach może wyświetlać się Twoja karta.
Cennik
Widżet do osadzenia to funkcja planu Pro — obejmuje dedykowany klucz API oraz białą listę domen, dzięki czemu możesz wdrożyć go na wszystkich swoich stronach.
FAQ
Jak mogę go osadzić? Dodaj tag skryptu oraz element <wx-weather-card> ze swoimi współrzędnymi — lub użyj wariantu iframe.
Niestandardowy element czy iframe? Niestandardowy element lepiej się integruje (motywy, układ); iframe jest najbardziej odizolowany i najprostszy do wklejenia.
Czy mogę zmienić motyw? Tak — theme="auto|light|dark", a dodatkowo karta dostosowuje się do Twojego koloru wiodącego tam, gdzie to możliwe.
Jakie są limity zapytań? Zbiorczy endpoint ma ograniczenia przepustowości i w pierwszej kolejności korzysta z pamięci podręcznej; standardowe osadzenie bez problemu mieści się w limitach, ponieważ identyczne współrzędne są deduplikowane.
Czy muszę podawać źródło Weather InTouch? Tak — karta zawiera mały link z uznaniem autorstwa, zgodnie z warunkami naszych dostawców danych.