معطيات

شروط إعادة الاستخدام

قاعدة بيانات Open Products Facts متاحة تحت رخصة قاعدة البيانات المفتوحة.
المحتويات الفردية لقاعدة البيانات متاحة تحت رخصة محتويات قاعدة البيانات.
تكون صور المنتجات متاحة تحت رخصة المشاع الإبداعي في إسناد الأسهم الشبيهة. قد تحتوي على عناصر رسومية تخضع لحقوق الطبع والنشر أو حقوق أخرى، التي قد يتم إعادة إنتاجها في بعض الحالات (حقوق الاقتباس أو الاستخدام العادل).

يرجى قراءة شروط وأحكام الاستخدام وإعادة الاستخدام قبل إعادة استخدام البيانات.

أخبرنا عن إعادة استخدامك

نحن مهتمون جداً بمعرفة الغرض من استخدام بيانات حقائق المنتجات المفتوحة. It is not mandatory, but we would very much appreciate it if you tell us about your re-uses so that we can share them with the Open Products Facts community. يمكنك أيضًا ملء هذا النموذج للحصول على فرصة لعرض تطبيقك.

تصدير بيانات حقائق المنتجات المفتوحة

يتم إنشاء تفريغات قاعدة البيانات والتصديرات كل ليلة. قاعدة البيانات كبيرة جدًا، لذا يمكنك العثور على طرق مختلفة لاستخدام البيانات، اعتمادًا على نوع التصدير.

تتوفر معلومات حول الحقول المختلفة لملفات MongoDB المصدرة بصيغة CSV على الرابط التالي: https://world.openproductsfacts.org/data/data-fields.txt

تفريغ MongoDB

البيانات الخاصة بجميع المنتجات متوفرة في تفريغ قاعدة بيانات MongoDB.

رابط

https://static.openproductsfacts.org/data/openproductsfacts-mongodbdump.gz

sha256sum

https://static.openproductsfacts.org/data/gz-sha256sum

md5sum

https://static.openproductsfacts.org/data/gz-md5sum

تصدير دلتا

يتم توفير تصديرات الدلتا اليومية للأيام الـ 14 السابقة. The list of currently available delta files can be found at https://static.openproductsfacts.org/data/delta/index.txt.

The list of currently available delta files can be found at https://static.openproductsfacts.org/data/delta/index.txt.

يحتوي اسم الملف على طابع زمني UNIX لأول وآخر تغيير موجود في ملف JSON، بحيث يمكن استيراد ملفات دلتا (بعد الاستخراج) باستخدام mongoimport بالترتيب الأبجدي.

يرجى ملاحظة أنه بسبب طبيعة mongoexport، لا يمكن لملفات الدلتا إخبارك عن المنتجات المحذوفة. لإزالة المنتجات المحذوفة من قاعدة بياناتك، ستحتاج إلى استيراد تفريغ MongoDB الكامل.

تصدير بيانات JSONL

قاعدة البيانات الكاملة متوفرة أيضًا بصيغة JSONL (التي تُسمى أحيانًا LDJSON أو NDJSON) حيث يكون كل سطر هو كائن JSON. يمثل نفس البيانات كما في تصدير MongoDB. الملف مضغوط باستخدام gzip.

رابط

https://static.openproductsfacts.org/data/openproductsfacts-products.jsonl.gz

طريقة مناسبة لاستغلال قاعدة البيانات هي استخدام DuckDB، وهو أداة تحليلية تعمل ضمن العملية مصممة لمعالجة كميات كبيرة من البيانات في جزء من الثانية. يمكنك قراءة مقالنا على المدونة حيث نشرح لك كيفية استكشاف قاعدة بيانات حقائق المنتجات المفتوحة ومعالجتها باستخدام DuckDB

تصدير بيانات Parquet على Hugging Face

إصدار مبسط من تفريغ الـJSONL أيضاً في تنسيق الباركيه. خلال التحويل, صَفَّيّنا الأعمدة التي تحتوي على معلومات متكررة, تستخدم لتصحيح أخطاء داخلية, أو هي فقط عَرَضِيّة للمستخدمين.

لقد أثبت تنسيق الباركيه أنه مفيد:

