Údaje

Podmínky pro opětovné použití

Databáze Open Pet Food Facts je dostupná pod licencí Open Database License.
Jednotlivé obsahy databáze jsou dostupné pod licencí Database Contents License.
Obrázky produktů jsou dostupné pod Creative Commons Attribution 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žití 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 jsou využívány údaje Open Pet Food Fakt. Není to povinné, ale velmi bychom ocenili, kdybyste nám sdělili o svých opakovaných použitích , abychom je mohli sdílet s komunitou Open Pet Food Facts. Můžete také vyplnit tento formulář a získat tak šanci, aby byla vaše aplikace doporučena.

Mobilní aplikace pro Android a iPhone (potřebujeme pomoc!)

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.openpetfoodfacts.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.openpetfoodfacts.org/data/openpetfoodfacts-mongodbdump.gz

sha256sum

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

md5sum

https://static.openpetfoodfacts.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ů naleznete na adrese https://static.openpetfoodfacts.org/data/delta/index.txt.

Každý řádek představuje soubor, který je k dispozici na adrese https://static.openpetfoodfacts.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 mongoexportvá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.

Odkaz

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

Export dat CSV

Soubor dat je k dispozici na Hugging Face, kolaborativním ekosystému strojového učení, kde mohou vývojáři a výzkumníci sdílet modely a datové sady.

Zjednodušená verze výpisu JSONL je k dispozici také ve formátu Parquet. Při převodu jsme filtrovali sloupce, které obsahují duplicitní informace, slouží k internímu ladění nebo jsou pro uživatele jednoduše irelevantní.

Ukázalo se, že formát Parquet je vhodný:

• Data jsou organizována podle sloupců, nikoli podle řádků, což šetří úložný prostor a urychluje analytické dotazy, tj. můžete vybrat pouze sloupce, které vás zajímají, a optimalizovat tak výkon dotazů, a to i na méně výkonných počítačích.
• Vysoce účinná komprese a dekomprese dat, díky čemuž je vhodná pro ukládání a sdílení velkých datových sad jakéhokoli druhu,
• Podporuje komplexní datové typy a pokročilé vnořené datové struktury.

Odkaz

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

Další informace najdete na Wiki, včetně pokynů pro opětovné použití dat a příkladů dotazů, jak začít.

Vhodným způsobem využití databáze je použití DuckDB, analytický nástroj v průběhu procesu určený ke zpracování velkého množství údajů v zlomku sekund. Můžete si přečíst náš příspěvek na blogu, kde vás provedeme průzkumem a zpracováním databáze Open Pet Food Facts pomocí DuckDB

Export dat RDF

Data pro všechny produkty nebo některé z nich lze stáhnout ve formátu CSV (čitelném v LibreOffice, Excelu a mnoha dalších tabulkových procesorech) prostřednictvím rozšířeného vyhledávacího formuláře.

Odkaz

https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz (komprimovaný CSV ve formátu GZIP: ~ 0,9 Gb, nekomprimovaný: ~ 9 Gb)

Kódování souboru je Unicode UTF-8. Znak, který odděluje pole, je <tab> (tabulka).

Export obrazových dat

Databáze je dostupná také ve formátu RDF. Můžete si přečíst oznámení ve francouzštině.

Odkaz

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

Hledáme pomoc s OpenAPI

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 rozhraní API se používá zejména v mobilní aplikaci Open Pet Food Facts pro iPhone a Android.

API v průběhu času vylepšujeme, ale dbáme na zachování zpětné kompatibility. Pokud ho používáte, prosím, kontaktujte nás, abychom Vám mohli sdělit o možných změnách.

URL ke čtení dat o produktu: https://world.openpetfoodfacts.org/api/v3/product/[barcode].json

Příklad: https://world.openpetfoodfacts.org/api/v3/product/737628064502.json

Výsledek můžete také získat v XML pomocí .xml

• API V3 - nová dokumentace OpenAPI - Work in Progress

Experimentální XML API

Těšíme se na dokončení dokumentace k API, přidání případů užití a automatizaci generování SDK. Pokud jste znalci OpenAPI, rádi si necháme pomoct.

API můžete používat i v produkčních aplikacích, pokud 1 volání API = 1 skutečné skenování uživatelem. Jakýkoli pokus o scraping databáze pomocí API bude s největší pravděpodobností zablokován, protože kompletní denní exporty jsou k dispozici na této stránce.

Také odeslání HTTP hlavičky s voláním API je dobrý způsob, jak se s vámi můžeme spojit, pokud by nastal jakýkoli problé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

Kódy pro oficiální mobilní aplikace Open Food Facts jsou dostupné na GitHubu: Flutter, Kotlin Android a Swift iOS

Umožní vám spotřebovávat data a také umožní vašim uživatelům přispívat novými daty

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.

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ě.

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 požádat uživatele o zaslání fotografií a dat, které pak zpracuje umělá inteligence Open Pet Food Facts a přispěvatelé, aby se dosáhlo vypočítaného výsledku, 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
• Umělá inteligence Open Pet Food Facts – Robotoff – vygeneruje z fotografií některá odvozená data.
• Postupem času mezery v datech zaplní další aplikace a komunita Open Pet Food Facts.

Pokud uživatelé očekávají výsledek okamžitě (např. aplikace Výživa nebo Alergie)

• Odeslat ingredience + kategorii > získat analýzu ingrediencí, aditiva, alergeny, normalizované ingredience, veganské, vegetariánské…
• Odešlete štítky pro přidanou hodnotu
• Odeslat výživové informace

SDK

Kód pro aktuální univerzální aplikaci nazvanou Open Food Facts je k dispozici na GitHub (Flutter). Dokáže skenovat a přidávat krmivo pro domácí zvířata. Starší mobilní aplikace Open Pet Food Facts, která je stále k dispozici pro systém Android, je postavena na jazyce Kotlin. V plánu je aktualizovat ji na verzi aplikace Flutter pod značkou Open Pet Food Facts.

Snažíme se z deprecated Kotlin a Swift codebases udělat Kotlin a Swift SDK, pomoc vítána :-)

Kotlin Android a Swift iOS

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

SDK

Ikona	Jazyk / Framework	Zdroje	Diskuse
	Cordova (stará aplikace)	GitHub	Nedostupné
	DART	GitHub pub.dev	Nedostupné
	Elixir	GitHub	Slack Channel
	Přejít	GitHub	Slack Channel
	Jáva	GitHub	Slack Channel
	Spring Boot	GitHub	Slack Channel
	Kotlin	GitHub	Slack Channel
	JavaScript	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
	Rezavá	GitHub	Slack Channel
	R	GitHub	Slack Channel
	Swift	GitHub	Slack Channel
	.NET/C#	GitHub	Slack 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 chatovací místnosti Open Pet Food Facts na Slacku, 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