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 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 relativi alle calorie dell'API Google Health
Tipo di dati
  dataType
  filter parametro		 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
Calorie totali
  total-calories
  total_calories 		Intervallo rollup, dailyRollup activity_and_fitness

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 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 durante l'attività fisica 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.
Indietro
Compatibilità del dispositivo
Avanti
Parametri vitali