• يتم تنظيم البيانات حسب العمود، وليس حسب الصف، مما يوفر مساحة التخزين ويسرع استعلامات التحليلات، أي أنه يمكنك تحديد الأعمدة التي تهمك فقط، مما يؤدي إلى تحسين أداء الاستعلامات، حتى على أجهزة الكمبيوتر الأساسية.
• ضغط البيانات وفك ضغطها بكفاءة عالية، مما يجعلها جيدة لتخزين ومشاركة مجموعات البيانات الكبيرة من أي نوع،
• يدعم أنواع البيانات المعقدة وهياكل البيانات المتداخلة المتقدمة.

تتوفر مجموعة البيانات على Hugging Face، وهو نظام بيئي تعاوني للتعلم الآلي حيث يمكن للمطورين والباحثين مشاركة النماذج ومجموعات البيانات.

رابط

https://huggingface.co/datasets/openfoodfacts/product-database/resolve/main/food.parquet?download=true

يمكنك العثور على مزيد من المعلومات في Wiki، بما في ذلك إرشادات إعادة استخدام البيانات وأمثلة الاستعلامات للبدء.

تصدير بيانات CSV

Data for all products, or some of the products, can be downloaded in CSV format (readable with OpenOffice, Excel and many other software) through the advanced search form.

الروابط

https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz (ملف CSV مضغوط بصيغة GZIP: ~ 0.9 جيجابايت، غير مضغوط: ~ 9 جيجابايت)

ترميز الملف هو Unicode UTF-8. الرمز الذي يفصل الحقول هو <tab> (الجدولة).

تصدير بيانات RDF

قاعدة البيانات متاحة أيضًا بتنسيق RDF. يمكنك قراءة الإعلان باللغة الفرنسية.

رابط

https://world.openproductsfacts.org/data/en.openproductsfacts.org.products.rdf.gz

تصدير بيانات الصورة

يمكن تنزيل جميع الصور ونتائج التعرف الضوئي على الحروف (OCR) من خادمنا أو من AWS (من خلال برنامج AWS Open Data). قم بإلقاء نظرة على وثائقنا لمعرفة المزيد حول كيفية تنزيل الصور.

OpenAPI Documentation for the JSON API

تتوفر أيضًا واجهة برمجة تطبيقات JSON لقراءة البيانات الخاصة بمنتج ما. تُستخدم واجهة برمجة التطبيقات هذه بشكل خاص في تطبيق Open Products Facts للهواتف المحمولة لأجهزة iPhone و Android.

نعمل على تحسين واجهة برمجة التطبيقات (API) بمرور الوقت ولكننا نحرص على الحفاظ على التوافق مع الإصدارات السابقة. Please tell us if you use it, so that we can tell you about potential changes.

URL to read data for a product: https://world.openproductsfacts.org/api/v2/product/[barcode].json

Example: https://world.openproductsfacts.org/api/v2/product/8710847992063.json

لاحظ أنه إذا كان الناتج كبيرًا جدًا، فيمكنك تصفيته - كما هو موضح في وثائق واجهة برمجة التطبيقات.

• واجهة برمجة التطبيقات الإصدار 3 - وثائق OpenAPI الجديدة - العمل جارٍ

مطلوب مساعدة في OpenAPI

نحن مشتاقين لإنهاء توثيق الـAPI, إضافة حالات الاستخدام, وأتمتة إنشاء الـSDK. إذا انت خبير في OpenAPI, فنرحب بك ترحيباً كثيرا لمساعدتنا.

مرحبًا بك كثيرًا لاستخدام الـAPI لحالات الإنتاج، طالما أن مكالمة API واحدة = مسح حقيقي واحد بواسطة مستخدم. أي محاولة لجمع قاعدة البيانات باستخدام واجهة برمجة التطبيقات ستُحظر على الأرجح، حيث تتوفر عمليات التصدير اليومية الكاملة في هذه الصفحة.

أيضًا ، إرسال رأس HTTP مع طلب API الخاص بك هو طريقة جيدة يمكننا من خلالها التواصل ، في حالة حدوث أي مشكلة.

إذا لم تكن متأكدًا من أي شيء، أو لديك أي سؤال (لا يوجد سؤال سخيف)، فلا تتردد في طرحه على قناة #api على Slack :-)

واجهة برمجة تطبيقات XML التجريبية

يمكنك أيضًا الحصول على النتيجة بصيغة XML باستخدام .xml

جهة الاتصال

