Типы данных API Google Health

В следующей таблице представлен полный список типов данных, с несколькими столбцами, которые помогут вам понять представление каждого типа в API Google Health, а также область его доступности.

Важно: формат идентификаторов типов данных различается, если тип данных состоит из более чем одного слова. В конечной точке имя типа данных должно быть написано в формате "kebab case", например, body-fat . Однако в параметре фильтра имя типа данных должно быть написано в формате "snake case", например, body_fat .

Таблица: Типы данных API Google Health

Тип данных dataType параметр filter	Записывать тип	Доступный операции	Объем	Вебхук поддерживать	Истинные нули поддерживать
Сожженная активная энергия active-energy-burned active_energy_burned	Интервал	список, сверка, свертка, ежедневная сводка	активность_и_фитнес
Активные минуты active-minutes active_minutes	Интервал	список, сверка, свертка, ежедневная сводка	активность_и_фитнес
Минуты активной зоны active-zone-minutes active_zone_minutes	Интервал	список, сверка, свертка, ежедневная сводка	активность_и_фитнес
Уровень активности activity-level activity_level	Интервал	список, согласовать	активность_и_фитнес
Высота altitude altitude	Интервал	список, сверка, свертка, ежедневная сводка	активность_и_фитнес
Уровень глюкозы в крови blood-glucose blood_glucose	Образец	список, получить, согласовать, свернуть, ежедневный свертывание	показатели здоровья и измерения
Жировая масса тела body-fat body_fat	Образец	список, получить, согласовать, свернуть, ежедневный свертывание, создать, обновить, пакетное удаление	показатели здоровья и измерения
Калории в зоне частоты сердечных сокращений calories-in-heart-rate-zone calories_in_heart_rate_zone	Интервал	rollup, dailyRollup	активность_и_фитнес
Температура тела core-body-temperature core_body_temperature	Образец	список, получить, согласовать, свернуть, ежедневный свертывание	показатели здоровья и измерения
Суточная вариабельность сердечного ритма daily-heart-rate-variability daily_heart_rate_variability	Ежедневно	список, согласовать	показатели здоровья и измерения
Ежедневные зоны частоты сердечных сокращений daily-heart-rate-zones daily_heart_rate_zones	Ежедневно	список, согласовать	показатели здоровья и измерения
Суточная сатурация кислорода daily-oxygen-saturation daily_oxygen_saturation	Ежедневно	список, согласовать	показатели здоровья и измерения
Суточная частота дыхания daily-respiratory-rate daily_respiratory_rate	Ежедневно	список, согласовать	показатели здоровья и измерения
Ежедневная частота сердечных сокращений в состоянии покоя daily-resting-heart-rate daily_resting_heart_rate	Ежедневно	список, согласовать	показатели здоровья и измерения
Ежедневные измерения температуры во время сна daily-sleep-temperature-derivations daily_sleep_temperature_derivations	Ежедневно	список, согласовать	показатели здоровья и измерения
Ежедневный VO2 Max daily-vo2-max daily_vo2_max	Ежедневно	список, согласовать	активность_и_фитнес
Расстояние distance distance	Интервал	список, сверка, свертка, ежедневная сводка	активность_и_фитнес
Электрокардиограмма (ЭКГ) electrocardiogram electrocardiogram	Сессия	список	ЭКГ
Упражнение exercise exercise	Сессия	список, получить, согласовать, создать, обновить, пакетное удаление	активность_и_фитнес
Полы floors floors	Интервал	reconcile, rollup, dailyRollup	активность_и_фитнес
Еда food food	Еда	список, получить	питание
Измерительный прибор для пищевых продуктов food-measurement-unit food_measurement_unit	Еда	список, получить	питание
Частота сердечных сокращений heart-rate heart_rate	Образец	список, сверка, свертка, ежедневная сводка	показатели здоровья и измерения
Вариабельность сердечного ритма heart-rate-variability heart_rate_variability	Образец	список, согласовать	показатели здоровья и измерения
Высота height height	Образец	список, получить, согласовать, создать, обновить, пакетное удаление	показатели здоровья и измерения
Журнал учета потребления жидкости hydration-log hydration_log	Сессия	список, получить, согласовать, свернуть, ежедневный свертывание, создать, обновить, пакетное удаление	питание
Уведомление о нарушении ритма irregular-rhythm-notification irregular_rhythm_notification	Сессия	список	ирн
Журнал учета пищевых продуктов nutrition-log nutrition_log	Образец	список, получить, согласовать, свернуть, ежедневный свертывание, создать, обновить, пакетное удаление	питание
Насыщение кислородом oxygen-saturation oxygen_saturation	Образец	список, согласовать	показатели здоровья и измерения
Сводка по частоте дыхания во сне respiratory-rate-sleep-summary respiratory_rate_sleep_summary	Образец	список, согласовать	показатели здоровья и измерения
Бег VO2 Max run-vo2-max run_vo2_max	Образец	список, сверка, свертка, ежедневная сводка	активность_и_фитнес
Сидячий период sedentary-period sedentary_period	Интервал	список, сверка, свертка, ежедневная сводка	активность_и_фитнес
Спать sleep sleep	Сессия	список, получить, согласовать, создать, обновить, пакетное удаление	спать
Шаги steps steps	Интервал	список, сверка, свертка, ежедневная сводка	активность_и_фитнес
Данные о длине заплывов swim-lengths-data swim_lengths_data	Интервал	список, сверка, свертка, ежедневная сводка	активность_и_фитнес
Время в зоне частоты сердечных сокращений time-in-heart-rate-zone time_in_heart_rate_zone	Интервал	список, сверка, свертка, ежедневная сводка	активность_и_фитнес
Общее количество калорий total-calories total_calories	Интервал	rollup, dailyRollup	активность_и_фитнес
VO2 Max vo2-max vo2_max	Образец	список, согласовать	активность_и_фитнес
Масса weight weight	Образец	список, получить, согласовать, свернуть, ежедневный свертывание, создать, обновить, пакетное удаление	показатели здоровья и измерения

