Ingredienti
Ricette, forniture e prodotti sono liste di ingredienti. Tutti e tre usano lo stesso oggetto ingrediente, descritto in questa pagina.
- Una ricetta elenca i suoi ingredienti in
ingredients. Vedere Ricette. - Una fornitura elenca gli articoli consegnati in
ingredients. Vedere Forniture. - Un prodotto è un ingrediente che salvate una volta sola e a cui fate riferimento da molte ricette. Vedere Prodotti.
| Argomento | Sezione |
|---|---|
| Esempio | Schema dell'ingrediente |
| Campi obbligatori | Proprietà obbligatorie |
| Campi che migliorano il risultato | Proprietà principali facoltative |
| Valori ammessi: origin, transport, production, processing, conservation, packaging, unit | Valori dei campi dell'ingrediente |
| Definire un ingrediente o farvi riferimento | Tipi di ingrediente |
| Cosa viene restituito per ogni ingrediente | Campi della response per ingrediente |
| Come vengono abbinati i nomi | Matching degli ingredienti |
Schema dell'ingrediente
{
"id": "tomatoes-001",
"names": [
{"language": "en", "value": "Cherry Tomatoes"},
{"language": "de", "value": "Kirschtomaten"}
],
"amount": 200,
"unit": "gram",
"origin": "Italy",
"transport": "ground",
"production": "organic",
"conservation": "fresh",
"packaging": "plastic",
"producer": "BioFarm AG"
}
Proprietà obbligatorie
Proprietà principali facoltative
Per ridurre le ambiguità e limitare le verifiche manuali, raccomandiamo vivamente di indicare alcuni attributi degli ingredienti anche se tecnicamente facoltativi. Tra questi: trasportato per via aerea, fresco, surgelato, essiccato, conservato, cotto al forno, in scatola, bollito, biologico, certificato Fairtrade e da acquacoltura (per il pesce). Fornire questi dati fin dall'inizio evita ipotesi errate e chiarimenti successivi.
| Proprietà | Tipo | Default | Descrizione |
|---|---|---|---|
type | String | conceptual-ingredients | Indica se questa riga definisce un ingrediente o fa riferimento a uno già salvato. Vedere Tipi di ingrediente. |
loss-in-percent-of-amount | Float | - | Perdita alimentare in percentuale della quantità dell'ingrediente (0–100), ad esempio per sbucciatura, rifilatura o deterioramento. L'impatto ambientale viene calcolato sull'intera quantità indicata, mentre solo la quantità netta restante (amount × (1 − loss / 100)) conta per il peso e i valori nutrizionali della ricetta. Da preferire alla modifica del campo weight della ricetta per modellare le perdite. |
origin | String | - | Origine dell'ingrediente: indirizzo postale o paese |
transport | String | - | Mezzo di trasporto dall'origine alla cucina: air o ground |
production | String | - | Metodo di produzione: standard, greenhouse, organic, fair-trade, farm, wild-caught, sustainable-fish |
processing | String | - | Livello di lavorazione: raw. Carne/pesce: unboned, boned. Pesce: skinned, beheaded, fillet. Verdura/frutta: cut, boiled, peeled. |
conservation | String | - | Metodo di conservazione: fresh, frozen, dried, conserved, canned, boiled-down |
packaging | String | - | Tipo di imballaggio: none, plastic, paper, pet, tin, alu, glas, cardboard, tetra |
producer | String | - | Produttore o marca del prodotto. Particolarmente importante per i prodotti composti (prodotti con più ingredienti). |
gtin | String | - | Global Trade Item Number (codice a barre) per i prodotti confezionati |
ingredients-declaration | String | - | Lista ingredienti come dichiarata sugli alimenti confezionati |
nutrient-values | Object | - | Valori nutrizionali strutturati per 100g (vedere Riferimento) |
Valori ammessi, default e valori multipli per campo: Valori dei campi dell'ingrediente.
Valori dei campi dell'ingrediente
Gli attributi seguenti descrivono la provenienza di un ingrediente e come viene prodotto, lavorato, conservato e imballato. Sono facoltativi, ma ognuno rende il risultato più preciso.
origin
Dove è stato prodotto l'ingrediente. Determina i calcoli della distanza di trasporto e della stagionalità.
| Formato | Esempio | Descrizione |
|---|---|---|
| Paese | "Italy" | Paese di produzione |
| Indirizzo postale | "8005 Zurich, Switzerland" | Luogo specifico per distanze di trasporto precise |
Default: se omesso, viene stimata un'origine rappresentativa in base all'ingrediente e alla posizione della cucina.
transport
Come l'ingrediente viene trasportato dall'origine alla cucina.
| Valore | Descrizione | Impatto CO₂ |
|---|---|---|
ground | Trasporto su strada, ferrovia o nave | Più basso |
air | Trasporto aereo | Più alto (10-50x rispetto a ground) |
Default: nessuno. Se omesso, il mezzo di trasporto viene stimato in base a origine e destinazione.
production
Il metodo di produzione usato per coltivare o produrre l'ingrediente.
| Valore | Descrizione |
|---|---|
standard | Agricoltura/produzione convenzionale |
greenhouse | Coltivato in serra riscaldata |
organic | Produzione biologica certificata |
fair-trade | Certificato commercio equo |
farm | Produzione in piccola azienda agricola |
wild-caught | Pescato in natura (prodotti ittici) |
sustainable-fish | Pesca certificata sostenibile |
processing
Il livello di lavorazione applicato all'ingrediente.
| Valore | Descrizione |
|---|---|
raw | Ingrediente intero, non lavorato |
unboned | Con ossa/lische (carne/pesce) |
boned | Disossato |
skinned | Senza pelle |
beheaded | Senza testa (pesce) |
fillet | Sfilettato (carne/pesce) |
cut | Tagliato a pezzi |
boiled | Precotto per bollitura |
peeled | Sbucciato |
conservation
Come l'ingrediente viene conservato.
| Valore | Descrizione | Impatto energetico |
|---|---|---|
fresh | Nessuna conservazione, breve durata | Il più basso |
frozen | Conservazione surgelata | Più alto (catena del freddo) |
dried | Essiccato | Basso |
conserved | Conservato (sale, zucchero, ecc.) | Basso |
canned | In scatola | Medio |
boiled-down | Ridotto/concentrato | Medio |
packaging
Il materiale di imballaggio usato.
| Valore | Descrizione |
|---|---|
none | Nessun imballaggio (sfuso) |
plastic | Imballaggio in plastica |
paper | Carta/cartone |
pet | Bottiglie in PET |
tin | Lattine |
alu | Alluminio |
glas | Contenitori in vetro |
cardboard | Scatole di cartone |
tetra | Confezioni Tetra Pak |
unit
L'unità di misura della quantità dell'ingrediente.
| Valore | Descrizione |
|---|---|
gram | Peso in grammi |
liter | Volume in litri |
Convertite sempre in grammi o litri:
- 1 kg = 1000 grammi
- 1 ml = 0.001 litri
- 1 oz ≈ 28.35 grammi
- 1 cup ≈ 240 ml = 0.24 litri
I campi origin, transport, production, processing, conservation e packaging accettano valori separati da virgola quando ne valgono più di uno. Ad esempio: "production": "organic, fair-trade".
Tipi di ingrediente
Ogni ingrediente ha un type. Il tipo decide a cosa si riferisce l'ingrediente e se il salvataggio della ricetta scrive anche l'oggetto indicato da quell'id.
type | Si riferisce a | Il salvataggio della ricetta scrive quell'oggetto? | Se l'id non esiste |
|---|---|---|---|
conceptual-ingredients (default) | un ingrediente definito inline | Sì — viene creato, oppure sovrascritto per ogni ricetta che usa già quell'id | Viene creato |
recipes | una ricetta salvata (una sotto-ricetta) | No | 612 |
products | un prodotto salvato | No | 612 (anche per un id che è solo un ingrediente) |
// DEFINE an ingredient, here and now (default)
{
"id": "rice-001",
"type": "conceptual-ingredients",
"names": [{"language": "en", "value": "Risotto rice"}],
"amount": 200,
"unit": "gram"
}
// REFERENCE a stored recipe (sub-recipe)
{
"id": "tomato-sauce-001",
"type": "recipes",
"amount": 150,
"unit": "gram"
}
// REFERENCE a stored product -- no name needed, just the id and how much goes in
{
"id": "carrot-puree-500g",
"type": "products",
"amount": 300,
"unit": "gram"
}
Solo conceptual-ingredients scrive: se riusate un id con questo tipo, i vostri dati sostituiscono quelli esistenti, per ogni ricetta che usa quell'id. Per un articolo che riusate, salvatelo una volta come prodotto e fate riferimento a quello.
Campi della response per ingrediente
Vedere Campi della response per ingrediente.
Matching degli ingredienti
L'API usa un matching approssimativo (fuzzy) per identificare gli ingredienti nel database Eaternity di oltre 50.000 voci.
Come funziona il matching:
- Normalizzazione del nome: rimuove i caratteri speciali, normalizza l'ortografia
- Ricerca nel database: cerca tra oltre 50.000 voci di ingredienti
- Punteggio di somiglianza: calcola l'affidabilità del matching (0-100%)
- Scelta del miglior matching: restituisce il matching con l'affidabilità più alta
- Fallback: usa una categoria generica se non trova un matching vicino
Migliorare la qualità del matching:
- Usate nomi specifici: "Parmesan Cheese" invece di "Cheese"
- Indicate il metodo di preparazione: "Fresh Cherry Tomatoes" invece di "Tomatoes"
- Specificate il taglio o la forma: "Beef Sirloin Steak" invece di "Beef"
- Aggiungete la marca tramite il campo
producerper gli articoli confezionati