Veri
Yeniden kullanım koşulları
Open Pet Food Facts veritabanı, Açık Veritabanı Lisansı kapsamında mevcuttur.
Veritabanının ayrı ayrı içerikleri Veritabanı İçerik Lisansı kapsamında mevcuttur.
Ürün görselleri Creative Commons Attribution ShareAlike lisansı kapsamında mevcuttur.
Bazı durumlarda çoğaltılabilen (alıntı hakkı veya adil kullanım), telif haklarına veya diğer haklara tabi grafiksel ögeler içerebilirler.
Verileri yeniden kullanmadan önce lütfen Kullanım ve yeniden kullanım şart ve koşullarını okuyun.
Bize yeniden kullanımınızdan bahsedin
Open Pet Food Facts verilerinin ne için kullanıldığını öğrenmekle çok ilgileniyoruz. 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 Pet Food Facts community. Uygulamanızın öne çıkarılması şansını yakalamak için bu formu da doldurabilirsiniz.
Open Pet Food Facts verilerini dışa aktarma
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 bilgilere https://world.openpetfoodfacts.org/data/data-fields.txt adresinden ulaşılabilir
MongoDB dökümü
Tüm ürünler için veriler MongoDB veritabanı dökümünde mevcuttur.
- Link
- https://static.openpetfoodfacts.org/data/openpetfoodfacts-mongodbdump.gz
- sha256sum
- https://static.openpetfoodfacts.org/data/gz-sha256sum
- md5sum
- https://static.openpetfoodfacts.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. Mevcut delta dosyalarının listesi şu adreste bulunabilir: https://static.openpetfoodfacts.org/data/delta/index.txt.
Her satır https://static.openpetfoodfacts.org/data/delta/{filename} adresinde bulunan bir dosyayı temsil eder.
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.
Hugging Face'te Parke Verisi Aktarımı
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.
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.
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.
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. Open Pet Food Facts veritabanını DuckDB ile keşfetme ve işleme konusunda size yol gösterdiğimiz blog yazımızı okuyabilirsiniz
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 (OpenOffice, Excel ve diğer birçok yazılımla okunabilir) indirilebilir.
- Bağlantılar
- https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)
Dosya kodlaması Unicode UTF-8'dir. Alanları ayıran karakter <tab> (tablolama)'dır.
RDF Veri Dışa Aktarımı
Veritabanı RDF formatında da mevcuttur. 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. Resimlerin 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 iPhone ve Android için Open Pet Food Facts mobil uygulamasında kullanılır.
API'yi zamanla geliştiriyoruz ancak geriye dönük uyumluluğu korumaya özen gösteriyoruz. Please get in touch if you use it, so that we can tell you about potential changes.
URL to read data for a product: https://world.openpetfoodfacts.org/api/v3/product/[barcode].json
Örnek: https://world.openpetfoodfacts.org/api/v0/product/3600550578041.json
Çıktı çok yoğunsa API belgelerinde açıklandığı gibi filtreleyebileceğinizi unutmayın.
OpenAPI yardımı aranıyor
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.
Herhangi bir konuda emin değilseniz veya herhangi bir sorunuz varsa (aptalca soru diye bir şey yoktur), Slack'teki #api kanalında sormaya çekinmeyin :-)
Deneysel XML API'si
Sonucu .xmlkullanarak XML'de de alabilirsiniz.
iOS için klasik uygulama hiçbir zaman evcil hayvan mamasına uyarlanmadı veya kullanılmadı.
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
- Ürünler hakkında bilgi arayabilir, bunlara birçok yararlı hesaplanmış değer de dahildir.
- If you can't get the information on a specific product, you can get your user to send photos and data, that will then be processed by Open Pet Food Facts AI and contributors to get the computed result you want to show them.
- 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
- The Open Pet Food Facts AI - Robotoff - will generate some derived data from the photos
- Over time, other apps, and the Open Pet Food Facts community will fill the data gaps
Kullanıcılarınız hemen sonuç bekliyorsa (örneğin Beslenme veya Alerji uygulamaları)
- İçerikleri + kategoriyi gönderin > İçerik analizi, katkı maddeleri, alerjenler, normalleştirilmiş içerikler, vegan, vejetaryen…alın
- Eklenmiş değer için etiketler gönderin
- Submit nutrition
Android ve iPhone mobil uygulaması
The code for the current universal app called Open Food Facts is available on GitHub (Flutter). Evcil hayvan mamasını tarayıp ekleyebilir. Android için hala mevcut olan eski Open Pet Food Facts mobil uygulaması Kotlin üzerine inşa edilmiştir. Flutter uygulamasının Open Pet Food Facts markalı bir versiyonuna güncellenmesi planlanıyor.
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 hakkında tartışmanın tercih edilen yolu olan Open Pet Food Facts Slack sohbet odasına katılabilirsiniz. Lütfen sorularınızı #api kanalında sorun
https://github.com/openfoodfacts/api-documentation/discussions
Verilerle ilgili herhangi bir sorunuz varsa reuse@openfoodfacts.org adresinden bizimle iletişime geçebilirsiniz.