Veri

Yeniden kullanım koşulları

Open Food Facts veritabanı Açık Veritabanı Lisansı altında kullanılabilir.
Veritabanındaki her bir içerik Veritabanı İçerikleri Lisansı altında kullanılabilir.
Ürün fotoğrafları Creative Commons Attribution ShareAlike lisansı altında kullanılabilir. Bazı durumlarda çoğaltılabilen (alıntı hakkı veya adil kullanım), telif haklarına veya diğer haklara tabi grafiksel ögeler içerebilirler.

Lütfen verileri tekrar kullanmadan önce Kullanım şartlarını ve yeniden kullanım koşullarını okuyunuz.

Bize yeniden kullanımınızdan bahsedin

Open Food Facts verilerinin ne için kullanıldığını öğrenmeye çok meraklıyız. Zorunlu değildir ancak Open Food Facts topluluğuyla paylaşabilmemiz için yeniden kullanımlarınız hakkında bize bilgi verirseniz çok memnun oluruz. Uygulamanızın öne çıkarılması şansını yakalamak için bu formu da doldurabilirsiniz.

Open Food Facts veri dışa aktarımları

Veritabanı dökümleri ve dışa aktarımları her gece yapılır. Veritabanı çok büyük olduğundan, dışa aktarma biçimine bağlı olarak verileri kullanmanın farklı yollarını bulabilirsiniz.

MongoDB dökümü ve CSV dışa aktarımına ilişkin farklı alanlara ilişkin bilgiler https://tr.openfoodfacts.org/data/data-fields.txt adresinde bulunabilir

MongoDB dökümü

Tüm ürünler için veriler MongoDB veritabanı dökümünde mevcuttur.

Link

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 Dışa Aktarım

Günlük delta dışa aktarımlar önceki 14 gün için sağlanmaktadır. Şu anda mevcut olan delta dosyalarının listesi https://static.openfoodfacts.org/data/delta/index.txt adresinde bulunabilir.

Her satır https://static.openfoodfacts.org/data/delta/{filename} adresinde mevcut bir dosyaya karşılık gelmektedir.

Dosya adı, JSON dosyasındaki ilk ve son değişikliğin UNIX zaman damgasını içerir; böylece delta dosyaları mongoimport ile alfabetik sırayla içe aktarılabilir (çıkarıldıktan sonra).

Lütfen mongoexport'un yapısı gereği, delta dosyalarının silinen ürünler hakkında size bilgi veremeyeceğini unutmayın. Silinen ürünleri veritabanınızdan kaldırmak için MongoDB dökümünün tamamını içe aktarmanız gerekecektir.

CSV Veri Dışa Aktarımı

Veritabanının tamamı ayrıca her satırın bir JSON nesnesi olduğu JSONL format (bazen LDJSON veya NDJSON olarak da adlandırılır) mevcuttur. MongoDB dışa aktarımıyla aynı verileri temsil eder. Dosya gzip ile sıkıştırılmıştır.

Link

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

Veritabanından yararlanmanın uygun bir yolu, büyük miktarda veriyi saniyeler içinde işlemek için tasarlanmış bir süreç içi analitik araç olan DuckDB'yi kullanmaktır. DuckDB ile Open Food Facts veritabanını keşfetmeyi ve işlemeyi adım adım anlattığımız blog yazımızı okuyabilirsiniz

Hugging Face'te Parke Verisi Aktarımı

JSONL dökümünün basitleştirilmiş bir versiyonu Parquet formatında da mevcuttur. Dönüşüm sırasında, yinelenen bilgiler içeren, dahili hata ayıklama için kullanılan veya kullanıcılar için alakasız olan sütunları filtreledik.

Parke formatının kullanışlı olduğu kanıtlanmıştır:

