Eduki nagusira joan

Garmin integrazioa

vitalera Garmin Health bazkide bakarra da osasun eta kirol-mailako datuetan soilik zentratua. Garmin Health API ofiziala eta Garmin Connect Mobile SDK konbinatzen ditugu gordina, osoa eta denbora errealeko datuak emateko — agregatzaile generikoen hutsunerik gabe.

Zergatik Garmin vitalera-rekin​

Health Connect-en edo wearable agregatzaile generikoetan fidatzen diren taldeak Garmin datuak ateratzeko, normalean muga berdinekin topo egiten dute:

  • Distantzia eta GPS metrikak biribildu edo azpilaginketa jasaten dute, eta, ondorioz, zure plataforman ikusten duzun jarduera ez dator bat atletak bere erlojuan benetan erregistratu zuenarekin.
  • Entrenamenduk osatu gabe iristen dira — itzuli falta direnak, bihotz-maiztasunaren trazuan hutsuneak edo kenduta tarte-egitura.
  • Metrika aurreratuak ez dira sinpleki erakusten: kadentzia, bihotz-maiztasun eremuak, SpO2, korrika-potentzia, entrenamendu-karga, estresa, Body Battery eta Garmin-en beste datu-iturri natibo batzuk irismenetik kanpo geratzen dira.
  • Jarduera batean zuzeneko streaming-ik ez — saioa amaitu eta sinkronizatu ondoren baino ez duzu jasotzen.
  • Minutu batzuetatik ordutaraino doan sinkronizazio-latentzia, eta horrek denbora errealeko alerta klinikoak edo lasterketa-monitorizazioa ezinezko bihurtzen ditu.

vitalera-k zuzenean konektatzen du Garmin Health API-ra (zerbitzaritik zerbitzarira) eta Garmin Connect Mobile SDK-ra (gailuan), Garmin-ek barnean erabiltzen duen datu-fideltasun bera emanez.

API vs SDK vs Health Connect​

Gomendatua: Garmin Health API vitalera bidez — Garmin gailuak konektatzeko modurik azkarrena eta eskalagarriena erabilera-kasuen %99rako (kirol-plataformak, RPM, coaching, ikerketa). SDK soilik segundo azpiko zuzeneko streaming-erako behar da.

GaitasunaHealth ConnectGarmin Health API (vitalera bidez)Garmin SDK (vitalera bidez)
Gomendatua honetarako—Aukera lehenetsiaBroadcast / zuzeneko telebista soilik
Entrenamendu osotasunaPartziala, hutsuneak ohikoakSaio osoa + itzuliakSaio osoa + itzuliak
Distantzia zehaztasunaBiribildua / hurbilketaGordina, 2 dezimalen zehaztasunaGordina, 2 dezimalen zehaztasuna
Bihotz-maiztasun eremuakEzBaiBai
Kadentzia eta korrika-potentziaEzBaiBai
SpO2EzEgunekoa + eskaeraraEtengabeko stream-a
Lo-faseakMugatuaOsoa (arina / sakona / REM)Osoa
Atzerako datu-betetze historikoaEgunak90 egun arteZuzenekoa soilik
Erabiltzaile-lotura UXEskuzkoa gailu bakoitzekoBehineko OAuthAplikazioaren instalazioa behar du
Integrazio-denboraAsteak~15 minutu1-2 aste
Erabiltzaile-oinarri handietara eskalagarriaEzBai, produkzioan probatuaEkitaldi-oinarria
Zerbitzaritik zerbitzarira (aplikaziorik gabe)EzBaiEz (mugikorreko SDK behar du)
Denbora errealeko streaming-a (segundo azpikoa)EzEzBai

Noiz aukeratu zer​

  • Garmin Health API (vitalera bidez) — kasuen %99. Kirol-plataformak, RPM, coaching aplikazioak, ikerketa, aseguruak, enpresa-osasuna. Zerbitzaritik zerbitzarira, mugikorreko SDK-rik gabe, datu historiko osoak, behineko OAuth, erabiltzaile-oinarri handietara eskalagarria.
  • Garmin SDK (vitalera bidez) — Soilik segundo azpiko zuzeneko streaming-a behar duzunean broadcast-eko gainjartzeetarako edo larrialdi-alertetarako zuzeneko ekitaldi batean. Mugikorreko aplikazioa behar du.
  • Health Connect — Ez da gomendatzen erabilera-kasu kliniko edo kirol-mailakoetarako.

