Tiedot

Uudelleenkäytön ehdot

Open Food Facts -tietokanta on Open Database License -lisenssin alaisuudessa.
Tietokannan yksilöllinen sisältö on Database Contents License -lisenssin alaisuudessa.
Tuotekuvat ovat Creative Commons Attribution ShareAlike licence -lisenssin alaisuudessa. Ne saattavat sisältää tekijänoikeuden tai muun oikeuden alaisia graafisia elementtejä, jotka joissain tapauksissa saa kopioida (lainausoikeudet tai kohtuullinen käyttö).

Lue Käytön ja uudelleenkäytön ehdot ja edellytykset ennen kuin uudelleenkäytät tietoja.

Kerro meille uudelleenkäytöstäsi

Olemme erittäin kiinnostuneita oppimaan mihin Open Food Facts -tietoja käytetään. Se ei ole pakollista, mutta olisimme erittäin kiitollisia, jos kertoisit meille uudelleenkäytöstäsi jotta voimme jakaa ne Open Food Facts -yhteisön kanssa. Voit myös täyttää tämän lomakkeen saadaksesi mahdollisuuden saada sovelluksesi esille.

Open Food Facts -tietojen viennit

Tietokantavedokset ja -viennit luodaan öisin. Tietokanta on erittäin suuri, joten voit löytää erilaisia tapoja käyttää tietojavientimausta riippuen.

Tietoa MongoDB-vedoksen ja CSV-vientien eri kentistä on saatavilla osoitteesta https://world.openfoodfacts.org/data/data-fields.txt

MongoDB-vedos

Kaikkien tuotteiden tiedot ovat saatavilla MongoDB tietokantavedoksena.

Linkki

https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.gz

sha256sum

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

md5sum

https://static.openfoodfacts.org/data/gz-md5sum

Muutosten vienti

Päivittäiset muutosten viennit ovat saatavilla viimeiseltä 14:ltä päivältä. Luettelo tällä hetkellä saatavilla olevista deltatiedostoista löytyy osoitteesta https://static.openfoodfacts.org/data/delta/index.txt.

Jokainen rivi vastaa tiedostoa, joka on saatavilla osoitteesta https://static.openfoodfacts.org/data/delta/{tiedostonnimi}.

Tiedostonimi sisältää JSON-tiedoston ensimmäisen ja viimeisen muutoksen UNIX-aikaleiman, jotta delta-tiedostot voidaan tuoda (purkauksen jälkeen) mongoimport :lla aakkosjärjestyksessä.

Huomioi, että mongoexport-komennon luonteen takia muutostiedostot eivät voi kertoa poistetuista tuotteista. Jos haluat poistaa poistetut tuotteet tietokannastasi, sinun on tuotava koko MongoDB-vedos.

JSONL-tietojen vienti

Koko tietokanta on saatavilla myös JSONL-muodossa (joskus kutsutaan nimellä LDJSON tai NDJSON), jossa jokainen rivi on JSON-objekti. Se edustaa samoja tietoja kuin MongoDB-vienti. Tiedosto on pakattu gzip:llä.

Linkki

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

Voit hyödyntää tietokantaa DuckDB:llä, joka on prosessinsisäinen analyyttinen työkalu, joka on suunniteltu käsittelemään suuria määriä dataa sekunnin murto-osassa. Blogipostauksessamme kerrotaan, miten Open Food Factsin tietokantaa voi käyttää DuckDB:n avulla

Parkettitietojen vienti Hugging Face -sovellukseen

JSONL dump -toiminnon yksinkertaistettu versio on saatavilla myös parkettimuodossa. Tämän muutoksen aikana olemme suodattaneet sarakkeita, jotka sisältävät monistettua tietoa, ovat merkityksettömiä käyttäjille tai joita käytetään virheidenkorjaukseen.

Parkettimuoto on todistetusti hyödyllinen:

• Data on järjestetty sarakkeittain rivien sijaan, mikä säästää tallennustilaa ja nopeuttaa analytiikkakyselyitä. Voit siis valita vain ne sarakkeet, joista olet kiinnostunut, mikä optimoi kyselyiden suorituskykyä jopa perustietokoneilla.
• Erittäin tehokas tiedon pakkaus ja purku, mikä tekee siitä hyvän kaikenlaisten suurten tietojoukkojen tallentamiseen ja jakamiseen,
• Tukee monimutkaisia datatyyppejä ja edistyneitä sisäkkäisiä tietorakenteita.

Tämä datapaketti on saatavilla sivustolla Hugging Face, joka on yhteistyöhön ja koneoppimiseen perustuva järjestelmä, jossa kehittäjät ja tutkijat voivat jakaa malleja ja dataa.

Linkki

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

Lisää tietoa löydät Wikistämme sisältäen esimerkkikysymyksiä sekä ohjeita datan uudelleenkäyttöä varten.

Tietojen CSV-vienti

Kaikkien tuotteiden tai joidenkin tuotteiden tiedot voidaan ladata CSV-muodossa (luettavissa LibreOfficella, Excelillä ja monilla muilla taulukkolaskentaohjelmilla) tarkennetun hakulomakkeen kautta.

Linkkejä

Ruoka: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (pakattu CSV GZIP-formaatissa: ~0,9 Gb, ei pakattu: ~9 Gb)

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

Lemmikkien ruoka: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz

Kaikki muut tuotteet: https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz

Tiedoston merkistökoodaus on Unicode UTF-8. Kenttien erottimena on <sarkain>.

Kuvatietojen vienti

