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.
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ütuna göre düzenlenir, bu da depolama alanından tasarruf sağlar ve analitik sorguları hızlandırır, yani yalnızca ilgilendiğiniz sütunları seçebilir, giriş seviyesi bilgisayarlarda bile sorgu performanslarını optimize edebilirsiniz.
- Yüksek verimli veri sıkıştırma ve açma, her türlü büyük veri kümesinin 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.
The dataset is available on Hugging Face, a collaborative Machine Learning ecosystem where developers and researchers can share models and datasets.
Find more information in the Wiki, including guidelines for data reuse and example queries to get started.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
- 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
Dosya kodlaması Unicode UTF-8'dir. Alanları ayıran karakter <tab> (tablolama)'dır.
RDF Veri Dışa Aktarımı
The database is also available in the RDF format (this is an experiment, not actively maintained anymore). Fransızca duyuruyu okuyabilirsiniz.
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. Check out our documentation to learn more about how to download images
Canlı JSON ve XML API'si
Bir ürünün verilerini okumak için bir JSON API de mevcuttur. This API is in particular used in the Open Food Facts mobile app.
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.
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)
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.
Kullanıcılarınızı mutlu edecek genel prensipler
- Birçok faydalı hesaplanmış değer de dahil olmak üzere ürünler hakkında bilgi arayabilirsiniz.
- DART: GitHub
- 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 anlayabileceği en basit haliyle
- Open Food Facts AI - Robotoff - fotoğraflardan bazı türetilmiş veriler üretecek
- Zamanla diğer uygulamalar ve Open Food Facts topluluğu veri boşluklarını dolduracak
Kullanıcılarınız hemen bir sonuç bekliyorsa (ör. Beslenme uygulamaları)
- Beslenme gerçeklerini gönderin + kategori > Nutri-Score'u alın
- Malzemeleri gönder > NOVA grubunu (gıda ultra işleme hakkında), katkı maddelerini, alerjenleri, normalleştirilmiş içerik maddelerini, vegan, vejetaryen… edinin
- Kategori + etiketleri gönderin > yakında Eco-Score'u alın (çevresel etki hakkında)
Android ve iPhone mobil uygulaması
Open Food Facts mobil uygulamasının kodu GitHub'da mevcuttur (Flutter, Kotlin Android ve Swift iOS).
We look to turn the deprecated Kotlin and Swift codebases into Kotlin and Swift SDKs, help welcome :-)
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
| Icon | Language / Framework | Kaynaklar | 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 | |
| Pas rengi | GitHub | Slack Channel | |
| R | GitHub | Slack Channel | |
| Swift | GitHub | Slack Channel | |
| .NET/C# | GitHub | Slack Channel |
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
You can open a thread on our API documentation repository
Verilerle ilgili herhangi bir sorunuz varsa reuse@openfoodfacts.org adresinden bizimle iletişime geçebilirsiniz.