Tipi di dati dell'API Google Health

La tabella seguente contiene l'elenco completo dei tipi di dati, con diverse colonne per aiutarti a comprendere la rappresentazione di ogni tipo nell'API Google Health, nonché l'ambito in cui è disponibile.

Importante: il formato degli identificatori dei tipi di dati è diverso quando il tipo di dati è composto da più di una parola. In un endpoint, il nome del tipo di dati deve essere in formato kebab case, ad esempio body-fat. In un parametro di filtro, tuttavia, il nome del tipo di dati deve essere in formato snake case, ad esempio body_fat.

Tabella: tipi di dati dell'API Google Health

Tipo di dati   ID endpoint   Parametro di filtro	Tipo di record	Operazioni disponibili	Ambito	Supporto webhook
Minuti attivi   active-minutes   active_minutes	Intervallo	reconcile, rollup, dailyRollup	activity_and_fitness
Minuti in zona attiva   active-zone-minutes   active_zone_minutes	Intervallo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Livello di attività   activity-level   activity_level	Intervallo	list, reconcile	activity_and_fitness
Altitudine   altitude   altitude	Intervallo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Grasso corporeo   body-fat   body_fat	Esempio	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements
Calorie nella zona cardio   calories-in-heart-rate-zone   calories_in_heart_rate_zone	Intervallo	rollup, dailyRollup	activity_and_fitness
Variabilità del battito cardiaco giornaliera   daily-heart-rate-variability   daily_heart_rate_variability	Ogni giorno	list, reconcile	health_metrics_and_measurements
Zone cardio giornaliere   daily-heart-rate-zones   daily_heart_rate_zones	Ogni giorno	reconcile	health_metrics_and_measurements
Saturazione di ossigeno giornaliera   daily-oxygen-saturation   daily_oxygen_saturation	Ogni giorno	list, reconcile	health_metrics_and_measurements
Frequenza respiratoria giornaliera   daily-respiratory-rate   daily_respiratory_rate	Ogni giorno	list, reconcile	health_metrics_and_measurements
Battito cardiaco a riposo giornaliero   daily-resting-heart-rate   daily_resting_heart_rate	Ogni giorno	list, reconcile	health_metrics_and_measurements
Derivazioni della temperatura del sonno giornaliera   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	Ogni giorno	list, reconcile	health_metrics_and_measurements
VO2 max giornaliero   daily-vo2-max   daily_vo2_max	Ogni giorno	list, reconcile	activity_and_fitness
Distanza   distance   distance	Intervallo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Allenamento   exercise   exercise	Sessione	list, get, reconcile, create, update, batchDelete	activity_and_fitness
Piani   floors   floors	Intervallo	reconcile, rollup, dailyRollup	activity_and_fitness
Battito cardiaco   heart-rate   heart_rate	Esempio	list, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Variabilità del battito cardiaco   heart-rate-variability   heart_rate_variability	Esempio	list, reconcile	health_metrics_and_measurements
Diario dell'idratazione   hydration-log   hydration_log	Sessione	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	nutrition
Saturazione di ossigeno   oxygen-saturation   oxygen_saturation	Esempio	list, reconcile	health_metrics_and_measurements
Riepilogo della frequenza respiratoria durante il sonno   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	Esempio	list, reconcile	health_metrics_and_measurements
Corsa VO2 max   run-vo2-max   run_vo2_max	Esempio	list, reconcile, rollup, dailyRollup	activity_and_fitness
Periodo di sedentarietà   sedentary-period   sedentary_period	Intervallo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Sonno   sleep   sleep	Sessione	list, get, reconcile, create, update, batchDelete	sleep
Passi   steps   steps	Intervallo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Tempo nella zona cardio   time-in-heart-rate-zone   time_in_heart_rate_zone	Intervallo	reconcile, rollup, dailyRollup	activity_and_fitness
Calorie totali   total-calories   total_calories	Intervallo	rollup, dailyRollup	activity_and_fitness
VO2 max   vo2-max   vo2_max	Esempio	list, reconcile	activity_and_fitness
Peso   weight   weight	Esempio	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements

Disponibilità dei dati

Gli aggiornamenti ai dati dell'utente sono disponibili solo dopo che l'utente ha sincronizzato il tracker di attività o ha inserito manualmente nuovi dati nell'app mobile o web Fitbit. Il dispositivo Fitbit e l'app mobile Fitbit possono sincronizzarsi automaticamente ogni 15 minuti quando l'app Fitbit è aperta sul dispositivo mobile e i due hanno una connessione dati attiva e si trovano nel raggio d'azione del Bluetooth. Se l'utente sta monitorando l'attività utilizzando MobileTrack, MobileTrack si sincronizza ogni ora finché l'app è aperta.

Standard di distanza

Le distanze degli allenamenti, ad esempio elevationGainMillimeters, vengono misurate in millimetri come unità standard per i seguenti motivi:

1. Mantenimento della precisione dei dati: il motivo più importante per l'utilizzo dei millimetri è garantire che non venga persa la precisione dei dati letti e forniti. L'utilizzo di un'unità a grana fine come i millimetri consente di rappresentare le misurazioni con elevata precisione.
2. Standardizzazione: i millimetri sono l'unità standardizzata progettata per i nostri servizi. Questa coerenza contribuisce a garantire un'esperienza uniforme per gli sviluppatori che interagiscono con diverse parti dell'API.
3. Ampio supporto per i sistemi di misurazione: l'utilizzo di un'unità di base come i millimetri consente agli sviluppatori di convertire facilmente in qualsiasi altra unità scelta, indipendentemente dal fatto che stiano lavorando con sistemi di misurazione metrici, imperial o di altro tipo.