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 la spesa totale, il consumo attivo e il metabolismo basale a riposo.

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 la misurazione delle calorie e del dispendio energetico:

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

Tipo di dati   dataType Parametro   filter	Tipo di record	Operazioni disponibili	Ambito	Supporto webhook	Supporto per i veri zeri
Energia attiva bruciata   active-energy-burned   active_energy_burned	Intervallo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Energia basale bruciata   basal-energy-burned   basal_energy_burned	Intervallo	list, reconcile	activity_and_fitness
Tasso metabolico basale   basal-metabolic-rate   basal_metabolic_rate	Esempio	list, reconcile	alimentazione

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 a partire dalla spesa energetica attiva e dal metabolismo basale dell'utente.

Nota: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 query sul tipo di dati total-calories, invia una richiesta all'endpoint list con un filtro 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, misurato 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

L'energia basale bruciata 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 dell'energia basale, utilizza il tipo di dati Tasso metabolico basale.

Tasso metabolico basale

Il metabolismo 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 (come il peso) nel tempo, l'API registra il BMR come una serie temporale di campioni di velocità.

Gli sviluppatori possono considerare il campo rateKcalPerDay in un campione basal-metabolic-rate come la controparte giornaliera di un rollup giornaliero dell'energia basale bruciata.

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, segui queste linee guida:

• Panoramica giornaliera: per mostrare la spesa calorica giornaliera complessiva, 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 del metabolismo basale, esegui query su basal-metabolic-rate per i valori del BMR. Considera i campioni di BMR come valore di riferimento giornaliero per il consumo energetico a riposo dell'utente.