Guida alla migrazione

Google offre molti prodotti e servizi sanitari, tra cui Connessione Salute. Le API Google Fit sono state ritirate e saranno supportate fino al 30 giugno 2025, data in cui verranno disattivate. Le seguenti linee guida indicano a quale API o piattaforma eseguire la migrazione da ogni API Google Fit per Android.

Migrazione dall'API Fit Android all'API Health Connect

Esistono 3 passaggi chiave per eseguire la migrazione all'API Health Connect.

Passaggio 1: integrazione

Il primo passaggio per l'integrazione consiste nell'aggiungere Connessione Salute alla tua app, tra cui:

  • Esegui l'integrazione con Connessione Salute seguendo questi passaggi iniziali.
  • Dichiara i tipi di dati e la modalità di accesso richiesti nel file manifest dell'app.
  • Ottieni l'autorizzazione dell'utente per accedere a Connessione Salute.
  • Leggere/scrivere dati in base ai tuoi flussi di lavoro o casi d'uso specifici.

Passaggio 2: esegui la migrazione

Ti consigliamo di mantenere attive le integrazioni dell'API Google Fit per Android e dell'API Health Connect mentre gli utenti eseguono la migrazione da una piattaforma all'altra. Abbiamo ritirato l'API Google Fit per Android, ma puntiamo a disattivarla non prima del 30 giugno 2025. In questo modo, gli utenti avranno tempo a sufficienza per passare a Connessione Salute e continuare a usufruire del servizio.

Passaggio 3: esegui la pulizia

Per rimuovere l'SDK Google Fit:

  1. Rimuovi il codice associato all'API Google Fit per Android.
  2. Rimuovi le dipendenze di Google Play Services.

API Sensor

L'API Sensor ti consente di leggere i dati non elaborati dei sensori nella tua app in tempo reale. L'API Sensor effettua le seguenti operazioni:

  • Elenca le origini dati disponibili sul dispositivo e sui dispositivi associati.
  • Registra i listener per ricevere dati non elaborati dei sensori.
  • Consente di annullare la registrazione dei listener in modo che non ricevano più dati non elaborati dei sensori.

Esegui la migrazione dall'API Sensor alle seguenti API o piattaforme:

Telefono Indossa

Utilizzo di SensorManager, FusedLocationProvider

Utilizzare i servizi sanitari

  • Client di monitoraggio passivo
  • MeasureClient
  • Client Exercise

    In alternativa, utilizza SensorManager, FusedLocationProvider

API Session

Le sessioni rappresentano un intervallo di tempo durante il quale gli utenti eseguono un'attività fisica.

L'API Session consente alla tua app di creare sessioni nel fitness store.

Esegui la migrazione alle seguenti API o piattaforme dall'API Session:

Telefono Indossa

Inizio/arresto: non applicabile. L'applicazione deve monitorare internamente lo stato delle sessioni in corso.

Lettura/scrittura: utilizza Connessione Salute.

Inizio/interruzione: utilizza Health Services (ExerciseClient)

Lettura/scrittura: usa Connessione Salute tramite l'app mobile.

Per flussi di lavoro specifici, consigliamo quanto segue:

  • Inserimento di una sessione: gli sviluppatori devono utilizzare Connessione Salute e inserire un record ActivitySession o un record SleepSession di conseguenza.

    • API Recording

    L'API Recording consente alla tua app di richiedere l'archiviazione automatica dei dati dei sensori in modo efficiente dal punto di vista della batteria creando abbonamenti. Un abbonamento è associato a un'app per Android ed è costituito da un tipo di dati sull'attività fisica o da un'origine dati specifica.

    Esegui la migrazione dall'API Recording alle seguenti API o piattaforme:

    Telefono Indossa

    Per eseguire la migrazione dall'API Recording, segui questi passaggi:

    1. Implementare l'acquisizione dei dati utilizzando SensorManager.
    2. Scrivi i dati acquisiti in Connessione Salute.
    3. Se necessario, combina i passaggi a e b in un servizio in primo piano, ad esempio quando devi continuare a registrare dati senza interagire con l'app stessa.

    Utilizzare i servizi sanitari

    • Client di monitoraggio passivo
    • Client Exercise

      Per ulteriori informazioni sulle differenze tra PassiveMonitoringClient e ExerciseClient, consulta la documentazione di Health Services.

    API History

    L'API History consente alla tua app di eseguire operazioni collettive sullo store per l'attività fisica, tra cui lettura, inserimento, aggiornamento ed eliminazione dei dati storici su salute e benessere.

    Esegui la migrazione dall'API History alle seguenti API o piattaforme:

    Telefono Indossa

    Usa Connessione Salute

    Usa Connessione Salute dall'app mobile, non dal dispositivo indossabile.

    API Goals

    Gli obiettivi sono target nell'app Google Fit che gli utenti possono impostare da soli. Aiutano a motivare gli utenti a rimanere attivi ogni giorno. Dal loro profilo, gli utenti possono regolare il numero di passi e punti cardio che vogliono raggiungere ogni giorno. La piattaforma Fit registra gli obiettivi e monitora l'attività giornaliera in base a questi obiettivi utilizzando l'API Goals.

    Telefono Indossa
    Nessuna API sostitutiva disponibile. Nessuna API sostitutiva disponibile.

    API BLE

    La tua app può trovare i dispositivi BLE (Bluetooth Low Energy) disponibili e inserire i dati dei sensori nella piattaforma Google Fit utilizzando l'API BLE.

    Esegui la migrazione dall'API BLE alle seguenti API o piattaforme:

    Telefono Indossa
    Usa direttamente le API Android Bluetooth. Usa direttamente le API Android Bluetooth.