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 consumo di energia, tra cui il dispendio totale, il consumo attivo e i tassi metabolici a riposo (basali).

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	Tipo di record	Operazioni disponibili	Ambito	Supporto webhook	Supporto per veri zeri
Dispendio energetico durante l'attività fisica   active-energy-burned   active_energy_burned	Intervallo	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Calorie totali   total-calories   total_calories	Intervallo	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

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 derivato di sola lettura che tiene traccia di 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 metabolismo basale dell'utente.

Le query per il tipo di dati total-calories devono includere un filtro dell'intervallo di tempo (ad esempio total_calories.interval.start_time o total_calories.interval.civil_start_time). L'intervallo massimo per queste query è di 14 giorni.

Esempio di query

Per eseguire una query sul tipo di dati total-calories, invia una richiesta all'endpoint list con un filtro dell'intervallo:

Richiesta

GET https://health.googleapis.com/v4/users/me/dataTypes/total-calories/dataPoints?filter=total_calories.interval.start_time >= "2026-04-20T00:00:00Z" AND total_calories.interval.start_time < "2026-04-21T00:00:00Z"
Authorization: Bearer access-token
Accept: application/json

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
}

Linee guida

Quando integri le metriche relative a calorie ed energia nella tua app, segui 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 metabolismo a riposo, esegui una query su active-energy-burned.