App Garmin Connect IQ: un caso di studio al posto di un'API chiusa.

È stata progettata una piattaforma di medicina preventiva e monitoraggio della salute personale per raccogliere dati dagli smartwatch degli ospiti. Lo sviluppatore ha scelto Garmin, leader mondiale con una gamma completa di certificazioni per l'Europa. Tuttavia, si è quasi subito imbattuto in un accesso limitato alla sua API, il canale attraverso il quale i servizi di terze parti in genere ottengono automaticamente i dati dal dispositivo.

Ogni settimana, il canale Telegram dell'autore pubblica nuovi casi e approcci allo sviluppo dell'intelligenza artificiale. Puoi iscriverti qui: t.me/promtvibeadd.

Perché Garmin è stata l'unica scelta possibile per questo progetto?

Il dispositivo doveva essere certificato in Europa per la raccolta di dati sanitari: questo ha ristretto immediatamente la scelta. Garmin è più conveniente dei suoi concorrenti sotto questo aspetto: possiede un pacchetto completo di certificazioni riconosciute nell'UE.

Secondo l'esperienza dello sviluppatore, i requisiti UE per i dati medici non riguardano solo la scelta del dispositivo, ma anche l'infrastruttura circostante: persino i servizi di hosting bloccano automaticamente le risorse se non vengono soddisfatti una serie di rigidi requisiti UE. Un'analisi della certificazione del software medicale in sé è oggetto di un post separato dell'autore; qui, è importante solo come motivo per cui Garmin è stata la scelta preferita.

Qual è stata la risposta di Garmin alla richiesta di accesso all'API?

Uno sviluppatore ha inviato una richiesta a Garmin Connect Developer, sperando di acquistare l'accesso alle API e utilizzarlo per creare visualizzazioni di metriche. La risposta è arrivata rapidamente, ma non come previsto: Garmin ha dichiarato che la revisione e l'approvazione delle nuove richieste di accesso alle API erano temporaneamente sospese.

Successivamente, è subentrata una ricerca di routine nei forum specializzati. Secondo lo sviluppatore, l'accesso non sarebbe stato probabilmente disponibile prima dell'estate del 2027. Per un progetto già in fase di sviluppo, ciò significava un vero e proprio vicolo cieco, a meno che non si trovasse un'altra soluzione.

Perché non sei passato da Garmin a un marchio con un'API aperta?

Lo sviluppatore stesso ha proposto al cliente un approccio logico: dato che l'API di Garmin è chiusa, avrebbero dovuto utilizzare un dispositivo di un altro produttore con accesso aperto. Il cliente ha rifiutato, senza specificarne il motivo preciso.

Molto probabilmente, il problema deriva dalla stessa certificazione. Cambiare marca risolverebbe il problema dell'API, ma creerebbe un nuovo compito più difficile: riconvalidare la conformità del dispositivo ai requisiti europei per i dati medici che inizialmente avevano portato alla scelta di Garmin. Rimanere con Garmin e trovare una soluzione alternativa sembrava più economico che cambiare il dispositivo e ottenere una nuova certificazione.

Come utilizzare Garmin Connect IQ in modo alternativo

Anziché ricorrere all'integrazione tramite API, la soluzione è stata individuata nell'ecosistema Garmin Connect IQ, un archivio di mini-app che si installano direttamente sull'orologio e funzionano secondo le regole definite da Garmin stessa. Un'app di questo tipo può essere pubblicata senza accesso alle API: risiede sul dispositivo e comunica direttamente con il server tramite il proprio codice.

Quando la procedura ufficiale è chiusa e aspettare fino al 2027 non è un'opzione, le persone cercano questo tipo di soluzione alternativa, che eviti mesi di attesa per la decisione del fornitore sulla loro richiesta. Una logica simile è alla base di 1001site AI: il suo agente di intelligenza artificiale crea un sito web o un negozio online basato sul tuo link o sulla tua descrizione in pochi minuti.

Quali sono le funzioni delle due app approvate da Garmin?

Il team ha sviluppato due app separate per l'ecosistema Connect IQ, entrambe approvate da Garmin: un quadrante personalizzato con metriche chiave e il logo dell'hotel cliente, e un'app per la sincronizzazione e la condivisione dei dati con la piattaforma. Secondo il Garmin Connect IQ Store, si chiamano Longevity President Face e Longevity President e sono state sviluppate da Longevity.

Il quadrante dell'orologio è progettato per un utente specifico: lo schermo visualizza l'intervallo di frequenza cardiaca, il prossimo trattamento programmato e lo stato della batteria, personalizzati per la giornata in corso. Di seguito è riportata la pagina della documentazione dell'app: le schermate non sono foto dell'orologio, ma sono disegnate a partire dal codice del quadrante, in modo da mostrare al designer e al cliente ogni stato senza doverlo monitorare su un dispositivo reale.

La seconda app, Longevity President, si occupa della sincronizzazione: durante l'attività dell'utente (ad esempio, una passeggiata lungo un percorso), trasmette i dati dall'orologio al portale, dove è visibile anche una mappa con il percorso effettuato.

Come si presenta nell'uso reale

