Naar hoofdinhoud gaan

Garmin-integratie

vitalera is de enige Garmin Health-partner die zich uitsluitend richt op gezondheids- en sportgegevens. Wij combineren de officiele Garmin Health API en de Garmin Connect Mobile SDK om ruwe, volledige en realtime gegevens te leveren — zonder de hiaten van generieke aggregatoren.

Waarom Garmin met vitalera​

Teams die vertrouwen op Health Connect of generieke wearable-aggregatoren voor Garmin-gegevens lopen meestal tegen dezelfde beperkingen aan:

  • Afstand- en GPS-metrieken worden afgerond of gedownsamplet, waardoor de activiteit die u in uw platform ziet niet overeenkomt met wat de atleet daadwerkelijk op zijn horloge heeft opgenomen.
  • Workouts komen onvolledig binnen — ontbrekende rondes, gaten in het hartfrequentiespoor of weggehaalde intervalstructuur.
  • Geavanceerde metrieken worden simpelweg niet blootgesteld: cadans, hartfrequentiezones, SpO2, loopvermogen, trainingsbelasting, stress, Body Battery en andere native Garmin-gegevensbronnen blijven onbereikbaar.
  • Geen live streaming tijdens een activiteit — u krijgt de sessie pas zodra deze afgelopen en gesynchroniseerd is.
  • Synchronisatievertraging van enkele minuten tot uren, wat realtime klinische meldingen of wedstrijdmonitoring onmogelijk maakt.

vitalera verbindt rechtstreeks met de Garmin Health API (server-naar-server) en de Garmin Connect Mobile SDK (op het apparaat), waardoor u dezelfde gegevenskwaliteit krijgt die Garmin intern gebruikt.

API vs SDK vs Health Connect​

Aanbevolen: Garmin Health API via vitalera — de snelste en best schaalbare manier om Garmin-apparaten te verbinden voor 99% van de gebruikssituaties (sportplatformen, RPM, coaching, onderzoek). De SDK is alleen nodig voor sub-seconde live streaming.

MogelijkheidHealth ConnectGarmin Health API (via vitalera)Garmin SDK (via vitalera)
Aanbevolen voor—StandaardkeuzeAlleen broadcast / live TV
Workout-volledigheidGedeeltelijk, hiaten gebruikelijkVolledige sessie + rondesVolledige sessie + rondes
AfstandsnauwkeurigheidAfgerond / geschatRuw, 2-decimalen precisieRuw, 2-decimalen precisie
HartfrequentiezonesNeeJaJa
Cadans & loopvermogenNeeJaJa
SpO2NeeDagelijks + op aanvraagContinue stream
SlaapfasenBeperktVolledig (licht / diep / REM)Volledig
Historisch terugkijkenDagenTot 90 dagenAlleen live
Gebruikerskoppeling UXHandmatig per apparaatEenmalige OAuthVereist app-installatie
IntegratietijdWeken~15 minuten1-2 weken
Schaalt naar grote gebruikersaantallenNeeJa, productiebeproefdEvent-gebaseerd
Server-naar-server (geen app nodig)NeeJaNee (vereist mobiele SDK)
Realtime streaming (sub-seconde)NeeNeeJa

Wanneer wat kiezen​

  • Garmin Health API (via vitalera) — 99% van de gevallen. Sportplatformen, RPM, coaching-apps, onderzoek, verzekeringen, bedrijfswellness. Server-naar-server, geen mobiele SDK vereist, volledige historische gegevens, eenmalige OAuth, schaalt naar grote gebruikersaantallen.
  • Garmin SDK (via vitalera) — Alleen wanneer u sub-seconde live streaming nodig heeft voor broadcast-overlays of noodmeldingen tijdens een live evenement. Vereist een mobiele app.
  • Health Connect — Niet aanbevolen voor klinische of sportgegevens-gebruikssituaties.

Hoe gebruikerskoppeling werkt​

  1. De gebruiker tikt op Garmin verbinden in uw app.
  2. vitalera beheert de OAuth-flow en slaat de koppeling op tegen uw user_id.
  3. Vanaf dat moment wordt elke workout, slaapsessie en dagelijkse samenvatting naar uw webhook gestuurd en is beschikbaar via de API.

Geen apparaatkoppeling. Geen handmatige synchronisatie. Geen "open eerst de Garmin Connect-app."

Voorbeeld: antwoord van een hardloopworkout​

{
  "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 is 10 043,22 — ruw van het horloge, geen afgeronde of gedownsamplete waarde.

Realtime streaming voor live evenementen​

vitalera drijft de live telemetrie achter sportevenementplatformen, waarbij hartfrequentie en SpO2 van hardlopers worden gestreamd van Garmin-horloges naar broadcast-feeds in minder dan een seconde.

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

Productiebeproefd op schaal bij individuele evenement-implementaties met grote velden gelijktijdige atleten.

Slaap en dagelijks welzijn​

Naast workouts levert dezelfde integratie:

  • Slaapsessies met fasen (licht, diep, REM, wakker)
  • Rusthartfrequentie en HRV (RMSSD)
  • Dagelijkse samenvattingen — stappen, calorieen, stressscore, Body Battery
  • Pulsoximetrie-nachtgemiddelden

Alles genormaliseerd naar FHIR R5 Observation-resources — zie FHIR-resources.

Gebruikssituaties​

SegmentVoorbeeld
SportevenementplatformenSynchronisatie van atleten, hardlopers, triatleten of wielrenners op schaal. Live ranglijsten, post-race analyses, broadcast-overlays.
Verbonden training & coachingRuwe trainingsgegevens voeden gepersonaliseerde trainingsplannen zonder kwaliteitsverlies.
Klinische cardiologie & revalidatieDezelfde pipeline, al gecertificeerd voor RPM (CE-markering MDR, AVG, ISO 27001).
BedrijfswellnessGeaggregeerde Garmin-gezondheidsmetrieken voor medewerker-wellnessprogramma's met toestemmingsgebaseerde gegevensdeling.
Verzekeringen & risicoContinue hartfrequentie-, slaap- en activiteitsgegevens voor verzekeringsmodellen en incentiveprogramma's.
Onderzoek & klinische studiesLongitudinale wearable-gegevensverzameling met FHIR-conforme export voor onderzoekscohorten.

Start in 15 minuten​

  1. Vraag sandbox-toegangsgegevens aan bij info@vitalera.io.
  2. Ontvang uw API-sleutel en testgebruikers die al gekoppeld zijn aan Garmin-sandbox-accounts.
  3. Roep GET /v2/activities?user_id=demo_runner_01 aan en inspecteer de bovenstaande JSON met echte gegevens.
  4. Abonneer u op de activity.created-webhook.
  5. Ga live.

Geen NDA vereist om de sandbox te verkennen. NDA is pas nodig wanneer u toegang krijgt tot productie-Garmin-gegevens (Garmin Health Partner-vereiste).

Compliance & gegevenseigendom​

CertificeringenCE-markering MDR, ISO 27001, ISO 13485
PrivacyAVG-conform, HIPAA-gereed, ENS Alto
GegevensresidentieEU standaard (AWS eu-west-1). US-regio beschikbaar.
GegevenseigendomU bezit de gegevens van uw gebruikers. vitalera is de verwerker, nooit de verwerkingsverantwoordelijke.

Volgende stappen​