Tipi di dati relativi a calorie ed energia

L'API Google Health fornisce tipi di dati che monitorano le calorie e il dispendio energetico di un utente. Questi tipi misurano diversi aspetti del dispendio energetico, tra cui il dispendio totale, il dispendio durante l'attività fisica e il tasso metabolico a riposo (basale).

Comprendi le differenze tra questi tipi di dati per determinare quali metriche sono adatte alla tua applicazione.

Tipi di dati supportati

L'API supporta i seguenti tipi di dati per misurare le calorie e il dispendio energetico:

Tabella: tipi di dati sulle calorie dell'API Google Health

Tipo di dati   dataType   filter parameter	Record type	Available operations	Scope	Webhook support	True zeros support
Dispendio energetico durante l'attività fisica   active-energy-burned   active_energy_burned	Intervallo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Metabolismo basale   basal-energy-burned   basal_energy_burned	Intervallo	list, reconcile	activity_and_fitness
Tasso metabolico basale   basal-metabolic-rate   basal_metabolic_rate	Esempio	list, reconcile	nutrition

Le sezioni seguenti forniscono dettagli tecnici per ogni tipo di dati, inclusi esempi di rappresentazione REST e vincoli di integrazione specifici.

Calorie totali

Calorie totali è un tipo di dati derivati di sola lettura che monitora tutta l'energia spesa da un utente, inclusi il metabolismo basale e l'energia attiva, misurata in chilocalorie (kcal). Il valore viene calcolato in base al dispendio energetico attivo e al tasso metabolico basale dell'utente.

Dispendio energetico durante l'attività fisica

Dispendio energetico durante l'attività fisica rappresenta l'energia bruciata dall'utente durante i periodi di attività, escluso il dispendio energetico basale, misurata in chilocalorie (kcal).

Esempio di rappresentazione REST

{
  "startTime": "2026-04-20T08:00:00Z",
  "startUtcOffset": "0s",
  "endTime": "2026-04-20T08:30:00Z",
  "endUtcOffset": "0s",
  "dataSource": { ... },
  "kcal": 150.0
}

Metabolismo basale

Metabolismo basale rappresenta le calorie bruciate a causa del metabolismo a riposo dell'utente in intervalli di tempo, misurate in chilocalorie (kcal).

Nota: le operazioni di rollup e rollup giornaliero non sono disponibili per questo tipo di dati. Per ottenere i valori giornalieri del metabolismo basale, utilizza il tipo di dati Tasso metabolico basale.

Tasso metabolico basale

Tasso metabolico basale misura l'energia spesa da un corpo in uno stato normale di riposo, misurata in chilocalorie al giorno (kcal/day). Poiché questa velocità fluttua con gli aggiornamenti fisici (ad esempio il peso) nel tempo, l'API registra il BMR come una serie temporale di campioni di velocità.

Gli sviluppatori possono trattare il campo rateKcalPerDay in un campione basal-metabolic-rate come la controparte giornaliera di un rollup giornaliero del metabolismo basale.

Esempio di rappresentazione REST

{
  "date": {
    "year": 2026,
    "month": 4,
    "day": 20
  },
  "dataSource": { ... },
  "rateKcalPerDay": 1650.0
}

Linee guida

Quando integri le metriche relative a calorie ed energia nella tua app, utilizza queste linee guida:

• Panoramica giornaliera: per mostrare il dispendio calorico giornaliero complessivo, richiedi il rollup giornaliero del tipo di dati total-calories.
• Spesa solo per l'attività: per monitorare le calorie bruciate durante un allenamento specifico o durante la giornata, escluso il tasso metabolico a riposo, esegui una query su active-energy-burned.
• Metriche basali: per monitorare il tasso metabolico a riposo o le tendenze metaboliche basali, esegui una query su basal-metabolic-rate per i valori BMR. Tratta i campioni BMR come una base giornaliera per il consumo energetico a riposo dell'utente.