مرجع الـ API
ثلاث واجهات بمفتاح واحد. ابدأ بالبطاقة الأولى إن لم تُجرِ أي نداء بعد؛ والبطاقات الثلاث الأخرى هي مرجع نقاط النهاية، مقسّمًا حسب المنتج ليبقى كل جزء قابلًا للبحث وحده.
عناوين URL الأساسية. يُقدَّم الطقس والمناخ من https://api.climatememory.com، ودرجات-اليوم من https://api.climatememory.com. استوثق بترويسة X-API-Key في كل طلب؛ وكل نقاط النهاية من نوع GET.
البداية
أجرِ أول نداء لواجهة Climate Memory في أقل من دقيقة: احصل على مفتاح، واستوثق، وافهم الأرصدة وحدود المعدل، وتعامل مع الأخطاء. الطقس ودرجات-اليوم والمناخ بمفتاح واحد.
11 أقسام ←واجهة الطقس
مرجع كامل لواجهة الطقس: التنبؤ والأحوال الراهنة لأي إحداثية أو مدينة، وكل حقل بوحدته، وتدرّج النماذج من 1.3 كم إلى 28 كم، إضافة إلى المجموعات الاحتمالية وجودة الهواء والثلج والبحر والأنهار.
10 أقسام ←واجهة درجات-اليوم
مرجع كامل لواجهة درجات-اليوم: درجات-يوم التدفئة والتبريد من ERA5-Land منذ 1950، وأي حرارة أساس، وأربع طرائق حساب منها المعيار الفرنسي Costic، وتصدير CSV، والأرشيف الساعي.
12 أقسام ←واجهة المناخ
مرجع كامل لواجهة المناخ: 87 سنة من المناخ اليومي لكل نقطة يابسة على الأرض منذ 1940، وتجميعات شهرية، ومعدلات المنظمة العالمية للأرصاد الجوية 1991–2020 و1961–1990، والأرقام القياسية، واتجاهات الاحترار، وكوپن-غايغر، على شبكة ERA5.
6 أقسام ←كل نقاط النهاية
جدول واحد يضم كل المسارات على المضيفَين، مع تكلفتها وموضع توثيقها. اضغط Ctrl+F هنا، أو / للوحة البحث.
| المسار | الوظيفة | Scope | الأرصدة | موثَّق في | المضيف |
|---|---|---|---|---|---|
/v1/geocode | يحوّل اسم مكان إلى إحداثيات وارتفاع ومنطقة زمنية. | أي مفتاح | 0 | الترميز الجغرافي | api.climatememory.com |
/v1/cities/search | بحث الأسماء القديم. يطابق الاسم اللاتيني فقط ويرتب حسب عدد السكان. | أي مفتاح | 0 | البحث عن المدن | api.climatememory.com |
/v1/cities/nearest | أقرب مدينة مفهرسة إلى إحداثية. | أي مفتاح | 0 | البحث عن المدن | api.climatememory.com |
/v1/attribution | الصياغة المطلوبة بدقة، بصيغة تقرؤها الآلة. دون حاجة إلى مفتاح. | — | 0 | النسبة والترخيص | api.climatememory.com |
/v1/licensing | جدول التراخيص وراء كل مجموعة بيانات. دون حاجة إلى مفتاح. | — | 0 | النسبة والترخيص | api.climatememory.com |
/v1/forecast | تنبؤ ساعي ويومي لأي إحداثية. | meteo | 1 | التنبؤ | api.climatememory.com |
/v1/forecast/city/{country}/{slug} | الاستجابة نفسها، محلولة عبر كتالوج المدن. | meteo | 1 | التنبؤ حسب المدينة | api.climatememory.com |
/v1/current | الأحوال في هذه اللحظة لإحداثية، مستكمَلة بين خطوات النموذج. | meteo | 1 | الأحوال الراهنة | api.climatememory.com |
/v1/current/city/{country}/{slug} | الشيء نفسه، عبر كتالوج المدن. | meteo | 1 | الأحوال الراهنة | api.climatememory.com |
/v1/fields | الجدول نفسه بصيغة JSON، مع الوحدات وبيان الحقول الافتراضية. دون حاجة إلى مفتاح. | — | 0 | مرجع الحقول | api.climatememory.com |
/v1/models | ما النماذج العاملة، وما الذي يغطيه كل منها، وكم هو طازج. دون حاجة إلى مفتاح. | — | 0 | النماذج والاستبانة | api.climatememory.com |
/v1/probability | مئينات واحتمالات مطر من مجموعة ECMWF ذات الـ 51 عضوًا. | meteo | 1 | احتمالات المجموعات | api.climatememory.com |
/v1/air-quality | الجسيمات والأوزون وNO₂ وSO₂ وCO وغبار الصحراء، من Copernicus CAMS. | meteo | 1 | جودة الهواء | api.climatememory.com |
/v1/marine | ارتفاع الموج واتجاهه ودوره من نموذج أمواج ECMWF، في العالم كله، حتى 10 أيام. | meteo | 1 | البحر — حالة البحر | api.climatememory.com |
/v1/hydrology | تصريف الأنهار من Copernicus GloFAS على شبكة أنهار 0.05°، حتى 10 أيام. | meteo | 1 | الأنهار | api.climatememory.com |
/v1/degree-days | درجات-يوم التدفئة والتبريد لإحداثية. | dju | 2، +1 عن كل مدة كاملة من 365.25 يومًا ضمن المجال | درجات-اليوم | api.climatememory.com |
/v1/degree-days?base=15,15.5,18,18.5,20 | حتى 60 حرارة أساس في نداء واحد، بسعر واحدة. | dju | same as one base | أسس كثيرة، طلب واحد، سعر واحد | api.climatememory.com |
/v1/degree-days/compare-methods | الطرائق الأربع كلها على الفترة نفسها، جنبًا إلى جنب. | dju | 2، +1 عن كل مدة كاملة من 365.25 يومًا ضمن المجال | طرائق الحساب | api.climatememory.com |
/v1/methods | تعريفات الطرائق وقيمها الجاهزة. دون حاجة إلى مفتاح. | — | 0 | طرائق الحساب | api.climatememory.com |
/v1/degree-days/city/{country}/{slug} | الشيء نفسه، مع المنطقة الزمنية للمدينة وتصحيح جزيرة حرارتها الحضرية. | dju | 2، +1 عن كل مدة كاملة من 365.25 يومًا ضمن المجال | درجات-اليوم حسب المدينة | api.climatememory.com |
/v1/degree-days?elevation={metres} | تصحيح بمعدل التناقص الحراري من ارتفاع أرض الخلية إلى ارتفاعك. | dju | same | درجات-اليوم لمبناك أنت لا لخلية الشبكة | api.climatememory.com |
/v1/cells/resolve | أي خلية ستجيب عن نقطة، وكم تبعد. | dju | 1 | تثبيت خلية، ليبقى خط الأساس قابلًا للمقارنة | api.climatememory.com |
/v1/degree-days/cell/{cell_id} | درجات-اليوم لخلية مسمّاة — دون أي بحث عن أقرب خلية، أبدًا. | dju | 2، +1 عن كل مدة كاملة من 365.25 يومًا ضمن المجال | تثبيت خلية، ليبقى خط الأساس قابلًا للمقارنة | api.climatememory.com |
/v1/degree-days?breakdown={daily|weekly|monthly|yearly} | جمّع الطلب نفسه إلى الفترة التي يُسوّى عليها عقدك. | dju | same | فترات التفصيل | api.climatememory.com |
/v1/degree-days/monthly | اثنا عشر مجموعًا شهريًا لسنة تقويمية واحدة، بلا سلسلة يومية. | dju | 2 | مجاميع شهرية لسنة | api.climatememory.com |
/v1/coverage | ما يحويه الأرشيف: أول يوم وآخر يوم فيهما بيانات، والمحور الذي سينمو فيه. دون حاجة إلى مفتاح. | — | 0 | مجاميع شهرية لسنة | api.climatememory.com |
/v1/degree-days?format=csv | صفوف التفصيل في ملف CSV. للخطط المدفوعة فقط. | dju | 4× the JSON call | تصدير CSV | api.climatememory.com |
/v1/historical | أرشيف إعادة التحليل مقدَّمًا خامًا: طقس ساعي منذ 1950. | dju | (years + 1) × (variables ÷ 2), rounded down, min 1 | التاريخ الساعي | api.climatememory.com |
/v1/historical/city/{country}/{slug} | مطابق، مع المنطقة الزمنية للمدينة وتصحيح جزيرة الحرارة. | dju | (years + 1) × (variables ÷ 2), rounded down, min 1 | التاريخ حسب المدينة | api.climatememory.com |
/v1/historical/variables | ما يحويه الأرشيف الآن، بوحداته، وأي الحقول مشتقة. دون حاجة إلى مفتاح. | — | 0 | المتغيرات المتاحة | api.climatememory.com |
/v1/climate/daily | ثلاثة عشر حقلًا يوميًا لأي إحداثية يابسة، من 1940 إلى الأسبوع الماضي. | climate | 2، +1 عن كل مدة كاملة من 365.25 يومًا ضمن المجال | المناخ اليومي | api.climatememory.com |
/v1/climate/monthly | الحقول نفسها مجمَّعة حسب الشهر التقويمي. | climate | 2، +1 عن كل مدة كاملة من 365.25 يومًا ضمن المجال | التجميعات الشهرية | api.climatememory.com |
/v1/climate/summary | معدلات شهرية وسلسلة سنوية وأرقام قياسية واتجاهات وكوپن — بلا حدّ للمجال. | climate | 3، +1 عن كل مدة كاملة من 365.25 يومًا ضمن المجال | مناخ مكان، في نداء واحد | api.climatememory.com |
/v1/climate/normals | متوسط ثلاثيني على فترة مرجعية للمنظمة العالمية للأرصاد الجوية. | normals | 3 | معدلات المنظمة العالمية للأرصاد الجوية | api.climatememory.com |
/v1/climate/normals/compare | الفترتان المرجعيتان والفرق بينهما، في نداء واحد. | normals | 6 | مقارنة معدلين | api.climatememory.com |
/v1/climate/coverage | التشغيل المقدَّم والتواريخ التي يغطيها. دون حاجة إلى مفتاح. | — | 1 | التغطية والحقول والخلايا | api.climatememory.com |
/v1/climate/fields | ما يستطيع هذا التشغيل الإجابة عنه، بوحداته، وأي الحقول مشتقة. دون حاجة إلى مفتاح. | — | 1 | التغطية والحقول والخلايا | api.climatememory.com |
/v1/climate/cells/resolve | أي خلية تجيب عن نقطة، وكم تبعد. | climate | 1 | التغطية والحقول والخلايا | api.climatememory.com |
/v1/climate/licensing | شروط ترخيص هذا الأرشيف. دون حاجة إلى مفتاح. | — | 0 | التغطية والحقول والخلايا | api.climatememory.com |
للوكلاء ومساعدي البرمجة
ملفان مولَّدان من المصدر نفسه الذي تُولَّد منه هذه الصفحات، فلا يمكن أن يفترقا عمّا تقرأه:
- /llms.txt — التوجيه المختصر: ما الذي يجيب عنه كل منتج، ومتى تلجأ إلى أيّها.
- /llms-full.txt — هذا المرجع كله في ملف Markdown واحد، بكل نقاط النهاية والمعاملات والتنبيهات.
ينشر كل خدمة أيضًا مخطط OpenAPI 3.1 وواجهة قابلة للتصفح: /v1/openapi-weather.json و/v1/docs/weather، و/v1/openapi-degree-days.json و/v1/docs/degree-days، و/v1/openapi-climate.json و/v1/docs/climate، و/v1/openapi-geocoding.json و/v1/docs/geocoding. ولّد منها عميلًا مكتوب الأنواع بأي لغة بدلًا من كتابته يدويًا.