Údaje
Podmínky pro opětovné použití
Databáze Open Food Facts je k dispozici pod Open Database License.
Jednotlivý obsah databáze je k dispozici pod licencí k obsahu databáze.
Obrázky produktů jsou k dispozici pod licencí Creative Commons Uveďte autora ShareAlike.
Mohou obsahovat grafické prvky podléhající autorským právům nebo jiným právům, které mohou být v některých případech reprodukovány (práva na nabídky nebo fair use).
Před opětovným použitím dat si prosím přečtěte Podmínky používání a opětovného použití.
Řekněte nám o svém opětovném použití
Velmi nás zajímá zjištění, k čemu se používají data Open Food Facts. To není povinné, ale velmi bychom ocenili, kdybyste nám řekli o svém opětovném použití, abychom ho mohli sdílet s komunitou Open Food Facts. Můžete také vyplnit tento formulář a získat tak šanci, aby byla vaše aplikace doporučena.
Export dat Open Food Facts
Výpisy a exporty databáze se generují každou noc. Databáze je velmi velká, takže můžete najít různé způsoby, jak použít datav závislosti na variantě exportu.
Informace o různých polích pro výpis MongoDB a exporty CSV jsou k dispozici na adrese https://world.openfoodfacts.org/data/data-fields.txt
Výpis MongoDB
Data pro všechny produkty jsou k dispozici ve výpisu databáze MongoDB.
- Odkaz
- 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
Denní delta exporty jsou poskytovány za předchozích 14 dní. Seznam aktuálně dostupných delta souborů lze nalézt na https://static.openfoodfacts.org/data/delta/index.txt.
Každý řádek představuje soubor, který je dostupný na adrese https://static.openfoodfacts.org/data/delta/{filename}
.
Název souboru obsahuje UNIX časové razítko prvního a poslední změny obsažené v souboru JSON, aby delta soubory mohly být importovány (po extrakci) pomocí mongoimport
v abecedním pořadí.
Vezměte prosím na vědomí, že vzhledem k povaze mongoexport
vám delta soubory nemohou říci o smazaných produktech. Chcete-li odebrat odstraněné produkty z databáze, musíte importovat celý výpis MongoDB.
Export dat JSONL
Celá databáze je k dispozici také ve formátu JSONL (někdy nazývaném LDJSON nebo NDJSON), kde je každý řádek objektem JSON. Představuje stejná data jako export MongoDB. Soubor je komprimován pomocí gzip.
A suitable way to exploit the database is to use DuckDB, an in-process analytical tool designed to process large amount of data in a fraction of seconds. You can read our blog post where we walk you through exploring and processing the Open Food Facts database with DuckDB
Export dat CSV
Data pro všechny produkty nebo některé produkty lze stáhnout ve formátu CSV (čitelný pomocí LibreOffice, Excel a mnoha dalších tabulkových softwarů) prostřednictvím formuláře pro pokročilé vyhledávání.
- Odkazy
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (komprimovaný CSV ve formátu GZIP: ~ 0.9 Gb, rozbalený: ~ 9 Gb)
Kódování souboru je Unicode UTF-8. Znak, který odděluje pole, je <tab> (tabulka).
Export dat RDF
Databáze je dostupná také ve formátu RDF. Můžete si přečíst oznámení ve francouzštině.
Export obrazových dat
Všechny obrázky a výsledky OCR lze stáhnout z našeho serveru nebo z AWS (prostřednictvím AWS Open Data Program). Podívejte se na naši dokumentaci a zjistěte více o tom, jak stahovat obrázky.
Dokumentace OpenAPI pro JSON API
K dispozici je také JSON API pro čtení dat pro produkt. Toto API se používá zejména v mobilní aplikaci Open Food Facts pro iPhone a Android.
API v průběhu času vylepšujeme, ale dbáme na zachování zpětné kompatibility. Prosím, kontaktujte nás, pokud ho používáte, abychom Vás mohli informovat o možných změnách.
Adresa URL pro čtení dat o produktu: https://world.openfoodfacts.org/api/v2/product/[barcode].json
Příklad: https://world.openfoodfacts.org/api/v3/product/737628064502.json
Všimněte si, že pokud je výstup příliš zahlcující, můžete jej filtrovat – jak je popsáno v dokumentaci API.
Hledáme pomoc s OpenAPI
Jsme dychtiví dokončit dokumentaci API, přidat případy použití a automatizovat generování SDK. Pokud jste znalci OpenAPI, rádi si necháme pomoct.Je velmi vítáno používat API pro produkční případy, pokud 1 volání API = 1 skutečné skenování uživatelem. Jakýkoli pokus o stažení databáze pomocí API bude velmi pravděpodobně zablokován, protože právě na této stránce jsou k dispozici úplné denní exporty.
Také odeslání HTTP hlavičky s vaším voláním API je dobrý způsob, jak se s námi spojit, pokud by nastal nějaký problém.
Pokud si nejste jistí, nebo máte nějaké dotazy (není tu žádná pošetilá otázka), Neváhejte se zeptat na kanálu #api na Slack :-)
Experimentální XML API
Výsledek můžete také získat v XML pomocí .xml
Příklad: https://world.openfoodfacts.org/api/v2/product/737628064502.xml
Toto API není aktivně udržováno a není oficiálně zdokumentováno.Obaly a sady SDK
Pravděpodobně máme wrapper pro váš oblíbený programovací jazyk. Pokud ano, můžete to využít a vylepšit. Pokud ne, můžete pomoci s jeho vytvořením.
Umožní vám spotřebovávat data a také umožní vašim uživatelům přispívat novými daty
Obecné zásady, aby byli vaši uživatelé spokojeni
- Můžete vyhledávat informace o produktech, včetně mnoha užitečných vypočtených hodnot.
- Pokud nemůžete získat informace o konkrétním produktu, můžete přimět uživatele, aby poslal fotografie a data, která pak zpracuje Open Food Facts AI a přispěvatelé, aby získali vypočítaný výsledek, který jim chcete ukázat.
- Můžete také implementovat kompletní tok tak, aby okamžitě získali výsledek s určitým úsilím na jejich straně.
Pokud vaši uživatelé neočekávají výsledek okamžitě (např. aplikace Inventory)
- Odešlete fotografie (přední strana/výživa/ingredience): pro vaše uživatele naprosto bezbolestná věc
- Open Food Facts AI „Robotoff“ vygeneruje některá odvozená data z fotografií
- Časem mezery v datech zaplní další aplikace a komunita Open Food Facts
Pokud vaši uživatelé očekávají výsledek okamžitě (např. aplikace pro výživu)
- Odešlete nutriční fakta + kategorie > získejte Nutri-Score
- Odešlete ingredience > získejte skupinu NOVA (o ultrazpracování potravin), přísady, alergeny, normalizované ingredience, veganské, vegetariánské…
- Odešlete kategorii + štítky > brzy získáte Eco-Score (o dopadu na životní prostředí)
Mobilní aplikace pro Android/iPhone/Flutter
Kódy pro oficiální mobilní aplikace Open Food Facts jsou dostupné na GitHubu: Flutter, Kotlin Android a Swift iOS
Uvažujeme o přeměně zastaralých kódových základen Kotlinu a Swiftu na SDK Kotlinu a Swiftu, pomoc vítána :-)
Aplikace umožňuje uživatelům naskenovat čárový kód produktů, zobrazit informace o produktu a pořídit a odeslat obrázky a data pro chybějící produkty.
Můžete znovu použít kód (je to open source) a pomoci nám jej vylepšit, pro každého na celé planetě.
SDK
- Cordova: GitHub (stará oficiální aplikace Open Food Facts)
- DART: GitHub - Balíček na pub.dev
- Elixir: GitHub – Diskusní kanál
- Go: GitHub – Diskusní kanál
- Java: GitHub – Diskusní kanál
- Kotlin: GitHub – Diskusní kanál
- NodeJS: GitHub – Diskusní kanál
- PHP: GitHub – Diskusní kanál
- PHP (Laravel): GitHub – Diskusní kanál
- Python: GitHub – Diskusní kanál
- React Native: GitHub – Diskusní kanál
- Ruby: GitHub – Diskusní kanál
- Rust: GitHub – Diskusní kanál
- R: GitHub - Discussion channel
- Swift: GitHub - Discussion channel
- .NET/C#: GitHub - Discussion channel
Diskuse o datech, API a exportu
Můžete se podívat na nejčastější dotazy týkající se API a exportů dat a běžné otázky týkající se Open Food Facts
Můžete se připojit k Slackové chatovací místnosti Open Food Facts, což je preferovaný způsob, jak klást otázky a diskutovat o API. Prosím položte své otázky v kanálu #api
Můžete otevřít vlákno v našem úložišti dokumentace API
V případě jakýchkoli dotazů ohledně údajů nás můžete kontaktovat na reuse@openfoodfacts.org