لا يتم صيانة هذه الواجهة البرمجية بشكل نشط، كما أنها غير موثقة رسميًا.

التغليفات ومجموعات تطوير البرامج

ربما لدينا غلافًا للغة البرمجة المفضلة لديك. إذا فعلنا ذلك، فيمكنك استخدامه وتحسينه. إذا لم نفعل ذلك، فيمكنك المساعدة في إنشائه.

سيسمحون لك باستهلاك البيانات، فضلاً عن السماح لمستخدميك بالمساهمة ببيانات جديدة

المبادئ العامة لإسعاد المستخدمين

• يمكنك البحث عن معلومات حول المنتجات، بما في ذلك العديد من القيم المحسوبة المفيدة.
• إذا لم تتمكن من الحصول على معلومات حول منتج معين، يمكنك أن تطلب من المستخدم إرسال الصور والبيانات، والتي ستتم معالجتها بعد ذلك بواسطة Open Products Facts AI والمساهمين للحصول على النتيجة المحسوبة التي تريد عرضها لهم.
• يمكنك أيضًا تنفيذ التدفق الكامل حتى يحصلوا على النتيجة فورًا مع بذل بعض الجهد من جانبهم.

إذا لم يتوقع المستخدمون الحصول على نتيجة فورية (على سبيل المثال تطبيقات المخزون)

• إرسال الصور (الواجهة/التغذية/المكونات): الشيء الأكثر سهولة بالنسبة لمستخدميك
• سيقوم برنامج Open Products Facts AI - Robotoff - بتوليد بعض البيانات المشتقة من الصور
• بمرور الوقت، ستعمل تطبيقات أخرى ومجتمع حقائق المنتجات المفتوحة على سد فجوات البيانات

إذا كان المستخدمون يتوقعون نتيجة فورية (مثل تطبيقات التغذية أو الحساسية)

• إرسال المكونات + الفئة > الحصول على تحليل المكونات، والإضافات، والمواد المسببة للحساسية، والمكونات المعيارية، ونباتي، ونباتي صرف…
• أضف ملصقات لتحقيق قيمة مضافة
• إرسال معلومات التغذية

Android/iPhone/Flutter mobile app

The new cross-platform app is developed in Flutter/Dart.

We look to turn the deprecated Kotlin and Swift codebases into Kotlin and Swift SDKs, help welcome :-)

يتيح التطبيق للمستخدمين مسح الرمز الشريطي للمنتجات، وعرض معلومات المنتج، والتقاط الصور والبيانات الخاصة بالمنتجات المفقودة وإرسالها.

نرحب بك لإعادة استخدام الكود (إنه مفتوح المصدر) ومساعدتنا في تحسينه، للجميع، في جميع أنحاء الكوكب.

حزم تطوير البرامج (SDK)

الرمز	لغة / إطار عمل	الموارد	المناقشة
	كوردوفا (التطبيق القديم)	GitHub	غير متوفر
	DART	GitHub pub.dev	غير متوفر
	Elixir	GitHub	قناة Slack
	Go	GitHub	قناة Slack
	Java	GitHub	قناة Slack
	Spring Boot	GitHub	قناة Slack
	Kotlin	GitHub	قناة Slack
	جافا سكريبت	GitHub	قناة Slack
	PHP	GitHub	قناة Slack
	PHP (Laravel)	GitHub	قناة Slack
	Python	GitHub	قناة Slack
	React Native	GitHub	قناة Slack
	Ruby	GitHub	قناة Slack
	الصدأ	GitHub	قناة Slack
	R	GitHub	قناة Slack
	Swift	GitHub	قناة Slack
	.NET/C#	GitHub	قناة Slack

مناقشة البيانات وواجهة برمجة التطبيقات والصادرات

يمكنك إلقاء نظرة على الأسئلة الشائعة الشائعة حول واجهة برمجة التطبيقات وتصدير البيانات و الأسئلة الشائعة حول Open Food Facts

يمكنك الانضمام إلى غرفة دردشة Open Products Facts Slack وهي الطريقة المفضلة لطرح الأسئلة ومناقشة واجهة برمجة التطبيقات. من فضلك اطرح أسئلتك في قناة #api

يمكنك فتح موضوع على مستودع وثائق واجهة برمجة التطبيقات الخاص بنا

لأي سؤال بخصوص البيانات، يمكنك الاتصال بنا على reuse@openfoodfacts.org