معطيات
شروط إعادة الاستخدام
قاعدة بيانات 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 والعديد من برامج جداول البيانات الأخرى) من خلال نموذج البحث المتقدم .
- الروابط
- Food: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)
- Cosmetics: https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz
- Pet Food: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz
- All other products: https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz
ترميز الملف هو Unicode UTF-8. الرمز الذي يفصل الحقول هو <tab> (الجدولة).
تصدير بيانات RDF
The database is also available in the RDF format (this is an experiment, not actively maintained anymore). يمكنك قراءة الإعلان باللغة الفرنسية.
تصدير بيانات الصورة
يمكن تنزيل جميع الصور ونتائج التعرف الضوئي على الحروف (OCR) من خادمنا أو من AWS (من خلال برنامج AWS Open Data). Check out our documentation to learn more about how to download images
OpenAPI Documentation for the JSON API
تتوفر أيضًا واجهة برمجة تطبيقات JSON لقراءة البيانات الخاصة بمنتج ما. This API is in particular used in the Open Food Facts mobile app.
نعمل على تحسين واجهة برمجة التطبيقات (API) بمرور الوقت ولكننا نحرص على الحفاظ على التوافق مع الإصدارات السابقة. يرجى التواصل معنا إذا كنت تستخدمه، حتى نتمكن من إخبارك بالتغييرات المحتملة.
Discover our APIContributing to improving our API and OpenAPI documentation
We're eager to finish the documentation of the API, add use-cases, and automate SDK generation. If you are an OpenAPI connoisseur, you are very welcome to help.
You are very welcome to use the API for production cases, as long as 1 API call = 1 real scan by a user. Any attempt to scrape the database using the API will very likely be blocked, as full daily exports are available on this very page.
Also, sending an HTTP header with your API call is a good way we can get in touch, should any issue arise.
XML API (unsupported)
يمكنك أيضًا الحصول على النتيجة بصيغة 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)
Icon | Language / Framework | Resources | Discussion |
---|---|---|---|
Cordova (Old App) | GitHub | N/A | |
DART | GitHub pub.dev | N/A | |
Elixir | GitHub | Slack Channel | |
Go | GitHub | Slack Channel | |
Java | GitHub | Slack Channel | |
Spring Boot | GitHub | Slack Channel | |
Kotlin | GitHub | Slack Channel | |
NodeJS | GitHub | Slack Channel | |
PHP | GitHub | Slack Channel | |
PHP (Laravel) | GitHub | Slack Channel | |
Python | GitHub | Slack Channel | |
React Native | GitHub | Slack Channel | |
Ruby | GitHub | Slack Channel | |
Rust | GitHub | Slack Channel | |
R | GitHub | Slack Channel | |
Swift | GitHub | Slack Channel | |
.NET/C# | GitHub | Slack Channel |
مناقشة البيانات وواجهة برمجة التطبيقات والصادرات
يمكنك إلقاء نظرة على الأسئلة الشائعة الشائعة حول واجهة برمجة التطبيقات وتصدير البيانات و الأسئلة الشائعة حول Open Food Facts
يمكنك الانضمام إلى غرفة الدردشة الخاصة بـ Open Food Facts على Slack وهي الطريقة المفضلة لطرح الأسئلة ومناقشة واجهة برمجة التطبيقات. من فضلك اطرح أسئلتك في قناة #api
You can open a thread on our API documentation repository
لأي سؤال بخصوص البيانات، يمكنك الاتصال بنا على reuse@openfoodfacts.org