Доступность данных

Обновление данных пользователя доступно только после синхронизации трекера активности или ручного ввода новых данных в мобильное или веб-приложение Fitbit. Устройство Fitbit и мобильное приложение Fitbit могут автоматически синхронизироваться каждые 15 минут, когда приложение Fitbit открыто на мобильном устройстве, и оба устройства имеют активное соединение для передачи данных и находятся в зоне действия Bluetooth. Если пользователь отслеживает активность с помощью MobileTrack, MobileTrack синхронизируется каждый час, пока приложение открыто.

Доступ третьих лиц

Устройства Fitbit не могут напрямую взаимодействовать со сторонними приложениями или сервисами. Эти устройства предназначены для связи и синхронизации исключительно с мобильным приложением Fitbit.

Устройство автоматически синхронизирует данные в течение дня, когда открыто приложение Fitbit, или каждые 15 минут, если Bluetooth активен и приложение работает в фоновом режиме. После завершения процесса синхронизации данные становятся доступны сторонним сервисам через API Google Health.

стандарты расстояния

Дистанция, измеряемая во время упражнений, например, elevationGainMillimeters в миллиметрах, стандартной единицей измерения является миллиметр по следующим причинам:

1. Сохранение точности данных : Главная причина использования миллиметров — это обеспечение точности считываемых и предоставляемых данных. Использование такой точной единицы, как миллиметры, позволяет представлять измерения с высокой точностью.
2. Стандартизация : Миллиметры — это стандартизированная единица измерения, используемая во всех наших сервисах. Такая согласованность помогает обеспечить единообразие взаимодействия разработчиков с различными частями API.
3. Широкая поддержка систем измерения : использование базовой единицы, такой как миллиметры, упрощает разработчикам преобразование в любую другую выбранную единицу, независимо от того, работают ли они с метрической, имперской или другими системами измерения.

Переменная продолжительность светового дня

API Health обрабатывает время, отдавая приоритет времени пользователя, чтобы учесть переменную продолжительность дня, вызванную переходом на летнее время или поездками. Каждая точка данных хранится как с физической меткой времени UTC, так и с активным смещением UTC на момент события. Это позволяет системе:

• Сопоставьте событие с точным физическим моментом времени.
• Для агрегирования данных необходимо скорректировать время в соответствии с локальным контекстом пользователя.

Переход на летнее время

При переходе на летнее время происходит «перевод назад», в результате чего гражданские сутки становятся 25-часовыми, и сводная таблица за эту дату будет содержать 25 часов данных. При переводе назад, в результате, гражданские сутки становятся 23-часовыми, и время возвращается к стандартному времени.

Путешествовать

Перемещение через часовые пояса может привести к еще более значительным колебаниям физической продолжительности одного и того же гражданского дня.

Используйте конечную точку dailyRollUp для согласования разницы во времени. Она автоматически привязывает данные к календарному дню, в который они были записаны, в соответствии с местным временем пользователя, эффективно «сшивая» данные за день, несмотря на сдвиги во времени.