معطيات
شروط إعادة الاستخدام
قاعدة بيانات Open Food Facts متاحة بموجب ترخيص قاعدة البيانات المفتوحة.
محتويات قاعدة البيانات الفردية متاحة بموجب ترخيص محتويات قاعدة البيانات.
صور المنتجات متاحة بموجب ترخيص المشاع الإبداعي النسب بالمثل.
قد تحتوي على عناصر رسومية تخضع لحقوق الطبع والنشر أو حقوق أخرى، التي قد يتم إعادة إنتاجها في بعض الحالات (حقوق الاقتباس أو الاستخدام العادل).
يرجى قراءة شروط وأحكام الاستخدام وإعادة الاستخدام قبل إعادة استخدام البيانات.
أخبرنا عن إعادة استخدامك
نحن مهتمون جدًا بمعرفة كيفية استخدام بيانات Open Food Facts. ليس إلزاميًا، ولكننا نقدر ذلك كثيرًا إذا أخبرتنا عن إعادة استخداماتك حتى نتمكن من مشاركتها مع مجتمع Open Food Facts. يمكنك أيضًا ملء هذا النموذج للحصول على فرصة لعرض تطبيقك.
تصديرات بيانات Open Food Facts
يتم إنشاء تفريغات قاعدة البيانات والتصديرات كل ليلة. قاعدة البيانات كبيرة جدًا، لذا يمكنك العثور على طرق مختلفة لاستخدام البيانات، اعتمادًا على نوع التصدير.
معلومات حول الحقول المختلفة لتفريغ MongoDB وتصديرات CSV متوفرة على https://world.openfoodfacts.org/data/data-fields.txt
تفريغ MongoDB
البيانات الخاصة بجميع المنتجات متوفرة في تفريغ قاعدة بيانات MongoDB.
- رابط
- https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.gz
- sha256sum
- https://static.openfoodfacts.org/data/gz-sha256sum
- md5sum
- https://static.openfoodfacts.org/data/gz-md5sum
Delta Export
يتم توفير تصديرات الدلتا اليومية للأيام الـ 14 السابقة. قائمة ملفات الدلتا المتوفرة حاليًا يمكن العثور عليها على https://static.openfoodfacts.org/data/delta/index.txt.
كل سطر يمثل ملفًا متوفرًا على https://static.openfoodfacts.org/data/delta/{filename}
.
.
يرجى ملاحظة أنه بسبب طبيعة mongoexport
، لا يمكن لملفات الدلتا إخبارك عن المنتجات المحذوفة. لإزالة المنتجات المحذوفة من قاعدة بياناتك، ستحتاج إلى استيراد تفريغ MongoDB الكامل.
تصدير بيانات JSONL
قاعدة البيانات الكاملة متوفرة أيضًا بصيغة JSONL (التي تُسمى أحيانًا LDJSON أو NDJSON) حيث يكون كل سطر هو كائن JSON. يمثل نفس البيانات كما في تصدير MongoDB. الملف مضغوط باستخدام gzip.
طريقة مناسبة لاستغلال قاعدة البيانات هي استخدام DuckDB، وهو أداة تحليلية تعمل ضمن العملية مصممة لمعالجة كميات كبيرة من البيانات في جزء من الثانية. يمكنك قراءة مقال المدونة حيث نشرح لك كيفية استكشاف ومعالجة قاعدة بيانات Open Food Facts باستخدام DuckDB
تصدير بيانات Parquet على Hugging Face
إصدار مبسط من تفريغ الـJSONL أيضاً في تنسيق الباركيه. خلال التحويل, صَفَّيّنا الأعمدة التي تحتوي على معلومات متكررة, تستخدم لتصحيح أخطاء داخلية, أو هي فقط عَرَضِيّة للمستخدمين.
لقد أثبت تنسيق الباركيه أنه مفيد:
- يتم تنظيم البيانات حسب العمود، وليس حسب الصف، مما يوفر مساحة التخزين ويسرع استعلامات التحليلات، أي أنه يمكنك تحديد الأعمدة التي تهمك فقط، مما يؤدي إلى تحسين أداء الاستعلامات، حتى على أجهزة الكمبيوتر الأساسية.
- ضغط البيانات وفك ضغطها بكفاءة عالية، مما يجعلها جيدة لتخزين ومشاركة مجموعات البيانات الكبيرة من أي نوع،
- يدعم أنواع البيانات المعقدة وهياكل البيانات المتداخلة المتقدمة.
تتوفر مجموعة البيانات على Hugging Face، وهو نظام بيئي تعاوني للتعلم الآلي حيث يمكن للمطورين والباحثين مشاركة النماذج ومجموعات البيانات.
يمكنك العثور على مزيد من المعلومات في Wiki، بما في ذلك إرشادات إعادة استخدام البيانات وأمثلة الاستعلامات للبدء.تصدير بيانات CSV
يمكن تنزيل بيانات جميع المنتجات، أو بعض المنتجات، بتنسيق CSV (قابل للقراءة باستخدام LibreOffice وExcel والعديد من برامج جداول البيانات الأخرى) من خلال نموذج البحث المتقدم .
- الروابط
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (ملف CSV مضغوط بتنسيق GZIP: ~ 0.9 جيجابايت، غير مضغوط: ~ 9 جيجابايت)
ترميز الملف هو Unicode UTF-8. الرمز الذي يفصل الحقول هو <tab> (الجدولة).
تصدير بيانات RDF
قاعدة البيانات متاحة أيضًا بتنسيق RDF. يمكنك قراءة الإعلان باللغة الفرنسية.
تصدير بيانات الصورة
يمكن تنزيل جميع الصور ونتائج التعرف الضوئي على الحروف (OCR) من خادمنا أو من AWS (من خلال برنامج AWS Open Data). قم بإلقاء نظرة على وثائقنا لمعرفة المزيد حول كيفية تنزيل الصور.
OpenAPI Documentation for the JSON API
تتوفر أيضًا واجهة برمجة تطبيقات JSON لقراءة البيانات الخاصة بمنتج ما. يتم استخدام واجهة برمجة التطبيقات هذه على وجه الخصوص في تطبيق Open Food Facts للجوال لأجهزة iPhone وAndroid.
نعمل على تحسين واجهة برمجة التطبيقات (API) بمرور الوقت ولكننا نحرص على الحفاظ على التوافق مع الإصدارات السابقة. يرجى التواصل معنا إذا كنت تستخدمه، حتى نتمكن من إخبارك بالتغييرات المحتملة.
رابط لقراءة البيانات الخاصة بالمنتج: https://world.openfoodfacts.org/api/v2/product/[رمز شريطي].json
مثال: https://world.openfoodfacts.org/api/v3/product/737628064502.json
لاحظ أنه إذا كان الناتج كبيرًا جدًا، فيمكنك تصفيته - كما هو موضح في وثائق واجهة برمجة التطبيقات.
مطلوب مساعدة في OpenAPI
نحن حريصون على الانتهاء من توثيق واجهة برمجة التطبيقات، وإضافة حالات الاستخدام، وأتمتة إنشاء مجموعة أدوات التطوير البرمجية (SDK). إذا كنت من خبراء OpenAPI، فنحن نرحب بك كثيرًا للمساعدة.مرحبًا بك كثيرًا لاستخدام واجهة برمجة التطبيقات (API) لحالات الإنتاج، طالما أن مكالمة API واحدة = مسح حقيقي واحد بواسطة مستخدم. من المحتمل جدًا أن يتم حظر أي محاولة لجمع قاعدة البيانات باستخدام واجهة برمجة التطبيقات، حيث تتوفر الصادرات اليومية الكاملة على هذه الصفحة ذاتها.
بالإضافة إلى ذلك، فإن إرسال رأس HTTP مع استدعاء API الخاص بك يعد طريقة جيدة يمكننا من خلالها التواصل معك في حالة ظهور أي مشكلة.
إذا لم تكن متأكدًا من أي شيء، أو لديك أي سؤال (لا يوجد سؤال سخيف)، فلا تتردد في طرحه على قناة #api على Slack :-)
واجهة برمجة تطبيقات XML التجريبية
يمكنك أيضًا الحصول على النتيجة بصيغة XML باستخدام .xml
مثال: https://world.openfoodfacts.org/api/v2/product/737628064502.xml
لا يتم صيانة هذه الواجهة البرمجية بشكل نشط، كما أنها غير موثقة رسميًا.التغليفات ومجموعات تطوير البرامج
ربما لدينا غلافًا للغة البرمجة المفضلة لديك. إذا فعلنا ذلك، فيمكنك استخدامه وتحسينه. إذا لم نفعل ذلك، فيمكنك المساعدة في إنشائه.
سيسمحون لك باستهلاك البيانات، فضلاً عن السماح لمستخدميك بالمساهمة ببيانات جديدة
المبادئ العامة لإسعاد المستخدمين
- يمكنك البحث عن معلومات حول المنتجات، بما في ذلك العديد من القيم المحسوبة المفيدة.
- إذا لم تتمكن من الحصول على المعلومات حول منتج معين، فيمكنك جعل المستخدم يرسل الصور والبيانات، والتي سيتم معالجتها بعد ذلك بواسطة Open Food Facts AI والمساهمين للحصول على النتيجة المحسوبة التي تريد إظهارها لهم.
- يمكنك أيضًا تنفيذ التدفق الكامل حتى يحصلوا على النتيجة فورًا مع بذل بعض الجهد من جانبهم.
إذا لم يتوقع المستخدمون الحصول على نتيجة فورية (على سبيل المثال تطبيقات المخزون)
- إرسال الصور (الواجهة/التغذية/المكونات): الشيء الأكثر سهولة بالنسبة لمستخدميك
- سيقوم الذكاء الاصطناعي Open Food Facts - Robotoff - بإنشاء بعض البيانات المشتقة من الصور
- بمرور الوقت، ستعمل التطبيقات الأخرى ومجتمع Open Food Facts على سد فجوات البيانات
إذا كان المستخدمون يتوقعون الحصول على نتيجة على الفور (على سبيل المثال تطبيقات التغذية)
- أرسل معلومات التغذية + الفئة > احصل على Nutri-Score
- أرسل المكونات > احصل على مجموعة NOVA (حول المعالجة الفائقة للأطعمة)، المواد المضافة، المواد المسببة للحساسية، المكونات الطبيعية، نباتي، نباتي تمامًا…
- أرسل الفئة + العلامات > احصل قريبًا على النتيجة البيئية (حول التأثير البيئي)
Android/iPhone/Flutter mobile app
The code for the official Open Food Facts mobile apps is available on GitHub Flutter Kotlin Android Swift iOS
We look to turn the deprecated Kotlin and Swift codebases into Kotlin and Swift SDKs, help welcome :-)
يتيح التطبيق للمستخدمين مسح الرمز الشريطي للمنتجات، وعرض معلومات المنتج، والتقاط الصور والبيانات الخاصة بالمنتجات المفقودة وإرسالها.
نرحب بك لإعادة استخدام الكود (إنه مفتوح المصدر) ومساعدتنا في تحسينه، للجميع، في جميع أنحاء الكوكب.
حزم تطوير البرامج (SDK)
- كوردوفا: GitHub (تطبيق Open Food Facts الرسمي القديم)
- دارت: GitHub - الحزمة على pub.dev
- الإكسير: GitHub - قناة المناقشة
- قو: GitHub - قناة المناقشة
- جافا: GitHub - قناة المناقشة
- كوتلن: GitHub - قناة المناقشة
- نود جي أس: GitHub - قناة المناقشة
- بي اتش بي: GitHub - قناة المناقشة
- بي اتش بي (لارافِل): GitHub - قناة المناقشة
- بايثون: GitHub - قناة المناقشة
- رياكت محلي: GitHub - قناة المناقشة
- روبي: GitHub - قناة المناقشة
- رَست: GitHub - قناة المناقشة
- ار: GitHub - قناة المناقشة
- سوِفت: GitHub - قناة المناقشة
- .نت/سي شارب: GitHub - قناة المناقشة
مناقشة البيانات وواجهة برمجة التطبيقات والصادرات
يمكنك إلقاء نظرة على الأسئلة الشائعة الشائعة حول واجهة برمجة التطبيقات وتصدير البيانات و الأسئلة الشائعة حول Open Food Facts
يمكنك الانضمام إلى غرفة الدردشة الخاصة بـ Open Food Facts على Slack وهي الطريقة المفضلة لطرح الأسئلة ومناقشة واجهة برمجة التطبيقات. من فضلك اطرح أسئلتك في قناة #api
يمكنك فتح موضوع على مستودع وثائق واجهة برمجة التطبيقات الخاص بنا
لأي سؤال بخصوص البيانات، يمكنك الاتصال بنا على reuse@openfoodfacts.org