ملاحظة هامة - تم إيقاف هذا البرنامج المساعد الآن!
(واصل القراءة - لدي أخبار جيدة سأعلنها أيضًا)
لقد أوقف Open Weather واجهة برمجة التطبيقات (API 2.5) التي يعتمد عليها هذا البرنامج الإضافي. إنهم يقدمون API 3.0 وهو مجاني، ولكنه يتطلب بطاقة ائتمان للاشتراك في API. لست مهتمًا بإعطاء إحدى الشركات طريقة لتحصيل رسوم مني تلقائيًا مقابل شيء ما في المستقبل عندما/إذا قررت ذلك. أنا متأكد تمامًا من أن هذا لن يحدث أبدًا، ولكن يمكنني أن أقول إنني متأكد تمامًا من أنه لا يمكن أن يحدث إذا لم يكن لديهم معلومات بطاقتي الائتمانية. وأيضًا إذا بدأوا في فرض رسوم على مستخدمي هذا البرنامج الإضافي (حوالي 10000 مستخدم) لسبب غير متوقع، فسيكون ذلك سيجعل الكثير من الأشخاص غير راضين جدًا عني وسيكون ذلك أمرًا مزعجًا على أقل تقدير...
هناك نقطة أخرى وهي أن هناك اختلافات كافية بين واجهتي برمجة التطبيقات (API) بحيث تتطلب بشكل أساسي إعادة كتابة كاملة للمكون الإضافي مما يؤدي إلى أخباري الجيدة... لقد أكملت تقريبًا مكونًا إضافيًا جديدًا للطقس يعتمد على Visual Crossing Weather واجهة برمجة التطبيقات. الاشتراك فيه مجاني ولا يتطلب أي شيء آخر غير عنوان بريدك الإلكتروني. يمكنك الاشتراك هنا. إنه يوفر العديد من الميزات الرائعة التي لم يتم تضمينها في Open Weather. على سبيل المثال، 15 يومًا كاملاً للتنبؤ بينما كان الطقس المفتوح يحتوي على 5 أيام فقط ولمدة 21 ساعة من كل 24 يومًا، لم يُرجع اليومان 1 و5 البيانات الكاملة لتلك الأيام. تقوم VCW API أيضًا بإرجاع البيانات كل ساعة لكل يوم من تلك الأيام الخمسة عشر بينما تقوم OW بإرجاع البيانات فقط في مجموعات مدتها 3 ساعات. الميزات الرائعة الأخرى التي يقدمها VCW API ويفتقدها OW API هي تنبيهات الطقس، ويتم إرجاع البيانات بالتوقيت المحلي بدلاً من GMT (لا حاجة إلى تحويلات). تعد وثائق API أيضًا أفضل بكثير ولديها منتدى دعم نشط. بشكل عام، إنها مجرد واجهة برمجة تطبيقات أجمل للعمل معها.
إذا كنت تريد تجربة المكوّن الإضافي الجديد، يمكنك الآن العثور على المكوّن الإضافي Visual Crossing Weather هنا. لديه بعض التحسينات الكبيرة على البرنامج المساعد القديم. أصبح لديه الآن 5 مواقع يمكنك الحصول على بيانات الطقس الخاصة بها بدلاً من موقع واحد فقط. لقد قمت بمضاعفة عدد قوالب الطقس من 4 إلى 8. يوجد الآن سلسلتان لشريط الحالة يمكن تدويرهما كل 30 ثانية. الإعدادات الافتراضية هي أن الأول يحتوي على معلومات عن طقس اليوم، والثاني يعرض معلومات عن طقس الغد. لاحظ أنه بينما لا يزال هذا العمل قيد التقدم، إلا أن كل الميزات تقريبًا تعمل الآن (لم تكتمل بعد ميزتان ما زلت أرغب في إضافتهما). الوثائق أيضًا غير موجودة بشكل أساسي في الوقت الحالي على الرغم من أن لدي القائمة الكاملة لوحدات الماكرو الحالية التي تم إنشاؤها (ما يقرب من 4000 بالفعل) ويتم عرضها بتنسيق جدول سهل القراءة. لقد قمت بتحميل ملف main.js أيضًا إذا كنت ترغب في إجراء تثبيت يدوي أو يمكنك استخدام البرنامج الإضافي BRAT للقيام بهذا العمل نيابةً عنك. سيكون من المفيد جدًا لأي شخص يرغب في اختبار الإصدار التجريبي أن يقدم أي تعليقات.
يرجى ملاحظة أنه كان من المفترض أن يتم إيقاف واجهة برمجة التطبيقات (API) منذ 3 أسابيع، ولكن في الوقت الحالي لا تزال تقوم بإرجاع البيانات. وهذا يمكن أن يتوقف في أي وقت!!! ومن حسن الحظ أنه استمر على هذا النحو لأنه أعطاني الوقت لكتابة البرنامج المساعد الجديد. سأطلب إزالة هذا المكون الإضافي من قائمة المكونات الإضافية للمجتمع عندما تتوقف واجهة برمجة التطبيقات عن العمل أو عندما أقوم بإضافة المكون الإضافي الجديد إلى قائمة المكونات الإضافية للمجتمع.
شكرًا لجميع مستخدمي المكونات الإضافية منذ إنشائها، William McKeever
' | %desc% | Current Temp: %temp%°C | Feels Like: %feels%°C | '
'%desc% • Current Temp: %temp%°C • Feels Like: %feels%°Cn'
'%name%: %dateMonth4% %dateDay2% - %timeH2%:%timeM% %ampm1%nCurrent Temp: %temp%°C • Feels Like: %feels%°CnWind: %wind-speed% km/h from the %wind-dir%^ with gusts up to %wind-gust% km/h^nSunrise: %sunrise% • Sunset: %sunset%n'
'%icon% %dateMonth4% %dateDay2% %dateYear1% • %timeH2%:%timeM% %ampm1% • %desc%<br> Recorded Temp: %temp% • Felt like: %feels%<br> Wind: %wind-speed% km/h from the %wind-dir%^ with gusts up to %wind-gust% km/h^<br> Sunrise: %sunrise% • Sunset: %sunset%'
'%icon% %dateMonth4% %dateDay2% %dateYear1% • %timeH2%:%timeM% %ampm1% • %desc%<br> Current Temp: %temp% • Feels like: %feels%<br> Wind: %wind-speed% km/h from the %wind-dir%^ with gusts up to %wind-gust% km/h^<br> Sunrise: %sunrise% • Sunset: %sunset%'
تنسيق السلسلة الثالثة...
تنسيق السلسلة الرابعة...
ملاحظة: لا تكون n مطلوبة عند تحريرها في الإعدادات. ما عليك سوى إدخال return لإضافة سطر جديد وستتم إضافة n إلى ملف الإعدادات المحفوظة. إن <br> 's بتنسيقات السلسلة 3 و4 مطلوبة للاستخدام في HTML.
راجع EXAMPLE.md للحصول على عرض توضيحي لكيفية استخدام هذا في القالب اليومي الخاص بي.
أدخل مفتاح OpenWeather API الخاص بك هنا (مطلوب)
مطلوب مفتاح OpenWeather API مجاني حتى يعمل البرنامج الإضافي. انتقل إلى https://openweathermap.org للتسجيل والحصول على المفتاح. الرابط المباشر لصفحة التسجيل https://home.openweathermap.org/users/sign_up.
ملاحظة: ستحتاج إلى التحقق من عنوان بريدك الإلكتروني، ثم سيتم إرسال مفتاح واجهة برمجة التطبيقات (API) إليك عبر البريد الإلكتروني. قد يستغرق المفتاح نفسه بضع ساعات قبل أن يتم تنشيطه. سيتم تضمين كل هذه المعلومات في البريد الإلكتروني الذي يرسلونه إليك.
تقوم واجهة برمجة تطبيقات الترميز الجغرافي هذه بإرجاع اسم المواقع المطلوبة والولاية والبلد وخط العرض وخط الطول مما يسمح لك باختيار الموقع الصحيح. يعد هذا مفيدًا في الحالات التي يكون فيها لمدينتك اسم شائع مشترك بين مدن أخرى. لاستخدام هذا، أدخل اسم مدينتك في حقل النص واضغط على زر Get location . سيُطلب منك قائمة تضم ما يصل إلى 5 مواقع للاختيار من بينها.
ملاحظة: يوصى باستخدام أمر Use Geocoding API to get location (recommended) لملء هذا نيابةً عنك.
أدخل اسم مدينتك (هذا الإعداد مطلوب ما لم يتم تحديد خط الطول والعرض) ملاحظة: إذا كنت تحصل على بيانات خاطئة، فحاول تضمين رموز الولاية والبلد الخاصة بك. يمكن إدخالها كـ {اسم المدينة}، {رمز الولاية}، {رمز البلد}. على سبيل المثال. ساوث بيند، واشنطن، الولايات المتحدة (الفواصل مطلوبة). إذا كنت لا تزال تواجه مشكلات في الحصول على البيانات الصحيحة، فاستخدم إعدادات Latitude وLongitude بدلاً من ذلك.
ملاحظة: يوصى باستخدام أمر Use Geocoding API to get location (recommended) لملء هذا نيابةً عنك.
أدخل خط العرض لمدينتك (سيؤدي ضبط خط الطول وخط العرض إلى تجاوز إعداد الموقع)
يرجى ملاحظة أنه تم إهمال طلبات واجهة برمجة التطبيقات حسب اسم المدينة على الرغم من أنها لا تزال متاحة للاستخدام. الطريقة المفضلة هي استخدام خطوط الطول والعرض.
ملاحظة: يوصى باستخدام أمر Use Geocoding API to get location (recommended) لملء هذا نيابةً عنك.
أدخل خط الطول لمدينتك (سيؤدي ضبط خط الطول وخط العرض إلى تجاوز إعداد الموقع)
يرجى ملاحظة أنه تم إهمال طلبات واجهة برمجة التطبيقات حسب اسم المدينة على الرغم من أنها لا تزال متاحة للاستخدام. الطريقة المفضلة هي استخدام خطوط الطول والعرض.
يمكن اختيار الوحدات المترية والإمبراطورية والقياسية هنا. (ملاحظة: المعيار بالكلفن، وهو ليس مفيدًا حقًا في معظم الحالات)
اللغات المدعومة المتاحة (إجمالي 46 لغة) ملاحظة: ينطبق هذا فقط على النص الذي يتم إرجاعه بواسطة Open Weather API. هذا لا يغير النص في سلاسل الطقس المحددة. إذا كنت تريد النص الموجود في سلاسل الطقس الافتراضية بلغة أخرى، فستحتاج إلى تعديلها مباشرةً في الإعدادات.
المجلد المراد استبعاده من استبدال سلاسل القالب التلقائي. يجب تعيين هذا إلى مجلد قالب الخزائن الخاص بك. يتضمن الاستبعاد أي مجلدات فرعية داخل المجلد المحدد.
حدد سلاسل الطقس الخاصة بك هنا (تتوفر 4 سلاسل + 1 لشريط الحالة)
نصيحة: يمكن أن تحتوي هذه السلاسل على أي شيء تريده، وليس معلومات الطقس فقط.
تبديل عرض الطقس الحالي في شريط الحالة أو إيقاف تشغيله
حدد سلسلة الطقس الخاصة بشريط الحالة هنا
الفاصل الزمني لتحديث الطقس المعروض في شريط الحالة وعناصر DIV (1، 5، 10، 15، 20، 30 أو 60 دقيقة)
سيتم استبدال وحدات الماكرو هذه الموجودة في سلسلة الطقس بالبيانات المناسبة.
%desc%%desc-em%%icon% - راجع الملاحظة أدناه%icon2x% - راجع الملاحظة أدناه%temp%%feels%%tempmin%%tempmax%%pressure%%humidity%%pressure-sl%%pressure-gl%%visibility%%wind-speed% - كم/ساعة للمتري، ميل في الساعة للإمبراطورية%wind-speed-ms% - م/ث (متر في الثانية)%wind-dir% - على سبيل المثال. شمال غرب%wind-gust% - انظر الملاحظة أدناه%clouds% (النسبة المئوية)%rain1h% (بالملليمترات)%rain3h% (بالملليمترات)%snow1h% (بالملليمترات)%snow3h% (بالملليمتر)%precipitation1h% (بالملليمترات - أمطار أو ثلج)%precipitation3h% (بالمليمتر - مطر أو ثلج)%sunrise% - 08:30:30 (تنسيق 24 ساعة)%sunset% - 19:30:30 (تنسيق 24 ساعة)%name% - على سبيل المثال. ادمونتون%latitude% - على سبيل المثال. 46.66%longitude% - على سبيل المثال. -123.80%aqinumber% - 1 إلى 5 (الترتيب يطابق قائمة السلاسل)%aqistring% - "جيد"، "معتدل"، "معتدل"، "ضعيف"، "سيء جدًا" (الترتيب يطابق قائمة الأرقام)%dateYear1% - 2022%dateYear2% - 22%dateMonth1% - 1%dateMonth2% - 01%dateMonth3% - يناير%dateMonth4% - يناير%dateDay1% - 2%dateDay2% - 02%ampm1% - "ص"%ampm2% - "صباحًا"%timeH1% - 23 (24 ساعة)%timeH2% - 1 (12 ساعة)%timeM% - 05%timeS% - 05 ملاحظة: يتم إرجاع توقعات 5 أيام بزيادات 3 ساعات (إجمالي 40 كائن بيانات). وهذا يعني أن البيانات التي يتم إرجاعها بواسطة واجهة برمجة التطبيقات (API) لا تبدأ عند الساعة 12:00 صباحًا غدًا، ولكن لشريحة الثلاث ساعات التالية من البيانات المتاحة. وهذا يعني أنه يمكنك الحصول على توقعات الطقس الكاملة لمدة 5 أيام مرة واحدة فقط في اليوم (قبل منتصف الليل مباشرة). وفي جميع الأوقات الأخرى سوف تتلقى بيانات جزئية لهذا اليوم وبيانات جزئية لليوم الأخير. ستحتاج إلى مراعاة ذلك عند تحديد سلاسل الطقس الخاصة بك. لتسهيل الأمر عليك، قمت بتضمين العناصر النائبة %next12% و %next24% و %next48% (راجع مثال العنصر النائب) وسوف أقوم بإضافة المزيد في المستقبل.
ملاحظة: تمثل العناصر النائبة كائنات التنبؤ لمدة 3 ساعات ويتم ترقيمها 00، 01، 02، ... 39 في العناصر النائبة.
%fyear_00% إلى %fyear_39% - سنة التنبؤ على سبيل المثال. 2024
%fmonth_00% إلى %fmonth_39% - شهر التوقعات على سبيل المثال. 05
%fdate_00% إلى %fdate_39% - تاريخ التنبؤ على سبيل المثال. 26
%fhours_00% إلى %fhours_39% - ساعات التنبؤ على سبيل المثال. 18
%fmins_00% إلى %fmins_39% - دقائق التوقعات على سبيل المثال. 00 (سيكون دائمًا 00)
%fsecs_00% إلى %fsecs_39% - ثواني التنبؤ على سبيل المثال. 00 (سيكون دائمًا 00)
%dt_localtime_00% إلى %dt_localtime_39% - سلسلة التاريخ والوقت المحلية المتوقعة على سبيل المثال. 2024-05-26 18:00:00
%d_localtime_00% إلى %d_localtime_39% - سلسلة التاريخ المحلي المتوقعة على سبيل المثال. 2024-05-26
%ds_localtime_00% إلى %ds_localtime_39% - سلسلة قصيرة للتنبؤ بالتاريخ المحلي، على سبيل المثال. 05-26
%t_localtime_00% إلى %t_localtime_39% - سلسلة التوقيت المحلي المتوقعة على سبيل المثال. 18:00:00
%ts_localtime_00% إلى %ts_localtime_39% - توقع سلسلة قصيرة بالتوقيت المحلي على سبيل المثال. 18:00
%ftemp_00% إلى %ftemp_39% - درجة الحرارة المتوقعة على سبيل المثال. 15
%ffeels_00% إلى %ffeels_39% - تبدو التوقعات مثل درجة الحرارة على سبيل المثال. 14
%fclouds_00% إلى %fclouds_39% - توقعات التغطية السحابية على سبيل المثال. 99
%fpop_00% إلى %fpop_39% - احتمالية هطول الأمطار على سبيل المثال. 100
%fpod_00% إلى %fpod_39% - جزء من اليوم (n - ليل، d - نهار) على سبيل المثال. د
%fvis_00% إلى %fvis_39% - إمكانية الرؤية بالأقدام على سبيل المثال. 10000
%fhum_00% إلى %fhum_39% - نسبة الرطوبة على سبيل المثال. 70
%ftempmax_00% إلى %ftempmax_39% - درجة الحرارة القصوى على سبيل المثال. 16
%ftempmin_00% إلى %ftempmin_39% - درجة الحرارة الدنيا على سبيل المثال. 15
%fground_00% إلى %fground_39% - ضغط مستوى الأرض بالملليبار على سبيل المثال. 928
%fsea_00% إلى %fsea_39% - ضغط مستوى سطح البحر بالملليبار على سبيل المثال. 1007
%fdesc_00% إلى %fdesc_39% - وصف الطقس على سبيل المثال. مطر خفيف
%fmaindesc_00% إلى %fmaindesc_39% - الوصف الرئيسي للطقس على سبيل المثال. مطر
%fdescem_00% إلى %fdescem_39% - وصف الطقس الرموز التعبيرية على سبيل المثال. ?️
%ficonurl_00% إلى %ficonurl_39% - عنوان URL لرمز الطقس على سبيل المثال. https://openweathermap.org/img/wn/10d.png
%ficonurl2x_00% إلى %ficonurl2x_39% - عنوان URL لرمز الطقس مزدوج الحجم، على سبيل المثال. https://openweathermap.org/img/wn/[email protected]
%fwindspeed_00% إلى %fwindspeed_39% - سرعة الرياح بالأميال في الساعة على سبيل المثال. 7
%fwindspeedms_00% إلى %fwindspeedms_39% - سرعة الرياح بالأمتار في الثانية على سبيل المثال. 2
%fwinddeg_00% إلى %fwinddeg_39% - اتجاه الرياح بالدرجات على سبيل المثال. 198
%fwinddir_00% إلى %fwinddir_39% - اتجاه الرياح على سبيل المثال. جنوب
%fwindgust_00% إلى %fwindgust_39% - هبوب الرياح ميلا في الساعة على سبيل المثال. 7
%fwindgustms_00% إلى %fwindgustms_39% - هبوب الرياح متر في الثانية على سبيل المثال. 2
%next12% - قائمة التوقعات للـ 12 ساعة القادمة على سبيل المثال...
%next24% - قائمة التوقعات للـ 24 ساعة القادمة على سبيل المثال...
%next48% - قائمة التوقعات للـ 48 ساعة القادمة على سبيل المثال...
%icon% و %icon2x% - يتم استبدال هذا بعلامة الصورة <img src={Icon Url} /> ويكون هذا أكثر فائدة إذا كان مضمنًا داخل مقطع كود div.
%wind-gust% يتم إرجاع هذه البيانات فقط بواسطة واجهة برمجة التطبيقات (API) في حالة وجود الشرط. ولجعل هذا يعرض بيانات السلسلة فقط عندما تكون موجودة، يمكنك إحاطتها برموز الإقحام.
على سبيل المثال: Winds %wind-speed% km/h^ with gusts up to %wind-gust% km/h^
مع بيانات هبوب الرياح، سيتم تحويل ذلك إلى: Winds 10 km/h with gusts up to 20 km/h
بدون بيانات عاصفة الرياح، سيتم تحويل هذا إلى: Winds 10 km/h (ستتم إزالة النص المحاط بعلامات الإقحام)
OpenWeather: Insert weather string one - إدراج سلسلة الطقس الأولى في المستند الحالي.OpenWeather: Insert weather string two - إدراج سلسلة الطقس الثانية في المستند الحالي.OpenWeather: Insert weather string three - إدراج سلسلة الطقس الثالثة في المستند الحالي.OpenWeather: Insert weather string four - إدراج سلسلة الطقس الرابعة في المستند الحالي.OpenWeather: Replace template string - سيؤدي هذا إلى استبدال جميع تكرارات السلاسل %weather1% و %weather2% و %weather3% و %weather4% بسلاسل الطقس المحددة المقابلة. انظر أيضًا دعم القالب يمكنك وضع السلاسل التالية في القوالب الخاصة بك وعند إنشاء مستند جديد باستخدام القالب، سيتم استبدالها تلقائيًا بسلاسل الطقس المقابلة.
%weather1% - يُدرج سلسلة الطقس الأولى%weather2% - لإدراج سلسلة الطقس الثانية%weather3% - يُدرج سلسلة الطقس الثالثة%weather4% - يُدرج سلسلة الطقس الرابعة يمكنك إدراج DIV التالي داخل مستنداتك لتوفير الطقس الديناميكي الذي يتم تحديثه بالتردد المحدد في إعدادات تحديث التردد . weather_historical_3 هي درجة الحرارة الثابتة في وقت إنشاء المستند و weather_current_1 ديناميكي. راجع EXAMPLE.md للحصول على عرض توضيحي لكيفية استخدام هذه العناصر في النموذج اليومي الخاص بي.
< div class =" weather_historical_3 " > %weather3% </ div >
< div class =" weather_current_1 " > </ div >يمكنك استخدام الفصل التالي لإدراج سلاسل الطقس المقابلة
و...
