المطوّرون
API بيانات مفتوح
JSON للقراءة فقط على كل محتويات الأطلس. لا مفتاح، ولا حساب، ولا تتبع. كن معتدلاً في حجم الطلبات — إنه خادم صغير.
| نقطة النهاية | العوائد |
|---|---|
/api/v1/materials | كل مادة مع تصنيفها، وعلامة الأهمية الحرجة، والإنتاج العالمي والاحتياطيات. |
/api/v1/material/{slug} | مادة واحدة بشكل كامل: حقائق، معادن، إنتاج واحتياطيات حسب الدولة، مناجم، منشآت، شركات، أسواق نهائية وكثافات. |
/api/v1/production?material={slug}&series= | الإنتاج العالمي حسب الدولة لسلسلة منشورة واحدة. إذا كان لمادة ما أكثر من سلسلة — فللنحاس مثلاً إنتاج المناجم وإنتاج المصافي — فإن meta.all_series يُدرجها جميعاً ولا يجوز إضافتها معاً قط. |
/api/v1/reserves?material={slug}&series= | الاحتياطيات العالمية حسب الدولة لسلسلة واحدة. الكروم مثلاً يُنشر محسوباً على أساس محتوى Cr2O3 وعلى أساس الخام في آنٍ واحد. |
/api/v1/mines | المناجم والرواسب المُسمّاة مع المشغّل والنوع والحالة والموقع والمواد. |
/api/v1/facilities | منشآت المعالجة والتكرير والتصنيع مع بيان المرحلة والنوع والمواد. |
/api/v1/companies | الشركات مع الدور والبلد والمواد — وحيث تتوفر — سعر مؤجّل. |
/api/v1/countries | الدول مع أعداد موادها وأصولها. |
/api/v1/chains | سلاسل الإمداد بكل مراحلها والعقدة التي تشير إليها كل مرحلة. |
/api/v1/journeys?material={slug}&origin={ISO2} | مسارات حيازة المواد: مسار محدد واحد في كل صف، مع كل خطوة وجهة حيازة ومعبر حدودي وميزان الكتلة في كل مرحلة. |
/api/v1/journey/{slug} | رحلة واحدة كاملة، بما فيها المسارات البديلة التي كان يمكن سلوكها. |
/api/v1/technologies | التقنيات مع كثافاتها المادية الاستدلالية وقواعدها. |
/api/v1/glossary | جميع مصطلحات المسرد، بتعريفات مبسّطة وتقنية. |
/api/v1/search?term= | ابحث عبر المواد والمناجم والمنشآت والشركات والدول والمصطلحات. |
الاصطلاحات
- كل استجابة تحتوي على كتلة "مصدر" تُسمّي مجموعة البيانات والإصدار.
- تكون الحقول الرقمية فارغة حين لا يُصدر المصدر أي رقم؛ وعندئذٍ يحمل حقل "الرمز" القيمة W أو XX أو NA أو شرطة، ويشرح حقل "الملاحظة" السبب. القيمة الفارغة لا تعني الصفر قط.
- يحمل كل صف السلسلة التي ينتمي إليها. سلسلتان للمادة ذاتها تقيسان أمرين مختلفين ولا يجوز جمعهما.
- الوحدات لكل صف لا لكل طرف — إذ تُبلَّغ السلع على أسس مختلفة.
- السنوات هي سنوات مرجعية للمصدر، لا تاريخ جلب البيانات.
بيانات USGS الأساسية ملكية عامة؛ استخدمها من المصدر واستشهد بها. تجميعنا ملكنا — يُقدَّر ذكر الرابط. لا شيء مما يُقدَّم هنا يُعدّ نصيحة استثمارية.