Integració Garmin

vitalera és l'únic partner de Garmin Health enfocat exclusivament en dades de salut i rendiment esportiu. Combinem l'API oficial de Garmin Health i el SDK de Garmin Connect Mobile per oferir dades en brut, completes i en temps real — sense les llacunes dels agregadors genèrics.

Per què Garmin amb vitalera

Els equips que depenen de Health Connect o d'agregadors genèrics de wearables per obtenir dades de Garmin sovint es troben amb les mateixes limitacions:

Les mètriques de distància i GPS es redondeigen o submostregen, de manera que l'activitat que veieu a la vostra plataforma no coincideix amb el que l'atleta va enregistrar realment al seu rellotge.
Els entrenaments arriben incomplets — falten voltes, hi ha buits en la traça de freqüència cardíaca o es perd l'estructura dels intervals.
Les mètriques avançades simplement no s'exposen: cadència, zones de freqüència cardíaca, SpO2, potència de cursa, càrrega d'entrenament, estrès, Body Battery i altres fonts de dades natives de Garmin queden fora de l'abast.
Sense streaming en viu durant una activitat — només rebeu la sessió un cop s'ha acabat i sincronitzat.
Latència de sincronització de diversos minuts a hores, cosa que fa impossibles les alertes clíniques en temps real o la monitorització en cursa.

vitalera es connecta directament a la Garmin Health API (servidor a servidor) i al Garmin Connect Mobile SDK (al dispositiu), proporcionant-vos la mateixa fidelitat de dades que Garmin utilitza internament.

API vs SDK vs Health Connect

Recomanat: Garmin Health API a través de vitalera — la forma més ràpida i escalable de connectar dispositius Garmin per al 99% dels casos d'ús (plataformes esportives, RPM, coaching, recerca). El SDK només és necessari per a streaming en viu amb latència inferior al segon.

Capacitat	Health Connect	Garmin Health API (via vitalera)	Garmin SDK (via vitalera)
Recomanat per a	—	Opció per defecte	Només broadcast / TV en viu
Completesa de l'entrenament	Parcial, llacunes freqüents	Sessió completa + voltes	Sessió completa + voltes
Precisió de distància	Arrodonida / aproximada	En brut, precisió de 2 decimals	En brut, precisió de 2 decimals
Zones de freqüència cardíaca	No	Sí	Sí
Cadència i potència de cursa	No	Sí	Sí
SpO2	No	Diari + sota demanda	Streaming continu
Fases del son	Limitat	Complet (lleuger / profund / REM)	Complet
Retroalimentació històrica	Dies	Fins a 90 dies	Només en viu
UX de vinculació d'usuari	Manual per dispositiu	OAuth d'una sola vegada	Requereix instal·lació d'app
Temps d'integració	Setmanes	~15 minuts	1-2 setmanes
Escala a grans bases d'usuaris	No	Sí, provat en producció	Basat en esdeveniments
Servidor a servidor (sense app necessària)	No	Sí	No (requereix SDK mòbil)
Streaming en temps real (sub-segon)	No	No	Sí

Quan triar cada opció

Garmin Health API (via vitalera) — 99% dels casos. Plataformes esportives, RPM, apps de coaching, recerca, assegurances, benestar corporatiu. Servidor a servidor, sense SDK mòbil necessari, dades històriques completes, OAuth d'una sola vegada, escala a grans bases d'usuaris.
Garmin SDK (via vitalera) — Només quan necessiteu streaming en viu amb latència sub-segon per a overlays de broadcast o alertes d'emergència durant un esdeveniment en viu. Requereix una app mòbil.
Health Connect — No recomanat per a cap cas d'ús clínic o esportiu de grau professional.

Com funciona la vinculació d'usuaris

L'usuari prem Connectar Garmin a la vostra app.
vitalera gestiona el flux OAuth i emmagatzema la vinculació amb el vostre user_id.
A partir d'aquest moment, cada entrenament, sessió de son i resum diari s'envia al vostre webhook i està disponible a través de l'API.

Sense vinculació per dispositiu. Sense sincronització manual. Sense "si us plau obriu l'app Garmin Connect primer."

Exemple: resposta d'un entrenament de cursa

{
  "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_meters és 10 043,22 — en brut des del rellotge, no un valor arrodonit ni submostrejat.

Streaming en temps real per a esdeveniments en viu

vitalera impulsa la telemetria en viu darrere de plataformes d'esdeveniments esportius, transmetent la freqüència cardíaca i SpO2 dels corredors des de rellotges Garmin als feeds de broadcast en menys d'un segon.

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);
  },
});

Provat en producció a escala en desplegaments d'un sol esdeveniment amb grans grups d'atletes simultanis.

Son i benestar diari

A més dels entrenaments, la mateixa integració proporciona:

Sessions de son amb fases (lleuger, profund, REM, despert)
Freqüència cardíaca en repòs i HRV (RMSSD)
Resums diaris — passos, calories, puntuació d'estrès, Body Battery
Pulse Ox mitjanes nocturnes

Tot normalitzat a recursos FHIR R5 Observation — consulteu Recursos FHIR.

Casos d'ús

Segment	Exemple
Plataformes d'esdeveniments esportius	Sincronitzeu atletes, corredors, triatletes o ciclistes a escala. Classificacions en viu, analítiques post-cursa, overlays de broadcast.
Entrenament i coaching connectat	Dades d'entrenament en brut alimenten plans d'entrenament personalitzats sense perdre fidelitat.
Cardiologia clínica i rehabilitació	El mateix pipeline, ja certificat per a RPM (CE Mark MDR, GDPR, ISO 27001).
Benestar corporatiu	Agregeu mètriques de salut Garmin per a programes de benestar d'empleats amb compartició de dades basada en consentiment.
Assegurances i risc	Dades contínues de freqüència cardíaca, son i activitat per a models de subscripció i incentius.
Recerca i assajos clínics	Recopilació longitudinal de dades de wearables amb exportació estàndard FHIR per a cohorts de recerca.

Comenceu en 15 minuts

Sol·liciteu credencials de sandbox a info@vitalera.io.
Rebeu la vostra API key i usuaris de prova ja vinculats a comptes sandbox de Garmin.
Crideu GET /v2/activities?user_id=demo_runner_01 i inspeccioneu el JSON anterior amb dades reals.
Subscriviu-vos al webhook activity.created.
Passeu a producció.

No es requereix NDA per explorar el sandbox. El NDA només s'activa quan accediu a dades de producció de Garmin (requisit de Garmin Health Partner).

Compliment normatiu i propietat de dades


Certificacions	CE Mark MDR, ISO 27001, ISO 13485
Privacitat	Conforme amb GDPR, preparat per a HIPAA, ENS Alto
Residència de dades	UE per defecte (AWS eu-west-1). Regió dels EUA disponible.
Propietat de dades	Vós sou propietari de les dades dels vostres usuaris. vitalera és el processador, mai el controlador.

Propers passos

Dispositius compatibles — Llista completa de compatibilitat de dispositius
Webhooks — Subscripcions a esdeveniments i format de payloads
Recursos FHIR — Model de dades Observation
Contacteu amb vendes per a una demo en viu

Per què Garmin amb vitalera​

API vs SDK vs Health Connect​

Quan triar cada opció​

Com funciona la vinculació d'usuaris​

Exemple: resposta d'un entrenament de cursa​

Streaming en temps real per a esdeveniments en viu​

Son i benestar diari​

Casos d'ús​

Comenceu en 15 minuts​

Compliment normatiu i propietat de dades​

Propers passos​