Salt la continutul principal

Integrare Garmin

vitalera este singurul partener Garmin Health concentrat exclusiv pe date de sanatate si de grad sportiv. Combinam API-ul oficial Garmin Health si Garmin Connect Mobile SDK pentru a livra date brute, complete si in timp real -- fara lacunele agregatoarelor generice.

De ce Garmin cu vitalera​

Echipele care se bazeaza pe Health Connect sau pe agregatoare generice de wearable-uri pentru a extrage date Garmin se confrunta de obicei cu aceleasi limitari:

  • Metricile de distanta si GPS sunt rotunjite sau subesantionate, astfel incat activitatea pe care o vedeti in platforma dumneavoastra nu corespunde cu ceea ce atletul a inregistrat efectiv pe ceas.
  • Antrenamentele ajung incomplete -- ture lipsa, lacune in traseul frecventei cardiace sau structura intervalelor eliminata.
  • Metricile avansate pur si simplu nu sunt expuse: cadenta, zone de frecventa cardiaca, SpO2, putere de alergare, incarcare de antrenament, stres, Body Battery si alte surse native de date Garmin raman inaccesibile.
  • Fara streaming live in timpul unei activitati -- primiti sesiunea doar dupa ce s-a terminat si a fost sincronizata.
  • Latenta de sincronizare de la cateva minute la ore, ceea ce face imposibile alertele clinice in timp real sau monitorizarea in cursa.

vitalera se conecteaza direct la Garmin Health API (server la server) si la Garmin Connect Mobile SDK (pe dispozitiv), oferindu-va aceeasi fidelitate a datelor pe care Garmin o utilizeaza intern.

API vs SDK vs Health Connect​

Recomandat: Garmin Health API via vitalera -- cea mai rapida si scalabila modalitate de a conecta dispozitive Garmin pentru 99% din cazurile de utilizare (platforme sportive, RPM, coaching, cercetare). SDK-ul este necesar doar pentru streaming live sub o secunda.

CapacitateHealth ConnectGarmin Health API (via vitalera)Garmin SDK (via vitalera)
Recomandat pentru—Alegerea implicitaDoar broadcast / TV live
Completitudinea antrenamentuluiPartiala, lacune frecventeSesiune completa + tureSesiune completa + ture
Precizia distanteiRotunjita / aproximataBruta, precizie de 2 zecimaleBruta, precizie de 2 zecimale
Zone de frecventa cardiacaNuDaDa
Cadenta si putere de alergareNuDaDa
SpO2NuZilnic + la cerereStream continuu
Stadii de somnLimitatComplet (usor / profund / REM)Complet
Completare istoricaZilePana la 90 de zileDoar live
UX de asociereManual per dispozitivOAuth unicNecesita instalarea aplicatiei
Timp de integrareSaptamani~15 minute1-2 saptamani
Scala la baze mari de utilizatoriNuDa, testat in productieBazat pe evenimente
Server la server (fara aplicatie)NuDaNu (necesita SDK mobil)
Streaming in timp real (sub-secunda)NuNuDa

Cand sa alegeti ce​

  • Garmin Health API (via vitalera) -- 99% din cazuri. Platforme sportive, RPM, aplicatii de coaching, cercetare, asigurari, wellness corporativ. Server la server, fara SDK mobil necesar, date istorice complete, OAuth unic, scala la baze mari de utilizatori.
  • Garmin SDK (via vitalera) -- Doar cand aveti nevoie de streaming live sub o secunda pentru overlay-uri de broadcast sau alerte de urgenta in timpul unui eveniment live. Necesita o aplicatie mobila.
  • Health Connect -- Nu este recomandat pentru niciun caz de utilizare clinic sau de grad sportiv.

Cum functioneaza asocierea utilizatorilor​

  1. Utilizatorul apasa Connect Garmin in aplicatia dumneavoastra.
  2. vitalera gestioneaza fluxul OAuth si stocheaza asocierea cu user_id-ul dumneavoastra.
  3. Din acel moment, fiecare antrenament, sesiune de somn si rezumat zilnic este trimis la webhook-ul dumneavoastra si disponibil prin API.

Fara asociere per dispozitiv. Fara sincronizare manuala. Fara "va rugam deschideti mai intai aplicatia Garmin Connect."

Exemplu: raspunsul unui antrenament de alergare​

{
  "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 este 10 043.22 -- brut de pe ceas, nu o valoare rotunjita sau subesantionata.

Streaming in timp real pentru evenimente live​

vitalera alimenteaza telemetria live din spatele platformelor de evenimente sportive, transmitand frecventa cardiaca si SpO2 ale alergatorilor de pe ceasurile Garmin catre feed-urile de broadcast in mai putin de o secunda.

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

Testat in productie la scara mare in implementari de eveniment unic cu loturi mari de atleti simultani.

Somn si wellness zilnic​

Pe langa antrenamente, aceeasi integrare furnizeaza:

  • Sesiuni de somn cu stadii (usor, profund, REM, treaz)
  • Frecventa cardiaca in repaus si HRV (RMSSD)
  • Rezumate zilnice -- pasi, calorii, scor de stres, Body Battery
  • Pulse Ox medii nocturne

Totul normalizat in resurse FHIR R5 Observation -- consultati Resurse FHIR.

Cazuri de utilizare​

SegmentExemplu
Platforme de evenimente sportiveSincronizati atleti, alergatori, triatleti sau ciclisti la scara mare. Clasamente live, analize post-cursa, overlay-uri de broadcast.
Antrenament conectat si coachingDatele brute de antrenament alimenteaza planuri de antrenament personalizate fara pierdere de fidelitate.
Cardiologie clinica si reabilitareAcelasi pipeline, deja certificat pentru RPM (marcaj CE MDR, GDPR, ISO 27001).
Wellness corporativAgregati metrici de sanatate Garmin pentru programe de wellness ale angajatilor cu partajare de date bazata pe consimtamant.
Asigurari si riscDate continue de frecventa cardiaca, somn si activitate pentru modele de subscriere si programe de stimulente.
Cercetare si studii cliniceColectare longitudinala de date de wearable cu export in standard FHIR pentru cohorte de cercetare.

Incepeti in 15 minute​

  1. Solicitati credentiale sandbox la info@vitalera.io.
  2. Primiti cheia API si utilizatori de test deja asociati cu conturi sandbox Garmin.
  3. Apelati GET /v2/activities?user_id=demo_runner_01 si inspectati JSON-ul de mai sus cu date reale.
  4. Abonati-va la webhook-ul activity.created.
  5. Treceti in productie.

Nu este necesar NDA pentru a explora sandbox-ul. NDA-ul se aplica doar cand accesati date Garmin de productie (cerinta programului Garmin Health Partner).

Conformitate si proprietatea datelor​

CertificariCE Mark MDR, ISO 27001, ISO 13485
ConfidentialitateConform GDPR, pregatit pentru HIPAA, ENS Alto
Rezidenta datelorUE implicit (AWS eu-west-1). Regiune SUA disponibila.
Proprietatea datelorDatele utilizatorilor dumneavoastra va apartin. vitalera este procesatorul, niciodata operatorul.

Pasii urmatori​