• Veriler satır yerine sütunlara göre düzenlenir; bu da depolama alanından tasarruf sağlar ve analitik sorguları hızlandırır. Yani, ilgilendiğiniz sütunları seçerek sorgu performansını optimize edebilirsiniz; bu, giriş seviyesi bilgisayarlarda bile mümkündür.
• Son derece verimli veri sıkıştırma ve açma özelliği sayesinde, her türlü büyük veri setinin depolanması ve paylaşılması için idealdir
• Karmaşık veri türlerini ve gelişmiş iç içe geçmiş veri yapılarını destekler.

Veri kümesi, geliştiricilerin ve araştırmacıların modellerini ve veri kümelerini paylaşabildikleri ortak bir makine öğrenimi ekosistemi olan Hugging Face'da mevcuttur.

Link

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

Verilerin yeniden kullanımıyla ilgili kılavuzlar ve başlangıç için örnek sorgular da dahil olmak üzere daha fazla bilgiyi Wiki'da bulabilirsiniz.

CSV Veri Dışa Aktarımı

Tüm ürünlere veya bazı ürünlere ilişkin veriler, gelişmiş arama formu aracılığıyla CSV formatında (LibreOffice, Excel ve diğer birçok e-tablo yazılımıyla okunabilir) indirilebilir.

Bağlantılar

Yiyecek: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (GZIP biçiminde sıkıştırılmış CSV: ~ 0,9 Gb, sıkıştırılmamış: ~ 9 Gb)

Kozmetikler: https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz

Evcil Hayvan Maması: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz

Diğer tüm ürünler: https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz

Dosya kodlaması Unicode UTF-8'dir. Alanları ayıran karakter <tab> (tablolama)'dır.

RDF Veri Dışa Aktarımı

Veritabanı ayrıca RDF formatında da mevcuttur (bu bir denemedir, artık aktif olarak sürdürülmemektedir). Fransızca duyuruyu okuyabilirsiniz.

Link

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

Görüntü Verilerini Dışa Aktarma

Tüm görüntüler ve OCR sonuçları sunucumuzdan veya AWS'den (AWS Açık Veri Programı aracılığıyla) indirilebilir. Görüntülerin nasıl indirileceği hakkında daha fazla bilgi edinmek için belgelerimize göz atın

Canlı JSON ve XML API'si

Bir ürünün verilerini okumak için bir JSON API de mevcuttur. Bu API özellikle Open Food Facts mobil uygulamasında kullanılmaktadır.

API'yi zamanla geliştiriyoruz ancak geriye dönük uyumluluğu korumaya özen gösteriyoruz. Kullanıyorsanız lütfen iletişime geçin. Böylece size olası değişiklikler hakkında bilgi verebiliriz.

API'mizi keşfedin

API ve OpenAPI dokümantasyonumuzu iyileştirmeye katkıda bulunmak

API'nin dokümantasyonunu tamamlamak, kullanım senaryoları eklemek ve SDK üretimini otomatikleştirmek için sabırsızlanıyoruz. Eğer bir OpenAPI uzmanıysanız, yardımınıza açığız.

1 API çağrısı = kullanıcı tarafından yapılan 1 gerçek tarama olduğu sürece, API'yi üretim durumlarında kullanmanızdan memnuniyet duyarız. API kullanarak veritabanını taramaya yönelik her türlü girişim büyük ihtimalle engellenecektir, çünkü bu sayfada günlük tam veri aktarımları mevcuttur.

Ayrıca, API çağrınızla birlikte bir HTTP başlığı göndermek, herhangi bir sorun çıkması halinde bizimle iletişime geçmenin iyi bir yoludur.

XML API (desteklenmiyor)

Sonucu .xmlkullanarak XML'de de alabilirsiniz.

Örnek: https://world.openfoodfacts.org/api/v2/product/737628064502.xml

Bu API aktif olarak korunmaz ve resmi olarak belgelenmez.

Wrapper'lar ve SDK'lar

Muhtemelen en sevdiğiniz programlama dili için bir wrapper'ımız vardır. Eğer varsa, onu kullanabilir ve iyileştirebilirsiniz. Eğer yoksa, oluşturmamıza yardımcı olabilirsiniz.

Soru sormak ve API'yi tartışmak için tercih edilen yol olan Open Food Facts Slack sohbet odasına katılabilirsiniz.

