Ugrás a fő tartalomra

Garmin integráció

A vitalera az egyetlen Garmin Health partner, amely kizárólag egészségügyi és sportszintű adatokra összpontosít. Kombináljuk a hivatalos Garmin Health API-t és a Garmin Connect Mobile SDK-t, hogy nyers, teljes és valós idejű adatokat biztosítsunk — az általános aggregátorok hiányosságai nélkül.

Miért Garmin a vitalerával​

Azok a csapatok, amelyek a Health Connect-re vagy általános viselhető eszköz aggregátorokra támaszkodnak Garmin adatok lekérésére, általában ugyanazokba a korlátokba ütköznek:

  • A távolság- és GPS-metrikák kerekítve vagy alulmintázva érkeznek, így a platformon látott tevékenység nem egyezik azzal, amit a sportoló ténylegesen rögzített az óráján.
  • Az edzések hiányosan érkeznek meg — hiányzó körök, szünetek a pulzusnyomvonalban vagy az intervallumszerkezet eltávolítása.
  • A fejlett metrikák egyszerűen nincsenek kitéve: lépésszám, pulzuszónák, SpO2, futási teljesítmény, edzésterhelés, stressz, Body Battery és egyéb natív Garmin adatforrások elérhetetlenek maradnak.
  • Nincs élő streaming a tevékenység alatt — csak akkor kapja meg a foglalkozást, miután befejeződött és szinkronizálódott.
  • Több perctől órákig terjedő szinkronizálási késés, ami lehetetlenné teszi a valós idejű klinikai riasztásokat vagy a versenykövetést.

A vitalera közvetlenül csatlakozik a Garmin Health API-hoz (szerver-szerver) és a Garmin Connect Mobile SDK-hoz (eszközön), ugyanazt az adathűséget biztosítva, amit a Garmin belsőleg használ.

API vs SDK vs Health Connect​

Ajánlott: Garmin Health API a vitalerán keresztül — a leggyorsabb és legskálázhatóbb módja a Garmin eszközök csatlakoztatásának a felhasználási esetek 99%-ában (sportplatformok, RPM, edzőprogramok, kutatás). Az SDK csak másodperc alatti élő streaminghez szükséges.

KépességHealth ConnectGarmin Health API (vitalerán keresztül)Garmin SDK (vitalerán keresztül)
Ajánlott felhasználási terület—Alapértelmezett választásCsak közvetítés / élő TV
Edzés teljességeRészleges, hiányok gyakoriakTeljes foglalkozás + körökTeljes foglalkozás + körök
Távolság pontosságaKerekített / közelítettNyers, 2 tizedesjegy pontosságNyers, 2 tizedesjegy pontosság
PulzuszónákNemIgenIgen
Lépésszám és futási teljesítményNemIgenIgen
SpO2NemNapi + igény szerintiFolyamatos stream
Alvási fázisokKorlátozottTeljes (könnyű / mély / REM)Teljes
Előzményadatok visszatöltéseNapokLegfeljebb 90 napCsak élő
Felhasználó-összekapcsolás UXKézi eszközönkéntEgyszeri OAuthAlkalmazás telepítés szükséges
Integrációs időHetek~15 perc1-2 hét
Skálázás nagy felhasználói bázisokraNemIgen, éles környezetben tesztelveEseményalapú
Szerver-szerver (alkalmazás nélkül)NemIgenNem (mobil SDK szükséges)
Valós idejű streaming (másodperc alatti)NemNemIgen

Mikor melyiket válassza​

  • Garmin Health API (vitalerán keresztül) — Az esetek 99%-a. Sportplatformok, RPM, edzőalkalmazások, kutatás, biztosítás, vállalati wellness. Szerver-szerver, nincs szükség mobil SDK-ra, teljes előzményadatok, egyszeri OAuth, nagy felhasználói bázisokra skálázható.
  • Garmin SDK (vitalerán keresztül) — Csak ha másodperc alatti élő streamingre van szüksége közvetítési átfedésekhez vagy vészhelyzeti riasztásokhoz élő események során. Mobilalkalmazás szükséges.
  • Health Connect — Klinikai vagy sportszintű felhasználási esetekhez nem ajánlott.

