Weather Data

المنتزع Weather Data

برنامج نصي PHP أساسي يلتقط Weather Data ويخرجها بتنسيق JSON لاستخدامها في مواقع UCF الأخرى. يستخدم آلية تخزين مؤقت بسيطة تحفظ النتائج التي تم الحصول عليها مسبقًا وتشير إلى الملف المحفوظ في حالة تقديم طلب آخر خلال مدة ذاكرة التخزين المؤقت المحددة. الشروط التي تم استردادها تتعلق بمنطقة أورلاندو، ولكن يمكن تحديثها لمشاريع أخرى عن طريق تعديل ثوابت WEATHER_URL_CURRENT و WEATHER_URL_FORECAST .

تتم كتابة البرنامج النصي حاليًا لقبول بيانات NOAA XML وتحليلها. رموز الشرط للصور هي سلاسل بشكل افتراضي ولكن يتم تحويلها إلى معيار رمز شرط Weather.com/Yahoo (نظرًا لأن معظم مواقعنا تستخدمه بالفعل على أي حال.) تُستخدم رموز الشرط هذه أيضًا لإنشاء عبارة شرطية، بسبب الإعداد الافتراضي عبارات شرط NOAA مطولة للغاية.

يتم توفير روابط لمجموعات الرموز المختلفة داخل الخلاصة؛ img/weather-small/ يحتوي على أيقونات مستخدمة في ucf.edu؛ img/weather-medium/ يحتوي على أيقونات مستخدمة في رسائل البريد الإلكتروني الخاصة بـ GMUCF؛ img/weather-large/ يحتوي على أيقونات مستخدمة في UCF Today.

الاستخدام

يتم إرجاع موجز الظروف الحالية لمنطقة أورلاندو بشكل افتراضي عند طلب ملف Index.php. استخدم data معلمة GET لإرجاع مجموعات مختلفة من البيانات:

• ?data=forecastToday: توقعات اليوم; يشمل الظروف / درجات الحرارة لهذا اليوم والليلة
• ?data=forecastExtened: توقعات 5 أيام، مقسمة إلى أيام ("أيام"، مجمعة في "day1-5")

الظروف الحالية والتوقعات القيم التي تم إرجاعها

SuccessFetch (سلسلة - "successfulCache" سابقًا في الإصدار 1.0.0)

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

مزود (سلسلة)

عنوان URL لموفر Weather Data .

التاريخ (سلسلة)

تاريخ مجموعة معينة من الظروف الجوية. (التنسيق YYYY-MM-DD)

شرط (سلسلة)

عبارة عن حالة الطقس. تعتمد هذه العبارات بشكل فضفاض على أوصاف كود Yahoo Weather API: (http://developer.yahoo.com/weather/#codetable)

رمز الصورة (int)

رمز حالة الحالة، استنادًا إلى رمز الحالة المقدم من NOAA. تتم ترجمة هذا الرمز إلى رمز الحالة الرقمي Weather.com/Yahoo.

imgSmall، imgMedium، imgLarge (سلسلة)

روابط لأيقونات الطقس ذات الصلة. img/weather-small/ يحتوي على أيقونات مستخدمة في ucf.edu؛ img/weather-medium/ يحتوي على أيقونات مستخدمة في رسائل البريد الإلكتروني الخاصة بـ GMUCF؛ img/weather-large/ يحتوي على أيقونات مستخدمة في UCF Today.

مخبأة (سلسلة)

الطابع الزمني الذي تم فيه تخزين مجموعة Weather Data هذه آخر مرة.

تغذية محدثة (سلسلة)

الطابع الزمني الذي قام فيه موفر الخلاصة (NOAA) بتحديث محتوى الخلاصة الخاص به آخر مرة.

الظروف الحالية، توقعات اليوم تم إرجاع القيم

درجة الحرارة (سلسلة)

قراءة درجة الحرارة الحالية. (يتضمن رمز الدرجة)

درجة الحرارة (كثافة العمليات)

قراءة درجة الحرارة الحالية. (لا يشمل رمز الدرجة)

القيم التي تم إرجاعها للتنبؤ الممتد (لكل "يوم")

تيمماكس (سلسلة)

أقصى درجة حرارة متوقعة لذلك اليوم. (يتضمن رمز الدرجة)

تيمماكسن (كثافة العمليات)

أقصى درجة حرارة متوقعة لذلك اليوم. (لا يشمل رمز الدرجة)

درجة الحرارة (سلسلة)

أدنى درجة حرارة متوقعة لهذا اليوم. (يتضمن رمز الدرجة.) لاحظ أن درجة الحرارة "day7" لا توفرها الإدارة الوطنية للمحيطات والغلاف الجوي (NOAA).

درجة الحرارة (كثافة العمليات)

أدنى درجة حرارة متوقعة لهذا اليوم. (لا يتضمن رمز الدرجة.)

ملحوظات

• من المتوقع أن تقوم المواقع التي تستخدم هذه الخدمة بتخزين النتائج مؤقتًا من نهايتها. يجب أن يتم طلب البيانات فقط من هذا البرنامج النصي في فترة زمنية محددة. لن تؤدي إعادة طلب هذه الخدمة إلى جلب محتوى جديد إلا بعد مرور فترة التخزين المؤقت المحددة.
• يجب على المواقع التي تستخدم هذه الخدمة التحقق من قيم البيانات الشرعية قبل عرض بيانات الخلاصة للمستخدم. حتى إذا تم تعيين قيمة "successfulFetch" على "لا"، فقد يتم إرجاع البيانات الجزئية. تمت إزالة القيم الاحتياطية الافتراضية اعتبارًا من الإصدار 1.1.3.
• يتم تحديث ذاكرة التخزين المؤقت ببيانات جديدة فقط عند انتهاء صلاحية البيانات المخزنة مؤقتًا القديمة، ويتم الحصول على مجموعة البيانات التي تم الحصول عليها حديثًا بنجاح. سيستمر هذا البرنامج النصي في عرض البيانات القديمة الجيدة حتى يتم تنفيذ عملية جلب بيانات ناجحة أخرى، طالما تم استرداد تلك البيانات القديمة في نفس اليوم.
• لاحظ أن الإدارة الوطنية للمحيطات والغلاف الجوي (NOAA) تقوم فقط بتحديث بيانات حالتها الحالية مرة واحدة كل ساعة، أي بعد مرور 45 دقيقة (تقريبًا) على مدار الساعة. تم تعيين البرنامج النصي لأداة التقاط الطقس على تخزين البيانات مؤقتًا لمدة 15 دقيقة.
• اعتبارًا من الإصدار 1.1.9، يستخدم هذا المشروع cURL لجلب بيانات NOAA. يجب أن تكون البيئات التي تقوم بتشغيل هذا المشروع مثبتة عليها libcurl لدعم وظيفة cURL الخاصة بـ PHP. راجع وثائق PHP على cURL لمزيد من المعلومات.