Register for the Open Food Facts Days 2023

Our annual community event Open Food Facts Days 2023 will take place this October in Paris! To be a part of it, REGISTER HERE

close

Tiedot

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 uudelleen käytät tietoja.

Olemme erittäin kiinnostuneita oppimaan mihin Open Food Facts -tietoja käytetään. 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 Food Facts community.

Open Food Facts -tietojen viennit

Tietokantavedokset ja -viennit luodaan öisin. The database is very big, so you can find different ways to use the data, depending on the export flavor.

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.tar.gz
sha256sum
https://static.openfoodfacts.org/data/sha256sum
md5sum
https://static.openfoodfacts.org/data/md5sum

Muutosten vienti

Päivittäiset muutosten viennit ovat saatavilla viimeiseltä 14:ltä päivältä. Luettelo tällä hetkellä saatavilla olevista muutostiedostoista 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}. Tiedostonnimi sisältää UNIX-aikaleiman ensimmäisestä ja viimeisestä muutoksesta, jotka sisältyvät JSON-tiedostoon, jotta muutostiedostot voidaan tuoda (purkamisen jälkeen) aakkosjärjestyksessä komennolla mongoimport.

Huomioi, että mongoexport-komennon luonteen takia muutostiedostot eivät voi kertoa poistetuista tuotteista. Poistaaksesi poistetut tuotteet tietokannastasi sinun täytyy tuoda täysi MongoDB-vedos.

Tietojen CSV-vienti

The whole database is also available in JSONL format (sometimes called LDJSON or NDJSON) where each line is a JSON object. It represents the same data as the MongoDB export. The file is compressed with gzip.

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

Tietojen CSV-vienti

Tiedot kaikille tuotteille tai osalle tuotteista voi ladata CSV-muodossa (luettavissa OpenOfficella, Excelillä ja monella muulla ohjelmistolla) tarkennetun haun lomakkeella.

Links
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv (raw CSV)
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format)

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

Tietojen RDF-vienti

Tietokanta on myös saatavilla RDF-muodossa. announcement in French.

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

Kuvatietojen vienti

Kaikki kuvat ja tekstintunnistustulokset ovat ladattavissa palvelimeltamme tai AWS:stä (AWS Open Data Program -ohjelman kautta). Tutustu dokumentaatioomme saadaksesi lisätietoja miten ladata kuvia.

Live JSON and XML API

Myös JSON API on saatavilla tuotteen tietojen lukemiseen. Tämä API on erityisesti käytössä Open Food Facts mobiilisovelluksessa iPhonelle ja Androidille.

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

Esimerkki: https://world.openfoodfacts.org/api/v2/product/737628064502.json

Esimerkki: https://world.openfoodfacts.org/api/v2/product/737628064502.json

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

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

Voit käyttää API:a tuotannossa, kunhan 1 API-kutsu = 1 oikea viivakoodin lukeminen käyttäjältä. Kaikki yritykset kaapia tietokantaa API:a käyttämällä estetään erittäin todennäköisesti, sillä päivittäiset viennit ovat saatavilla tältä samaiselta sivulta.

Jos olet epävarma jostakin, tai sinulla on kysymyksiä (hölmöjä kysymyksiä ei ole), voit esittää kysymyksesi Slackissä :-)

Jos olet epävarma jostakin, tai sinulla on jokin kysymys (ei ole typeriä kysymyksiä), kysy rohkeasti #api-kanavalla Slackissa :-)

Android ja IPhone mobiilisovellukset

Open Food Facts -mobiilisovellusten koodi on saatavilla GitHubissa (Flutter, Android ja iOS). Sovelluksen avulla käyttäjät voivat skannata tuotteiden viivakoodeja, katsella tuotetietoja, ja ottaa ja lähettää kuvia ja tietoja puuttuvista tuotteista.

Perinteistä sovellusta iOS-käyttöjärjestelmälle kehitetään Swift-kielellä.

Perinteistä sovellusta Android-käyttöjärjestelmälle kehitetään Kotlin-kielellä.

Uusi alustariippumaton sovellus on Dart/Flutter-sovellus.

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

Kääreet ja SDK

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

Voit liittyä Open Food Facts Slack -keskusteluryhmään, joka on ensisijainen tapa kysyä kysymyksiä ja keskustella API:sta.

General principles

  • You can search for information about products, including many useful computed values.
  • 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 Food Facts AI and contributors to get the computed result you want to show them.
  • You can also implement the complete flow so that they get immediately the result with some effort on their side.

If your users do not expect a result immediately (e.g. Inventory apps)

  • Submit photos (front/nutrition/ingredients): most painless thing for your users
  • The Open Food Facts AI Robotoff will generate some derived data from the photos
  • Over time, other apps, and the Open Food Facts community will fill the data gaps

If your users expect a result immediately (e.g. Nutrition apps)

  • Submit nutrition facts + category > get Nutri-Score
  • Submit ingredients > get the NOVA group (about food ultra-processing), additives, allergens, normalized ingredients, vegan, vegetarian…
  • Submit category + labels > soon get the Eco-Score (about environmental impact)

Keskustelu tiedoista, API:sta ja vienneistä

Voit liittyä Open Food Facts Slack -keskusteluryhmään, joka on ensisijainen tapa kysyä kysymyksiä ja keskustella API:sta.

Voit aloittaa viestiketjun ohjelmointirajapintadokumentaatiotietovarastossamme

Yhteystiedot

Tietoihin liittyvissä kysymyksissä voit ottaa meihin yhteyttä sähköpostilla osoitteeseen contact@openfoodfacts.org