Руководство по миграции Fit

API Google Fit устарели и планируется прекратить их поддержку в конце 2026 года. Google предлагает ряд продуктов и услуг в сфере здоровья и благополучия, которые помогут вашим пользователям продолжать достигать своих целей после прекращения поддержки этих сервисов.

Внимание: поддержка API Google Fit (включая REST API) будет осуществляться только до конца 2026 года. Мы рекомендуем перейти на API Google Health для облачных интеграций или на Health Connect для отслеживания шагов и создания мобильных приложений.

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

Выбор API должен основываться на типе вашего приложения и конкретных потребностях в данных.

По типу приложения

Тип приложения Рекомендуемый путь Основная причина
Приложение для отслеживания шагов Health Connect Ориентированное на мобильные устройства чтение агрегированных данных о количестве шагов из различных источников.
Приложение-компаньон для фитнес-трекеров API Google Health Веб-ориентированная платформа, требующая аутентификации OAuth для интеграции с пользователями.
Платформа для здоровья и фитнеса API Google Health и Health Connect Используйте API Google Health для получения данных с устройств Fitbit/Google и Health Connect для получения агрегированных данных с устройства.

В рамках текущей интеграции

Текущая интеграция Рекомендуемый путь Доступность
Google Fit (Android и REST API) API Google Health Доступный
Чтение данных о шагах с мобильного устройства (с помощью API записи Google Fit) Health Connect Доступный
Fit API на Wear OS Медицинские услуги Доступный
Веб-API Fitbit API Google Health Доступный
API для записи видео на мобильных устройствах Health Connect Доступный
Health Connect Сохраните существующую интеграцию или добавьте API Google Health. Доступный

Технические сравнения

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

API Fit против API Google Health

Используйте этот путь, если ваше приложение представляет собой веб-платформу или требует взаимодействия между серверами (S2S).

Особенность Fit API (Android/REST) API Google Health
Настройка проекта Консоль Google Cloud Создать проект в Google Cloud
Настройка OAuth Тип приложения: Android или веб-приложение Тип веб-приложения
Архитектура данных com.google префиксные типы Унифицированные типы данных Google Health API
Регистрация приложения Создать проект в Google Cloud Создайте проект Google Cloud и включите API Google Health.

Fit API против Health Connect

Используйте этот путь для мобильных Android-приложений, считывающих локальные метрики устройства.

Особенность Fit API для Android Health Connect
Регистрация Консоль Google Cloud Объявление о проекте Play Store и приложениях для здоровья
Аутентификация Требуется OAuth 2.0 OAuth не требуется (требуются права доступа на устройстве).
хранение данных облачно-ориентированный Ориентированный на устройство (на устройстве)
Аудитория Разработчики устаревших версий Android Современные разработчики мобильных приложений для Android
Разрешения Области действия OAuth Разрешения манифеста Android

Интеграция API Fit

В следующих разделах приведены рекомендации по миграции с каждого из API Google Fit. Если ваша интеграция также включает элементы пользовательского интерфейса, которые подключаются к приложению Google Fit, см. рекомендации по интеграции приложений Fit для получения дополнительной информации.

Приложения, использующие API Fit Recording для записи шагов.

API Fit Recording позволяет вашему приложению запрашивать автоматическое сохранение данных с датчиков с минимальным расходом заряда батареи, создавая подписки. Каждая подписка связывает приложение Android с определенным типом данных о физической активности или источником данных, и тип данных Step обычно используется для записи шагов.

Для перехода с API записи фитнес-тренировок выполните следующие шаги:

Таблица 1: Этапы миграции из API записи фитнес-тренировок
Телефон Носить
  1. Чтобы отобразить общее количество шагов, добавьте Health Connect в свое приложение . В общее количество входят шаги, сделанные с мобильного устройства (Android 14 или выше), а также шаги, сделанные с других приложений и устройств.
  2. Чтобы и дальше отображать данные о количестве шагов в вашем приложении, реализуйте запись данных с помощью API записи Health Connect .

Воспользуйтесь услугами здравоохранения:

  • ПассивныйМониторКлиент
  • ExerciseClient

Более подробную информацию о различиях между ними можно найти в документации Службы здравоохранения .

Приложения, использующие History API для чтения или записи данных в фитнес-магазин.

API истории позволяет вашему приложению выполнять массовые операции с магазином фитнес-данных. Эти операции включают чтение, вставку, обновление и удаление исторических данных о здоровье и самочувствии.

Для перехода с API истории выполните следующие действия:

Таблица 2: Этапы миграции из API истории подбора параметров.
Телефон Носить

Переход на API Google Health .

Не применимо. Используйте Health Connect из мобильного приложения, а не с носимого устройства.

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

