واجهة المناخ

المناخ اليومي#

المعاملات

هذا ليس التاريخ الساعي مسبوقًا بـ GROUP BY. فالحقول اليومية تُشتق مرة واحدة، عند الإدخال، على حدّ يوم اختير للفيزياء لا للراحة، والحقول المشتقة — الحرارة المحسوسة ومدة السطوع والرطوبة المتوسطة — تُحسب من السلسلة الساعية الكاملة لا من القيم القصوى اليومية.

التجميعات الشهرية#

مجاميع للكميات التراكمية، ومتوسطات وقيم قصوى لما عداها. وبالسعر نفسه للسلسلة اليومية، لأنه يقرأ العمود نفسه.

اطلبها حين يكون الرقم الشهري هو ما ترسمه فعلًا، بدل جلب ثلاثين ضعف البيانات ثم اختزالها بنفسك — فالبطيء هو النقل لا الحساب.

مناخ مكان، في نداء واحد#

المعاملات

كل ما تقوله صفحة مناخ عن موقع، مختزلًا سلفًا: اثنا عشر معدلًا شهريًا، وصف لكل سنة تقويمية كاملة، والأرقام القياسية على الإطلاق مع تواريخ تسجيلها، واتجاه الاحترار بالمربعات الصغرى مع معنويته، ورمز كوپن-غايغر. لأي إحداثية يابسة على الأرض.

daily=true ليست normals?daily=true

وفي هذا الفرق يكمن المعنى. فـنقطة نهاية المعدلات تتوسط على نافذة ثلاثينية للمنظمة العالمية للأرصاد الجوية؛ أما هذه فتتوسط على النافذة التي طلبتها أنت — والأرشيف كله افتراضًا.

وهي السبيل الوحيد لأن تقول «9.4 °م فوق المعتاد لـ 30 يوليو» وخلف العبارة سبع وثمانون سنة لا ثلاثون. ويحمل كل يوم عدد عيّناته، فيصير التوسيع إلى معدل مركزي بخمسة عشر يومًا كتابةً Σ(mean·samples) / Σ(samples) — بالضبط، وبلا طلب ثانٍ.

عرفان يجب معرفتهما قبل المقارنة بمصدر آخر

لا تدخل السنة التقويمية في السلسلة السنوية ولا في الاتجاه إلا إذا حمل الأرشيف 360 يومًا من أيامها على الأقل، فتُستبعد السنة الجارية. فنصف سنة يُقرأ انهيارًا في الهطول ويجرّ معه خط الاتجاه.

وtrends يساوي null دون عشر سنوات كاملة. فدون ذلك لا يكون الميل إلا ضجيج طقس متلبّسًا ثوب إشارة مناخية، ونحن نفضّل ألا ننشر شيئًا على أن ننشر رقمًا خاطئًا بثقة. ولهذا السبب نفسه يحمل كل اتجاه p_value الخاص به وعلامة significant — فاقرأهما قبل أن تستشهد بالميل.

معدلات المنظمة العالمية للأرصاد الجوية#

المعاملات

المعدل ليس متوسط الفترة التي طلبتها اتفاقًا. بل هو متوسط ثلاثيني على نافذة تثبّتها المنظمة العالمية للأرصاد الجوية، حتى يكون شخصان يستشهدان بمعدل مستشهدَين بالشيء نفسه.

وإن كان مرادك «المعدل على السجل كله» لا على نافذة المنظمة، فاستعمل بدلًا من ذلك /v1/climate/summary — فهو لا يتطلب إلا الـ scope climate ويعطيك سبعًا وثمانين سنة بدل ثلاثين.

مقارنة معدلين#

هذا هو السؤال الذي يطرحه أكثر الناس حقًا حين يطلبون معدلًا — لا «ما المعتاد هنا» بل «كم تحرك المعتاد».

والإجابة عنه في طلب واحد تضمن ألا يأتي نصفاه من تشغيلين مختلفين، وهو بالضبط وجه الخلل في حسابه بنفسك من ندائين: فالأرشيف يتقدم بينهما، فيحمل الفرق الذي تنشره تغيّر إصدار إلى جانب تغيّر مناخ.

التغطية والحقول والخلايا#

cells/resolve يجيب عن السؤال الذي ينبغي أن يُسأل لكل منتج شبكي قبل الوثوق به: أي خلية أقرأ فعلًا، وكم تبعد عن النقطة التي سألت عنها؟ فعند 28 كم قد تبلغ تلك المسافة 20 كم، ومعرفتها هي الفرق بين أن تستشهد برقم وأن تستشهد به بمسؤولية.

وfields له العقد نفسه الذي لـ /v1/historical/variables: فهو يسرد ما يحويه التشغيل لا ما قد يحويه المنتج يومًا ما، فلا ينكسر عميل بُني عليه حين يكبر الأرشيف.