Tietokanta on saatavilla myös RDF-muodossa (tämä on kokeilu, jota ei enää aktiivisesti ylläpidetä). Voit lukea ilmoituksen ranskaksi.

Linkki

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

OpenAPI-apua kaivataan

Kaikki kuvat ja OCR-tulokset voidaan ladata joko palvelimeltamme tai AWS:stä (AWS Open Data Program -ohjelman kautta). Katso dokumentaatiostamme lisätietoja kuvien lataamisesta

Live JSON ja XML API

JSON API on myös saatavilla tuotteen tietojen lukemiseen. API:a käytetään erityisesti Open Food Facts -mobiilisovelluksessa.

Parannamme ohjelmointirajapintaa ajan myötä, mutta huolehdimme yhteensopivuudesta aiempien versioiden kanssa. ota yhteyttä jos käytät sitä, jotta voimme kertoa sinulle mahdollisista muutoksista.

Lue lisää API:sta

Edistämme API:n ja OpenAPI-dokumentaation parantamista

Pyrimme saamaan valmiiksi API:n dokumentaation, lisäämään käyttökokemusta ja automatisoimaan SDK-generaatiota. Jos olet OpenAPI-asiantuntija, olet hyvin tervetullut auttamaan.

Voit käyttää API:a tuotantotapauksia varten, kunhan yksi API-kutsu edellyttää yhtä aitoa skannausta käyttäjän toimesta. Kaikki yritykset tietokannan kopioimiseksi API:n avulla todennäköisesti estetään, koska kaikki päivittäiset tietoviennit ovat saatavilla tällä sivulla.

Tämän lisäksi HTTP-päätteen lähettäminen API-soiton yhteydessä on hyvä tapa ottaa meihin yhteyttä, jos ilmenee ongelmia.

XML-sovellus (ei tuettu)

Tulokset saa myös XML-muodossa päätteellä .xml

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

Tätä API:a ei ylläpidetä aktiivisesti, eikä sitä ole dokumentoitu virallisesti.

Kääreet ja SDK:t

Meillä on todennäköisesti kääre lempiohjelmointikielellesi. Jos on, voit käyttää ja parantaa sitä. Jos ei ole, voit auttaa luomaan sen.

Voit uudelleen käyttää koodia (se on avointa lähdekoodia), ja auttaa meitä parantamaan sitä, kaikille, koko planeetalla.

Yleiset periaatteet käyttäjien ilahduttamiseksi

• Voit etsiä tietoja tuotteista, mukaan lukien monia hyödyllisiä laskettuja arvoja.
• Jos et saa tietoja tietystä tuotteesta, voit pyytää käyttäjää lähettämään valokuvia ja tietoja, jotka sitten Open Food Facts AI ja avustajat käsittelevät saadakseen lasketun tuloksen, jonka haluat näyttää heille.
• Voit myös toteuttaa koko vaiheen niin, että he saavat heti tuloksen pienellä vaivalla.

Jos käyttäjäsi eivät odota tulosta heti (esim. varastosovellukset)

• Lähetä valokuvat (etupuoli/ravintotiedot/ainesosat): käyttäjillesi kivuton asia
• Open Food Facts AI - Robotoff - tuottaa valokuvista johdettuja tietoja
• Ajan myötä muut sovellukset ja Open Food Facts -yhteisö täyttävät tietoaukot

Jos käyttäjäsi odottavat tulosta välittömästi (esim. ravitsemussovellukset)

• Lähetä ravitsemuustiedot + kategoria > saat Nutri-Scorea
• Ilmoita ainesosat > hanki NOVA-ryhmä (ruoan ultraprosessoinnista), lisäaineet, allergeenit, normalisoidut ainesosat, vegaanius, vegetaarisuus…
• Lähetä kategoria + tunnisteet > saat pian Eco-Scorea (ympäristövaikutuksista)

SDK:t

Voit tarkastella yleisiä API:ta ja tietojen vientiä koskevia FAQ-kysymyksiä ja yleisiä Open Food Facts -kysymystä

We look to turn the deprecated Kotlin and Swift codebases into Kotlin and Swift SDKs, help welcome :-)

Voit aloittaa viestiketjun ohjelmointirajapintadokumentaatiotietovarastossamme

Jos sinulla on kysyttävää datasta, voit ottaa meihin yhteyttä osoitteeseen reuse@openfoodfacts.org

SDK:t

Kuvake	Kieli / Nimi	Resursseja	Keskustelu
	Cordova (Vanha sovellus)	GitHub	Ei saatavilla
	DART	GitHub pub.dev	Ei saatavilla
	Elixir	GitHub	Slack Channel
	Go	GitHub	Slack Channel
	Java	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
	Ruosteenvärinen	GitHub	Slack Channel
	R	GitHub	Slack Channel
	Swift	GitHub	Slack Channel
	.NET/C#	GitHub	Slack Channel

Keskustelu tiedoista, API:sta ja vienneistä

Voit tarkastella yleisiä API:ta ja tietojen vientiä koskevia FAQ-kysymyksiä ja yleisiä Open Food Facts -kysymystä

Voit Open Food Facts Slack -keskusteluhuoneeseen, joka on suositeltu tapa esittää kysymyksiä ja keskustella API:sta. Ole hyvä esitä kysymyksesi #api kanavalla

Voit avata ketjun API-dokumentaatioarkistossamme

Jos sinulla on kysyttävää datasta, voit ottaa meihin yhteyttä osoitteeseen reuse@openfoodfacts.org