API датчиков позволяет считывать необработанные данные с датчиков в вашем приложении в режиме реального времени. API датчиков выполняет следующие действия:

  • Отображает список источников данных, доступных на самом устройстве и на сопутствующих устройствах.
  • Регистрирует слушателей для получения необработанных данных с датчиков.
  • Отменяет регистрацию слушателей, чтобы они больше не получали необработанные данные с датчиков.

Для перехода с Sensor API выполните следующие действия:

Таблица 3: Этапы миграции из API датчика положения.
Телефон Носить

Используйте датчики и API поставщика объединенных данных о местоположении.

Использование медицинских сервисов на Wear OS:

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    Или используйте SensorManager или FusedLocationProvider

Приложения, использующие API сессий для предоставления сводных данных об активности.

Сеансы представляют собой временной интервал, в течение которого пользователи выполняют фитнес-упражнение.

API сессий позволяет вашему приложению создавать сессии в фитнес-магазине.

Для перехода с Session API выполните следующие действия:

Таблица 4: Этапы миграции из API Fit Session.
Телефон Носить

Запуск/остановка: Не применимо. Приложение должно отслеживать состояние текущих сессий внутри себя.

Чтение/запись: Переход к API Google Health .

Начало/остановка: Использование медицинских услуг (ExerciseClient)

Чтение/запись: Используйте Health Connect с вашим мобильным приложением.

Для конкретных рабочих процессов мы рекомендуем следующее:

  • Вставка сессии: Разработчикам следует использовать Health Connect со своим мобильным приложением и вставлять либо ExerciseSessionRecord , либо SleepSessionRecord соответственно.

Приложения, использующие API целей

Цели — это задачи в приложении Google Fit, которые пользователи могут устанавливать для своих показателей, таких как количество шагов и баллы сердечного ритма. Платформа Fit записывает их цели и отслеживает ежедневную активность в соответствии с ними, используя API целей .

Таблица 5: Руководство по миграции для API Fit Goals
Телефон Носить
Заменяющего API нет. Заменяющего API нет.

Приложения, использующие API BLE

Ваше приложение может находить доступные устройства Bluetooth Low Energy (BLE) и передавать данные с датчиков на платформу Google Fit, используя API BLE .

Для перехода с BLE API выполните следующие шаги:

Таблица 6: Этапы миграции из API Fit BLE
Телефон Носить
Используйте API Bluetooth Android напрямую. Используйте API Bluetooth Android напрямую.

Устаревшие функции

Для следующих функций нет прямой замены в API. Используйте рекомендуемые стандартные API Android:

  • API датчиков : используйте фреймворк Android Sensors или API Fused Location Provider для получения необработанных данных в реальном времени.
  • API для управления целями : Заменяющего API нет. Управляйте отслеживанием целей и целевыми показателями ежедневной активности непосредственно в логике вашего приложения.
  • API Bluetooth Low Energy (BLE) : Используйте API Bluetooth Android напрямую для связи с оборудованием.

Интеграция с приложением Fit

Если ваше приложение подключается к Google Fit для обмена данными, следуйте инструкциям по миграции существующих и новых пользователей в Health Connect или Google Health API, приведенным в этих разделах:

Существующие пользователи вашего приложения

Если пользовательский интерфейс вашего приложения включает возможность подключения к Google Fit (или если ваше приложение включено в список приложений, совместимых с Google Fit ), вы можете продолжать поддерживать интеграцию с приложением Fit для текущих пользователей.

Мы будем регулярно обновлять этот раздел информацией о том, когда следует прекратить поддержку интеграции с вашим приложением Fit, и какие существуют наилучшие варианты для сохранения удобства использования. А пока вы можете связаться с нами .

Таблица 7: Рекомендации для существующих пользователей, использующих интеграцию с приложением Fit.
проверьте. Сделайте это. Не делайте этого .
Предложите Health Connect или Google Health API в качестве новой опции в вашем приложении.

Сосредоточьтесь на преимуществах для пользователей, таких как более полные данные и аналитические выводы, конфиденциальность и безопасность.

Синхронизация с Health Connect

Попросите пользователей отключиться от Google Fit.

Отключитесь от Health Connect

Новые пользователи вашего приложения

Чтобы предложить аналогичный опыт новым пользователям вашего приложения, мы рекомендуем создать интеграцию с Health Connect или Google Health API .

Health Connect предоставляет доступ к новым источникам и типам данных, обеспечивая пользователям более широкий функционал, при этом данные надежно хранятся на устройстве. API Google Health предоставляет веб-ориентированную платформу для данных с устройств Fitbit и Google.

Таблица 8: Рекомендации для новых пользователей по интеграции с приложением Fit.
проверьте. Сделайте это. Не делайте этого .
Включите Health Connect или Google Health API в процесс настройки вашего приложения. Предложите Fit в качестве приложения, к которому пользователи смогут подключиться после того, как станет доступно приложение Health Connect.