Nola funtzionatzen du erabiltzaile-loturak​

  1. Erabiltzaileak Konektatu Garmin sakatzen du zure aplikazioan.
  2. vitalera-k OAuth fluxua kudeatzen du eta lotura zure user_id-arekin gordetzen du.
  3. Momentu horretatik, entrenamendu, lo-saio eta eguneko laburpen guztiak zure webhook-era bidaltzen dira eta API bidez eskuragarri daude.

Gailu bakoitzeko parekatzerik ez. Eskuzko sinkronizaziorik ez. "Mesedez, ireki Garmin Connect aplikazioa lehenik" ez.

Adibidea: korrika-entrenamenduaren erantzuna​

{
  "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 10 043,22 da — gordina erlojutik, ez biribildutako edo azpilagindutako balio bat.

Denbora errealeko streaming-a zuzeneko ekitaldietarako​

vitalera-k kirol-ekitaldien plataformen atzean dagoen zuzeneko telemetria elikatzen du, korrikalari baten bihotz-maiztasuna eta SpO2 Garmin erlojuetatik broadcast-eko feed-era segundo bat baino gutxiagoan igorriz.

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

Produkzioan probatua eskala handian ekitaldi bakarreko hedapenetan, aldi bereko atleta-multzo handiekin.

Lo eta eguneko ongizatea​

Entrenamenduen gainera, integrazio berak honako hauek eskaintzen ditu:

  • Lo-saioak faseekin (arina, sakona, REM, esna)
  • Atsedeneko bihotz-maiztasuna eta HRV (RMSSD)
  • Eguneko laburpenak — urratsak, kaloriak, estres-puntuazioa, Body Battery
  • Pulse Ox gaueko batezbestekoak

Dena FHIR R5 Observation baliabideetara normalizatuta — ikusi FHIR baliabideak.

Erabilera-kasuak​

SegmentuaAdibidea
Kirol-ekitaldien plataformakAtletak, korrikalariak, triatleta edo txirrindulariak eskala handian sinkronizatu. Zuzeneko sailkapenak, lasterketa-osteko analisiak, broadcast gainjartzeak.
Entrenamendu konektatua eta coaching-aEntrenamendu-datu gordinak pertsonalizatutako entrenamendu-planak elikatzen dituzte fideltasuna galdu gabe.
Kardiologia klinikoa eta errehabilitazioaPipeline bera, dagoeneko RPMrako ziurtatua (CE Mark MDR, GDPR, ISO 27001).
Enpresa-ongizateaGarmin osasun-metrikak bilatu langile-ongizate programetarako adostasunean oinarritutako datu-partekatzarekin.
Aseguru eta arriskuaEtengabeko bihotz-maiztasuna, lo eta jarduera-datuak aseguru-modeloetarako eta pizgarri-programetarako.
Ikerketa eta entsegu klinikoakLuzetarako wearable datuak biltzea FHIR estandarreko esportazioarekin ikerketa-kohorteentzat.

Hasi 15 minututan​

  1. Eskatu sandbox kredentzialak info@vitalera.io helbidean.
  2. Jaso zure API gakoa eta proba-erabiltzaileak dagoeneko Garmin sandbox kontuetara lotuta.
  3. Deitu GET /v2/activities?user_id=demo_runner_01 eta ikuskatu goiko JSON-a benetako datuekin.
  4. Harpidetu activity.created webhook-era.
  5. Joan zuzenekora.

Sandbox-a arakatzeko ez da NDA behar. NDA soilik produkzioko Garmin datuetara sartzen zarenean aktibatzen da (Garmin Health Partner eskakizuna).

Betetze-araudia eta datuen jabetza​

ZiurtagiriakCE Mark MDR, ISO 27001, ISO 13485
PribatutasunaGDPR betetzen du, HIPAA prest, ENS Alto
Datuen egoitzaEU lehenetsita (AWS eu-west-1). AEB eskualdea eskuragarri.
Datuen jabetzaZure erabiltzaileen datuak zureak dira. vitalera prozesatzailea da, inoiz ez kontrolatzailea.

Hurrengo urratsak​