Verarbeitungszustände

Jedes Lebensmittel in unserer Datenbank kann in mehreren Verarbeitungszuständen vorliegen, zum Beispiel roh, gebacken, gebraten oder getrocknet. Diese Zustände beschreiben die Zubereitungsart (wie das Produkt vor dem Verzehr zubereitet wurde) und können das Nährwertprofil eines Lebensmittels deutlich beeinflussen.

Für Evaluierungen ist es nicht notwendig, den Verarbeitungszustand separat zu übergeben, da er bereits im Suffix des Feldes id codiert ist. Beispielsweise entspricht ein Eintrag mit der ID 34fc3077ad18b277_08 der gerösteten Variante des Lebensmittels.

Standard-Processing-State

Wir stellen ein Attribut standard_processing bereit. Es beschreibt den Verarbeitungszustand, in dem ein Lebensmittel typischerweise verzehrt wird.

Dieses Feld soll die Nährwertgenauigkeit verbessern. Zum Beispiel können 100 g rohe Nudeln und 100 g gekochte Nudeln ein sehr unterschiedliches Nährwertprofil haben, während die meisten Nutzer Nudeln üblicherweise gekocht verzehren.

Dieses Attribut ist dafür gedacht, den passendsten Verarbeitungszustand für den Nutzer vorauszuwählen und die Anzahl der notwendigen Klicks beim Tracking zu reduzieren.

Wenn Sie Nutzern aus Komplexitätsgründen nicht ermöglichen möchten, den Verarbeitungszustand des verzehrten Lebensmittels selbst auszuwählen, empfehlen wir ausdrücklich, das Lebensmittel automatisch im gelieferten standard_processing-Zustand zu tracken, anstatt einfach standardmäßig "raw" zu verwenden.

standard_processing ist niemals leer.
Der Standardwert ist "raw".
Wenn ein standard_processing-Wert geliefert wird, ist garantiert, dass die entsprechende Processing-Variante für dieses Lebensmittel existiert.

Hinweise zu Processing States

Processing States können etwas komplexer sein, als sie auf den ersten Blick erscheinen.

Zum Beispiel könnte eine getrocknete Tomate aktuell entweder dargestellt werden als:

"Tomate" mit dem Processing State "dried", oder
"Getrocknete Tomate" mit dem Processing State "raw".

Für einen regulären "Tomate"-Eintrag wäre standard_processing höchstwahrscheinlich "raw".

Welche Darstellung verwendet wird, hängt vom konkreten Lebensmitteleintrag und den zugrunde liegenden Quelldaten ab. Das bereitgestellte standard_processing berücksichtigt dies bereits.

Langfristig möchten wir, wo möglich, von separaten generischen Lebensmitteleinträgen wie "Getrocknete Tomate" wegkommen. Stattdessen ist unser Ziel, bei Suchanfragen wie "Getrocknete Tomate" "Tomate" mit dem Processing State "dried" zurückzugeben.

Das Gleiche gilt für bereits zubereitete Gerichte oder Markenprodukte. Zum Beispiel kann ein Gericht wie "Lachs mit Spinat und Ei" oder eine Marken-Tiefkühlpizza weiterhin "raw" als Processing State verwenden, weil die Nährwerte bereits für das zubereitete oder verarbeitete Produkt selbst gespeichert sind. In diesen Fällen bedeutet "raw" nicht zwangsläufig, dass es sich um eine unverarbeitete rohe Zutat handelt.

Wir orientieren den Processing State an den Nährwertdaten, die für das jeweilige Lebensmittel verfügbar sind. Wenn kein spezifischerer Processing State bestimmt werden kann oder keinen sinnvollen Genauigkeitsgewinn bringen würde, verwenden wir standardmäßig "raw".

Es kann außerdem Lebensmittel geben, bei denen keine zusätzlichen Processing States verfügbar sind, weil sie aus Nährwertperspektive nicht sinnvoll sind. Zum Beispiel würde das Kochen oder Braten von Salz keinen relevanten Nährwertunterschied ergeben.

Wir bemühen uns um eine breite Abdeckung von Processing States, wo dies die Nährwertgenauigkeit verbessert. Wenn für ein Lebensmittel jedoch nur "raw" verfügbar ist, ist das nicht automatisch ein Fehler. In vielen Fällen ist "raw" der korrekte und empfohlene Processing State.

