Integrazione Garmin
vitalera e l'unico partner Garmin Health dedicato esclusivamente ai dati sanitari e sportivi. Combiniamo l'API ufficiale Garmin Health e il SDK Garmin Connect Mobile per fornire dati grezzi, completi e in tempo reale -- senza le lacune degli aggregatori generici.
Perche Garmin con vitalera
I team che si affidano a Health Connect o ad aggregatori generici di wearable per ottenere dati Garmin incontrano di solito gli stessi limiti:
- Le metriche di distanza e GPS vengono arrotondate o sottocampionate, quindi l'attivita che vedete sulla vostra piattaforma non corrisponde a quanto l'atleta ha effettivamente registrato sul suo orologio.
- Gli allenamenti arrivano incompleti -- giri mancanti, lacune nella traccia della frequenza cardiaca o struttura degli intervalli rimossa.
- Le metriche avanzate semplicemente non vengono esposte: cadenza, zone di frequenza cardiaca, SpO2, potenza di corsa, carico di allenamento, stress, Body Battery e altre fonti di dati native di Garmin rimangono irraggiungibili.
- Nessuno streaming dal vivo durante un'attivita -- ricevete la sessione solo dopo che e terminata e sincronizzata.
- Latenza di sincronizzazione da diversi minuti a ore, che rende impossibili avvisi clinici in tempo reale o monitoraggio in gara.
vitalera si connette direttamente alla Garmin Health API (server-to-server) e al SDK Garmin Connect Mobile (sul dispositivo), offrendovi la stessa fedelta di dati che Garmin utilizza internamente.
API vs SDK vs Health Connect
Consigliato: Garmin Health API tramite vitalera -- il modo piu rapido e scalabile per connettere dispositivi Garmin per il 99% dei casi d'uso (piattaforme sportive, RPM, coaching, ricerca). L'SDK e necessario solo per lo streaming dal vivo sub-secondo.
| Funzionalita | Health Connect | Garmin Health API (tramite vitalera) | Garmin SDK (tramite vitalera) |
|---|---|---|---|
| Consigliato per | -- | Scelta predefinita | Solo diffusione / TV dal vivo |
| Completezza degli allenamenti | Parziale, lacune frequenti | Sessione completa + giri | Sessione completa + giri |
| Precisione della distanza | Arrotondata / approssimata | Grezza, precisione a 2 decimali | Grezza, precisione a 2 decimali |
| Zone di frequenza cardiaca | No | Si | Si |
| Cadenza e potenza di corsa | No | Si | Si |
| SpO2 | No | Giornaliera + su richiesta | Flusso continuo |
| Fasi del sonno | Limitato | Completo (leggero / profondo / REM) | Completo |
| Storico retrospettivo | Giorni | Fino a 90 giorni | Solo tempo reale |
| UX di abbinamento utente | Manuale per dispositivo | OAuth singolo | Richiede installazione app |
| Tempo di integrazione | Settimane | ~15 minuti | 1-2 settimane |
| Scala a grandi basi di utenti | No | Si, testato in produzione | Basato sugli eventi |
| Server-to-server (nessuna app richiesta) | No | Si | No (richiede SDK mobile) |
| Streaming in tempo reale (sub-secondo) | No | No | Si |
Quando scegliere cosa
- Garmin Health API (tramite vitalera) -- 99% dei casi. Piattaforme sportive, RPM, app di coaching, ricerca, assicurazioni, benessere aziendale. Server-to-server, nessun SDK mobile richiesto, dati storici completi, OAuth singolo, scala a grandi basi di utenti.
- Garmin SDK (tramite vitalera) -- Solo quando avete bisogno di streaming dal vivo sub-secondo per overlay di diffusione o allerte di emergenza durante un evento dal vivo. Richiede un'app mobile.
- Health Connect -- Non consigliato per casi d'uso clinici o sportivi.
Come funziona il collegamento utente
- L'utente tocca Connetti Garmin nella vostra app.
- vitalera gestisce il flusso OAuth e memorizza il collegamento con il vostro
user_id. - Da quel momento, ogni allenamento, sessione di sonno e riepilogo giornaliero viene inviato al vostro webhook e reso disponibile tramite l'API.
Nessun abbinamento per dispositivo. Nessuna sincronizzazione manuale. Nessun "aprite prima l'app Garmin Connect."
Esempio: risposta di un allenamento di corsa
{
"user_id": "athlete_8421",
"source": "garmin",
"activity_id": "gar_2026_04_10_0731",
"type": "running",
"start_time": "2026-04-10T07:31:04Z",
"duration_seconds": 3284,
"distance_meters": 10043.22,
"calories_kcal": 612,
"avg_heart_rate_bpm": 154,
"max_heart_rate_bpm": 181,
"hr_zones": {
"z1": 124,
"z2": 612,
"z3": 1890,
"z4": 540,
"z5": 118
},
"avg_cadence_spm": 172,
"avg_pace_sec_per_km": 327,
"elevation_gain_m": 84,
"laps": [
{ "lap": 1, "distance_m": 1000, "duration_s": 318, "avg_hr": 148 },
{ "lap": 2, "distance_m": 1000, "duration_s": 322, "avg_hr": 152 }
],
"device": { "model": "Garmin Forerunner 965", "firmware": "22.19" }
}
distance_meterse 10 043.22 -- grezzo dall'orologio, non un valore arrotondato o sottocampionato.
Streaming in tempo reale per eventi dal vivo
vitalera alimenta la telemetria dal vivo dietro alle piattaforme di eventi sportivi, trasmettendo la frequenza cardiaca e la SpO2 dei corridori dagli orologi Garmin ai flussi di broadcast in meno di un secondo.
vitalera.stream.subscribe({
user_id: 'athlete_8421',
metrics: ['heart_rate', 'spo2', 'cadence', 'pace'],
onData: (sample) => {
// sample = { ts, hr: 162, spo2: 96, cadence: 174, pace: 315 }
broadcastOverlay.update(sample);
},
});
Testato in produzione su larga scala in singoli deployment di eventi con grandi gruppi di atleti simultanei.
Sonno e benessere quotidiano
Oltre agli allenamenti, la stessa integrazione fornisce:
- Sessioni di sonno con fasi (leggero, profondo, REM, veglia)
- Frequenza cardiaca a riposo e HRV (RMSSD)
- Riepiloghi giornalieri -- passi, calorie, punteggio stress, Body Battery
- Pulse Ox medie notturne
Il tutto normalizzato in risorse FHIR R5 Observation -- vedere Risorse FHIR.
Casi d'uso
| Segmento | Esempio |
|---|---|
| Piattaforme di eventi sportivi | Sincronizzate atleti, corridori, triatleti o ciclisti su larga scala. Classifiche dal vivo, analisi post-gara, overlay di diffusione. |
| Allenamento e coaching connesso | I dati grezzi degli allenamenti alimentano piani personalizzati senza perdita di fedelta. |
| Cardiologia clinica e riabilitazione | La stessa pipeline, gia certificata per RPM (marchio CE MDR, GDPR, ISO 27001). |
| Benessere aziendale | Aggregate le metriche sanitarie Garmin per i programmi di benessere dei dipendenti con condivisione dati basata sul consenso. |
| Assicurazioni e rischio | Dati continui di frequenza cardiaca, sonno e attivita per modelli di sottoscrizione e programmi incentivanti. |
| Ricerca e sperimentazioni cliniche | Raccolta longitudinale di dati da wearable con esportazione standard FHIR per coorti di ricerca. |
Iniziate in 15 minuti
- Richiedete le credenziali sandbox a info@vitalera.io.
- Ricevete la vostra chiave API e utenti di test gia collegati agli account sandbox Garmin.
- Chiamate
GET /v2/activities?user_id=demo_runner_01e ispezionate il JSON sopra con dati reali. - Abbonatevi al webhook
activity.created. - Passate in produzione.
Nessun NDA richiesto per esplorare il sandbox. Il NDA interviene solo quando accedete ai dati di produzione Garmin (requisito della partnership Garmin Health).
Conformita e proprieta dei dati
| Certificazioni | CE Mark MDR, ISO 27001, ISO 13485 |
| Privacy | Conforme GDPR, pronto HIPAA, ENS Alto |
| Residenza dei dati | UE per default (AWS eu-west-1). Regione US disponibile. |
| Proprieta dei dati | I dati dei vostri utenti sono vostri. vitalera e il responsabile del trattamento, mai il titolare. |
Passi successivi
- Dispositivi supportati -- Lista completa di compatibilita dei dispositivi
- Webhooks -- Sottoscrizioni agli eventi e formato dei payload
- Risorse FHIR -- Modello dati Observation
- Contattate le vendite per una demo dal vivo