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 ciascun tipo nell'API Google Health, nonché l'ambito in cui è disponibile ciascun tipo.

Importante: il formato degli identificatori del tipo 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 snake case, ad esempio body_fat.

Tabella: tipi di dati dell'API Google Health

Tipo di dati   dataType Parametro   filter	Record type	Operazioni disponibili	Ambito	Supporto webhook
Energia bruciata attiva   active-energy-burned   active_energy_burned	Intervallo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Minuti attivi   active-minutes   active_minutes	Intervallo	list, 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
Glicemia   blood-glucose   blood_glucose	Esempio	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Grasso corporeo   body-fat   body_fat	Esempio	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements
Calorie nella zona battito cardiaco   calories-in-heart-rate-zone   calories_in_heart_rate_zone	Intervallo	rollup, dailyRollup	activity_and_fitness
Temperatura corporea interna   core-body-temperature   core_body_temperature	Esempio	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Variabilità del battito cardiaco giornaliera   daily-heart-rate-variability   daily_heart_rate_variability	Ogni giorno	list, reconcile	health_metrics_and_measurements
Zone battito cardiaco giornaliere   daily-heart-rate-zones   daily_heart_rate_zones	Ogni giorno	list, 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 giornaliere della temperatura del sonno   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
Elettrocardiogramma (ECG)   electrocardiogram   electrocardiogram	Sessione	list	ecg
Allenamento   exercise   exercise	Sessione	list, get, reconcile, create, update, batchDelete	activity_and_fitness
Piani   floors   floors	Intervallo	reconcile, rollup, dailyRollup	activity_and_fitness
Cibo   food   food	Cibo	list, get	alimentazione
Unità di misura degli alimenti   food-measurement-unit   food_measurement_unit	Cibo	list, get	alimentazione
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
Altezza   height   height	Esempio	list, get, reconcile, create, update, batchDelete	health_metrics_and_measurements
Diario dell'idratazione   hydration-log   hydration_log	Sessione	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	alimentazione
Notifica di ritmo irregolare   irregular-rhythm-notification   irregular_rhythm_notification	Sessione	list	irn
Diario alimentare   nutrition-log   nutrition_log	Esempio	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	alimentazione
Saturazione di ossigeno   oxygen-saturation   oxygen_saturation	Esempio	list, reconcile	health_metrics_and_measurements
Riepilogo del sonno della frequenza respiratoria   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	Esempio	list, reconcile	health_metrics_and_measurements
VO2 max corsa   run-vo2-max   run_vo2_max	Esempio	list, reconcile, rollup, dailyRollup	activity_and_fitness
Periodo sedentario   sedentary-period   sedentary_period	Intervallo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Sonno   sleep   sleep	Sessione	list, get, reconcile, create, update, batchDelete	sonno
Passaggi   steps   steps	Intervallo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Dati sulle vasche   swim-lengths-data   swim_lengths_data	Intervallo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Tempo nella zona battito cardiaco   time-in-heart-rate-zone   time_in_heart_rate_zone	Intervallo	list, 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 la sincronizzazione del tracker di attività o l'inserimento manuale di nuovi dati nell'app mobile o nell'app 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 dispositivi hanno una connessione dati attiva e si trovano nel raggio d'azione del Bluetooth. Se l'utente monitora l'attività utilizzando MobileTrack, la sincronizzazione viene eseguita ogni ora finché l'app è aperta.

Accesso di terze parti

I dispositivi Fitbit non possono comunicare direttamente con applicazioni o servizi di terze parti. Questi dispositivi sono progettati per comunicare e sincronizzarsi esclusivamente con l'app mobile Fitbit.

Il dispositivo sincronizza automaticamente i dati durante il giorno, ogni volta che l'app Fitbit è aperta o ogni 15 minuti se il Bluetooth è attivo e l'app è in esecuzione in background. Una volta completata questa procedura di sincronizzazione, i dati sono disponibili per i servizi di terze parti tramite l'API Google Health.

Standard di distanza

Le distanze degli esercizi, 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 utilizzare i millimetri è garantire di non perdere precisione nei dati che leggiamo e forniamo. L'utilizzo di un'unità di misura precisa come i millimetri ci consente di rappresentare le misurazioni con elevata precisione.
2. Standardizzazione: i millimetri sono l'unità standardizzata progettata per tutti i nostri servizi. Questa coerenza contribuisce a garantire un'esperienza uniforme per gli sviluppatori che interagiscono con diverse parti dell'API.
3. Ampio supporto del sistema di misurazione: l'utilizzo di un'unità di base come i millimetri consente agli sviluppatori di eseguire facilmente la conversione in qualsiasi altra unità scelta, indipendentemente dal fatto che utilizzino sistemi di misurazione metrici, imperiali o di altro tipo.