Empfehlungen für die Darstellung im Frontend

Das hält die Oberfläche einfach und verhindert vor allem Missverständnisse: raw bezeichnet in unserem Datenmodell die Basisvariante eines Lebensmitteleintrags und bedeutet nicht zwangsläufig, dass das Lebensmittel im alltäglichen Sinne roh oder unverarbeitet ist.

Bei Markenprodukten (Branded Foods) beziehen sich die Nährwerte immer auf den Zustand, in dem das Produkt verkauft wird. Bei zusammengesetzten Lebensmitteln und Gerichten (Composite Foods) mit nur einem Verarbeitungszustand beziehen sie sich auf das Gericht in der zubereiteten, zum Verzehr vorgesehenen Form.

Ein Eintrag wie „Nudeln mit Pesto“ beschreibt daher bereits das zubereitete Gericht, auch wenn sein einziger Verarbeitungszustand raw ist. Diese Darstellung ist aus mehreren Gründen sinnvoll:

Die Zutaten können unterschiedlich verarbeitet sein. Die Nudeln sind beispielsweise gekocht, während andere Bestandteile nicht erhitzt wurden. Ein einzelner Zustand wie boiled würde die Zubereitung des gesamten Gerichts nicht treffend beschreiben.
Die Zubereitung ist bereits im Lebensmitteleintrag berücksichtigt. Die Nährwerte gehören zum fertigen Gericht, nicht zu einer hypothetischen Mischung seiner rohen Ausgangszutaten.
Verarbeitungsvarianten sollen relevante Unterschiede abbilden. Ein zusätzlicher Zustand allein zur verständlicheren Beschriftung würde keine eigenständige Variante mit einem anderen Nährwertprofil schaffen.

Ein sichtbares Label „roh“ könnte hier fälschlicherweise suggerieren, dass die Nährwerte für ungekochte Nudeln gelten. Wenn Sie den Verarbeitungszustand bei nur einer verfügbaren Variante grundsätzlich ausblenden, vermeiden Sie solche Missverständnisse, ohne im Frontend produktspezifische Sonderfälle unterscheiden zu müssen.

Sind hingegen mehrere Verarbeitungszustände verfügbar, ist eine Auswahl sinnvoll und sollte angeboten werden. Dabei sollte standard_processing vorausgewählt sein, damit Nutzer nur dann eingreifen müssen, wenn sie eine andere Variante verzehrt haben.

Processing Keys und Anzeigelabels

Die in dieser Dokumentation aufgeführten deutschen und englischen Labels sind ausschließlich Vorschläge für die Darstellung. Wir behalten uns ausdrücklich vor, diese Labels zu ändern; sie sind keine verbindlichen technischen Bezeichner.

Die API liefert in v2.1 keine Labels für Verarbeitungszustände mit. Verwenden Sie für die Zuordnung und Verarbeitung in Ihrer Integration daher die Processing Keys, beispielsweise raw oder boiled, und leiten Sie keine Programmlogik aus den vorgeschlagenen Labels ab. Für die Anzeige im Frontend können Sie den Keys eigene, bei Bedarf übersetzte Anzeigetexte zuordnen. Die Empfehlung, bei nur einer verfügbaren Variante auf jede Kennzeichnung des Verarbeitungszustands zu verzichten, gilt dabei weiterhin.

Codes für Verarbeitungszustände

Processing Key	Suggested Label EN	Suggested Label DE	Code	Verfügbarkeit
`raw`	raw	roh	`00`	Immer
`baked`	baked	gebacken	`01`	Bedingt
`boiled`	boiled	gekocht	`02`	Bedingt
`braised`	braised	geschmort	`03`	Bedingt
`broiled`	broiled	gegrillt	`04`	Bedingt
`deep-fried`	deep-fried	frittiert	`05`	Bedingt
`dried`	dried	getrocknet	`06`	Bedingt
`fried`	fried	gebraten	`07`	Bedingt
`roasted`	roasted	geröstet	`08`	Bedingt
`steamed`	steamed	gedämpft	`09`	Bedingt
`stewed`	stewed	gedünstet	`10`	Bedingt