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 uudelleen kä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 kerrot 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.
Tietojen CSV-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ä.
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
Tietojen CSV-vienti
A simplified version of the JSONL dump is also available in the Parquet format. During the conversion, we filtered columns that contains duplicated information, are used for internal debugging, or are simply irrelevant for users.
The Parquet format has proved to be handy:
- Data is organized by column, rather than by row, which saves storage space and speeds up analytics queries, i.e. you can select just the columns you care about, optimizing query performances, even on entry-level computers.
- Highly efficient data compression and decompression, making it good for storing and sharing big datasets of any kind,
- Supports complex data types and advanced nested data structures.
The dataset is available on Hugging Face, a collaborative Machine Learning ecosystem where developers and researchers can share models and datasets.
Find more information in the Wiki, including guidelines for data reuse and example queries to get started.Tietojen CSV-vienti
Kaikkien tuotteiden tai joidenkin tuotteiden tiedot voidaan ladata CSV-muodossa (luettavissa LibreOfficella, Excelillä ja monilla muilla taulukkolaskentaohjelmilla) tarkennetun hakulomakkeenkautta.
- Linkki
- Food: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)
- Cosmetics: https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz
- Pet Food: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz
- All other products: https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz
Tiedoston merkistökoodaus on Unicode UTF-8. Kenttien erottimena on <sarkain>.
Kuvatietojen vienti
The database is also available in the RDF format (this is an experiment, not actively maintained anymore). Voit lukea ilmoituksen ranskaksi.
OpenAPI-apua kaivataan
Kaikki kuvat ja OCR-tulokset voidaan ladata joko palvelimeltamme tai AWS:stä (AWS Open Data Program -ohjelman kautta). Check out our documentation to learn more about how to download images
OpenAPI Documentation for the JSON API
Myös JSON API on saatavilla tuotteen tietojen lukemiseen. This API is in particular used in the Open Food Facts mobile app.
Parannamme ohjelmointirajapintaa ajan myötä, mutta huolehdimme yhteensopivuudesta aiempien versioiden kanssa. ota yhteyttä jos käytät sitä, jotta voimme kertoa sinulle mahdollisista muutoksista.
Discover our APIContributing to improving our API and OpenAPI documentation
We're eager to finish the documentation of the API, add use-cases, and automate SDK generation. If you are an OpenAPI connoisseur, you are very welcome to help.
You are very welcome to use the API for production cases, as long as 1 API call = 1 real scan by a user. Any attempt to scrape the database using the API will very likely be blocked, as full daily exports are available on this very page.
Also, sending an HTTP header with your API call is a good way we can get in touch, should any issue arise.
XML API (unsupported)
The code for the official Open Food Facts mobile apps is available on GitHub Flutter Kotlin Android Swift iOS
We look to turn the deprecated Kotlin and Swift codebases into Kotlin and Swift SDKs, help welcome :-)
Tätä API:ta ei ylläpidetä aktiivisesti, eikä sitä ole dokumentoitu virallisesti.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 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 flown niin, että he saavat heti tuloksen pienellä vaivalla.
Jos käyttäjäsi eivät odota tulosta heti (esim. varastosovellukset)
- Lähetä valokuvat (etu/ravinto/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
Android/iPhone/Flutter mobile app
- Lähetä ravitsemustiedot + kategoria > saat Nutri-Scoren
- Ilmoita ainesosat > hanki NOVA-ryhmä (ruoan ultraprosessoinnista), lisäaineet, allergeenit, normalisoidut ainesosat, vegaani, vegetaari…
- Lähetä luokka + tunnisteet > saat pian Eco-Scoren (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
Icon | Language / Framework | Resursseja | Discussion |
---|---|---|---|
Cordova (Old App) | GitHub | N/A | |
DART | GitHub pub.dev | N/A | |
Elixir | GitHub | Slack Channel | |
Go | GitHub | Slack Channel | |
Java | GitHub | Slack Channel | |
Spring Boot | GitHub | Slack Channel | |
Kotlin | GitHub | Slack Channel | |
NodeJS | 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
You can open a thread on our API documentation repository
Jos sinulla on kysyttävää datasta, voit ottaa meihin yhteyttä osoitteeseen reuse@openfoodfacts.org