Al polso dell'ospite, il quadrante dell'orologio visualizza le stesse informazioni della documentazione precedente, ma in condizioni reali: ora, frequenza cardiaca, passi, durata della batteria e un promemoria per il prossimo trattamento, con l'indicazione dell'intervallo di frequenza cardiaca richiesto. I dati provenienti dal dispositivo certificato vengono infine trasmessi alla persona che lo indossa al polso.

Qual è stato il risultato finale del progetto e quali sono i prossimi passi?

Entrambe le app sono state moderate e pubblicate nel Garmin Connect IQ Store, un canale dati funzionante e pronto all'uso. Lo sviluppatore definisce questo un esempio pratico di integrazione dei dispositivi indossabili in un ecosistema chiuso: le regole del gioco sono stabilite dal fornitore e la soluzione deve essere sviluppata all'interno di tale contesto.

I prossimi passi in programma includono lo sviluppo di un portale medico e la collaborazione con le cliniche benessere degli hotel, ampliando i loro servizi attraverso il monitoraggio della salute degli ospiti e la selezione automatica dei trattamenti. Il marchio Longevity, presente nella dashboard della piattaforma negli screenshot qui sopra, è già utilizzato sul portale turistico del resort di Karlovy Vary per il President Hotel. Lì, il widget Longevity e l'integrazione con Garmin Connect IQ vengono presentati agli ospiti come due servizi separati, insieme a informazioni su eventi e meteo. Per un caso di studio su come l'intelligenza artificiale, basata sui dati degli orologi Garmin, seleziona automaticamente i trattamenti spa per gli ospiti, consultare il caso di studio Longevity AI per hotel e resort con spa.

Nel post stesso, l'autore ha lasciato la domanda aperta, chiedendo ai lettori quali altri dispositivi o sensori vorrebbero integrare con i servizi di monitoraggio della salute. L'elenco dei dispositivi supportati è attualmente limitato dai requisiti di certificazione, non dalle capacità tecniche.

Per chi è adatta questa soluzione alternativa?

Sviluppare una mini-app nell'ecosistema chiuso di un dispositivo non è sempre fattibile. Ha senso se:

1. L'API ufficiale del fornitore è chiusa a nuove richieste o è temporaneamente non disponibile a causa di vincoli di tempo;
2. È impossibile sostituire il dispositivo a causa di un requisito esterno, come una certificazione, un contratto o la dotazione di dispositivi già distribuiti agli utenti;
3. L'ecosistema dei dispositivi (come Garmin Connect IQ) generalmente consente l'utilizzo di widget di terze parti e li pubblica senza accesso a un'API proprietaria.

Se nessuna di queste condizioni viene soddisfatta, un'API aperta o la scelta di un dispositivo gratuito risultano quasi sempre più veloci ed economiche rispetto allo sviluppo e alla moderazione di un'app nell'ecosistema di qualcun altro.

Domande e risposte

Perché non potevano semplicemente accedere all'API ufficiale di Garmin? L'accesso è attualmente bloccato per nuove richieste. Una richiesta inviata al team di sviluppo di Garmin Connect ha ricevuto una risposta in cui si affermava che la revisione e l'approvazione delle nuove richieste di accesso all'API sono temporaneamente sospese. Secondo i forum di Garmin, lo sviluppatore stima che l'accesso non sarà probabilmente disponibile prima dell'estate del 2027.

Perché non siete passati da Garmin a dispositivi con un'API aperta? Lo sviluppatore ha proposto questa opzione al cliente, ma è stata rifiutata. Per una piattaforma di medicina preventiva, il dispositivo deve essere certificato in Europa e Garmin fornisce un pacchetto completo di documenti di certificazione. Rinunciare a questa certificazione a favore di un'API aperta avrebbe significato dover risolvere da zero un problema diverso e più complesso.

Cosa fanno le due app approvate da Garmin? La prima è un quadrante personalizzato, Longevity President Face, che visualizza i parametri chiave e il logo dell'hotel. La seconda è l'app di sincronizzazione Longevity President, che trasferisce i dati dall'orologio alla piattaforma. Entrambe sono confermate come app autonome nel Garmin Connect IQ Store, sviluppato da Longevity.

Questa soluzione alternativa è adatta a ogni progetto di dispositivi indossabili? No. È appropriata quando l'API ufficiale è chiusa o temporaneamente non disponibile e la sostituzione del dispositivo è impossibile a causa di un requisito esterno, come la certificazione in questo caso. Se l'API è aperta o la scelta dei dispositivi è illimitata, l'integrazione tramite API è quasi sempre più rapida.

Fonti

• Post dell'autore sul canale Telegram "Business with AI | Through the Keyhole": https://t.me/promtvibeadd/441
• App Longevity President Face sul Garmin Connect IQ Store: https://apps.garmin.com/apps/522f23dc-b19f-4c47-8504-5da8f3ffb96a
• Sincronizza Longevity President nello stesso negozio Garmin: https://apps.garmin.com/apps/2874ad71-527c-4aac-9af7-6929c10a927c

Lo stesso principio vale anche per i siti web. 1001site AI, un agente basato sull'intelligenza artificiale, crea un sito web o un negozio online in pochi minuti, partendo dal tuo link o dalla tua descrizione.