Hogyan működik a felhasználó-összekapcsolás​

  1. A felhasználó megérinti a Garmin csatlakoztatása gombot az Ön alkalmazásában.
  2. A vitalera kezeli az OAuth folyamatot és az összekapcsolást az Ön user_id-jával tárolja.
  3. Ettől a pillanattól kezdve minden edzés, alvásadatok és napi összefoglaló a webhookjára kerül, és az API-n keresztül elérhető.

Nincs eszközönkénti párosítás. Nincs manuális szinkronizálás. Nincs „kérjük, először nyissa meg a Garmin Connect alkalmazást."

Példa: futóedzés válasz​

{
  "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" }
}

A distance_meters 10 043,22 — nyers érték az óráról, nem kerekített vagy alulmintázott érték.

Valós idejű streaming élő eseményekhez​

A vitalera működteti a sportesemény-platformok mögötti élő telemetriát, a futók pulzusát és SpO2-jét Garmin órákról a közvetítési feedekbe egy másodpercnél rövidebb idő alatt streamelve.

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

Éles környezetben tesztelve nagy léptékben egyeseményes telepítéseknél, nagy létszámú egyidejű sportoló mezőnnyel.

Alvás és napi wellness​

Az edzéseken túl ugyanaz az integráció a következőket biztosítja:

  • Alvási foglalkozások fázisokkal (könnyű, mély, REM, éber)
  • Nyugalmi pulzus és HRV (RMSSD)
  • Napi összefoglalók — lépések, kalóriák, stressz-pontszám, Body Battery
  • Pulse Ox éjszakai átlagok

Minden FHIR R5 Observation erőforrásokra normalizálva — lásd FHIR erőforrások.

Felhasználási esetek​

SzegmensPélda
Sportesemény-platformokSportolók, futók, triatlonisták vagy kerékpárosok szinkronizálása nagy léptékben. Élő ranglisták, verseny utáni elemzések, közvetítési átfedések.
Összekapcsolt edzés és coachingNyers edzésadatok személyre szabott edzésterveket táplálnak az adathűség elvesztése nélkül.
Klinikai kardiológia és rehabilitációUgyanaz a csővezeték, már RPM-re tanúsítva (CE Mark MDR, GDPR, ISO 27001).
Vállalati wellnessGarmin egészségügyi metrikák összesítése munkavállalói wellness programokhoz hozzájáruláson alapuló adatmegosztással.
Biztosítás és kockázatFolyamatos pulzus-, alvás- és aktivitási adatok kockázatértékelési modellekhez és ösztönző programokhoz.
Kutatás és klinikai vizsgálatokHosszú távú viselhető eszközös adatgyűjtés FHIR-szabványú exporttal kutatási kohorszokhoz.

Kezdjen el 15 perc alatt​

  1. Kérjen sandbox hozzáférést az [email protected] címen.
  2. Kapja meg API kulcsát és tesztfelhasználóit, amelyek már Garmin sandbox fiókokhoz vannak kapcsolva.
  3. Hívja meg a GET /v2/activities?user_id=demo_runner_01 végpontot és vizsgálja meg a fenti JSON-t valós adatokkal.
  4. Iratkozzon fel az activity.created webhookra.
  5. Induljon élesbe.

A sandbox felfedezéséhez nem szükséges NDA. Az NDA csak akkor lép életbe, amikor éles Garmin adatokhoz fér hozzá (Garmin Health Partner követelmény).

Megfelelőség és adattulajdonlás​

TanúsítványokCE Mark MDR, ISO 27001, ISO 13485
AdatvédelemGDPR-kompatibilis, HIPAA-kész, ENS Alto
Adattárolás helyeAlapértelmezetten EU (AWS eu-west-1). US régió elérhető.
AdattulajdonlásAz Ön felhasználóinak adatai az Ön tulajdonában vannak. A vitalera adatfeldolgozó, soha nem adatkezelő.

Következő lépések​