أداة قابلة للتضمين

أضف بطاقة طقس مباشرة إلى أي موقع إلكتروني بسطر برمجي واحد — دون الحاجة لبرمجة واجهة خلفية للطقس، ودون كشف مفاتيح API في المتصفح. خيار مثالي لعروض العقارات، وصفحات السفر والفعاليات، والمواقع، ولوحات المعلومات.

المشكلة

إذا كنت تدير موقعاً إلكترونياً، فإن عرض حالة الطقس المحلية المباشرة يتطلب عادةً الاشتراك في API للطقس، وكتابة كود على الخادم ليكون وسيطاً، وتخزين الاستجابات مؤقتاً لتجنب استنفاد حصتك، وإبقاء المفاتيح بعيداً عن كود واجهة المستخدم. هذا بحد ذاته مشروع، بينما كل ما أردته هو مجرد بطاقة.

كيف تعمل

قم بتضمين عنصر مخصص وستكون جاهزاً:

<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>

يتم عرض البطاقة داخل Shadow DOM، لذا لن تتعارض أنماطها أبداً مع CSS الخاص بموقعك. تعرض البطاقة الحالة الحالية للطقس، وتوقعات قصيرة اختيارية. هل تفضل استخدام iframe؟ يتوفر إصدار يضبط ارتفاعه تلقائياً عبر postMessage. تتم عملية الإعداد بالكامل من خلال الخصائص — الإحداثيات، واللغة، والمظهر، ومفتاح API الخاص بك.

ما الذي يميزها

• ذاكرة تخزين مؤقت مشتركة. تقرأ الأداة من نفس الذاكرة المؤقتة للتوقعات التي يستخدمها التطبيق الرئيسي. وجود بطاقة على موقعك وعلامة تبويب للتطبيق الرئيسي لزائر في نفس الإحداثيات يكلف طلب اتصال واحد فقط بالخادم — وليس طلبين.
• لا تسريب للمفاتيح. تقوم نقطة النهاية المجمعة في الواجهة الخلفية بتقديم البيانات؛ مفتاح API الخاص بك محدد النطاق ومقيد بالمصدر، ولا يظهر أبداً كمفتاح مزود خام في الصفحة.
• لا تداخل في التنسيقات. يضمن العزل باستخدام Shadow DOM أن تبدو البطاقة متطابقة في كل موقع.
• قائمة السماح للمصادر لكل حساب. أنت تتحكم بدقة في النطاقات التي يمكنها عرض بطاقتك.

الأسعار

الأداة القابلة للتضمين هي ميزة متوفرة في خطة Pro — وتتضمن مفتاح API لكل حساب وقائمة سماح للمصادر حتى تتمكن من نشرها عبر مواقعك المختلفة.

الأسئلة الشائعة

كيف يمكنني تضمينها؟ أضف وسم script وعنصر <wx-weather-card> مع إحداثياتك — أو استخدم إصدار iframe.

عنصر مخصص أم iframe؟ يندمج العنصر المخصص بشكل أعمق (من حيث المظهر والتخطيط)؛ بينما يوفر iframe العزل الأكبر وهو الأسهل في الإضافة المباشرة.

هل يمكنني تخصيص مظهرها؟ نعم — باستخدام theme="auto|light|dark"، بالإضافة إلى أن البطاقة تتوافق مع لون التمييز الخاص بك حيثما أمكن.

ما هي حدود الاستخدام؟ نقطة النهاية المجمعة خاضعة للتحكم في معدل الطلبات وتعتمد على الذاكرة المؤقتة أولاً؛ يبقى التضمين العادي ضمن الحدود المسموحة بكثير لأنه يتم دمج الإحداثيات المتطابقة لمنع التكرار.

هل أحتاج إلى الإشارة إلى Weather InTouch؟ نعم — تحتوي البطاقة على رابط إحالة صغير، تماشياً مع شروط مزودي البيانات لدينا.