Kullanıcılarınızı mutlu edecek genel prensipler

• Ürünler hakkında bilgi arayabilir, bunlara birçok yararlı hesaplanmış değer de dahildir.
• Belirli bir ürünle ilgili bilgiye ulaşamıyorsanız, kullanıcınızdan fotoğraf ve veriler göndermesini isteyebilirsiniz; bu veriler daha sonra Open Food Facts yapay zekası ve katkıda bulunanlar tarafından işlenerek, onlara göstermek istediğiniz hesaplanmış sonuç elde edilir.
• Ayrıca, kendi taraflarında biraz çaba harcayarak sonucu hemen almaları için tam akışı da uygulayabilirsiniz.

Kullanıcılarınız hemen bir sonuç beklemiyorsa (örn. Envanter uygulamaları)

• Fotoğrafları gönderin (ön yüz/besin değerleri/içindekiler): kullanıcılarınız için en zahmetsiz yol
• Open Food Facts'ın yapay zekası Robotoff, fotoğraflardan bazı türetilmiş veriler oluşturacak
• Over time, other apps, and the Open Food Facts community will fill the data gaps

Kullanıcılarınız hemen bir sonuç bekliyorsa (ör. Beslenme uygulamaları)

• Submit nutrition facts + category > get Nutri-Score
• Malzemeleri gönderin > NOVA grubunu (gıdaların aşırı işlenmesi hakkında), katkı maddeleri, alerjenler, standartlaştırılmış malzemeler, vegan, vejetaryen…
• Kategori + etiketleri gönderin > kısa süre içinde Eco-Score’u (çevresel etki hakkında) alın

Android ve iPhone mobil uygulaması

Open Food Facts mobil uygulamasının kodu GitHub'da mevcuttur (Flutter, Kotlin Android ve Swift iOS).

Kullanımdan kaldırılan Kotlin ve Swift kod tabanlarını Kotlin ve Swift SDK'larına dönüştürmeyi hedefliyoruz, yardımlarınızı bekliyoruz :-)

Uygulama, kullanıcıların ürünlerin barkodunu taramasına, ürün bilgilerini görüntülemesine ve eksik ürünler için resim ve veri çekip göndermesine olanak tanır.

Kodu (açık kaynaktır) yeniden kullanmaya ve gezegen üzerindeki herkes için iyileştirmemize yardımcı olabilirsiniz.

SDK'lar

İkon	Dil / Çerçeve	Kaynaklar	Tartışma
	Cordova (Eski Uygulama)	GitHub	Mevcut değil
	DART	GitHub pub.dev	Mevcut değil
	Elixir	GitHub	Slack Kanalı
	Git	GitHub	Slack Kanalı
	Java	GitHub	Slack Kanalı
	Spring Boot	GitHub	Slack Kanalı
	Kotlin	GitHub	Slack Kanalı
	JavaScript	GitHub	Slack Kanalı
	PHP	GitHub	Slack Kanalı
	PHP (Laravel)	GitHub	Slack Kanalı
	Python	GitHub	Slack Kanalı
	React Native	GitHub	Slack Kanalı
	Ruby	GitHub	Slack Kanalı
	Pas rengi	GitHub	Slack Kanalı
	R	GitHub	Slack Kanalı
	Swift	GitHub	Slack Kanalı
	.NET/C#	GitHub	Slack Kanalı

Verileri, API'yi ve dışa aktarımları tartışmak

API ve Veri Dışa Aktarma işlemleriyle ilgili yaygın sıkça sorulan sorulara ve Open Food Facts'le ilgili yaygın sorulara bakabilirsiniz.

Soru sormanın ve API'yi tartışmanın tercih edilen yolu olan Open Beauty Facts Slack sohbet odasına katılın. Lütfen sorularınızı #api kanalında sorun

https://github.com/openfoodfacts/openfoodfacts-server/discussions

Verilerle ilgili herhangi bir sorunuz varsa reuse@openfoodfacts.org adresinden bizimle iletişime geçebilirsiniz.