Helpcentrum HealthyApps
Nederlands
Helpcentrum
Hoofdwebsite ↗

Zoek in helponderwerpen

Gezondheidsmetrieken - JSON-exportformaat

Documentatie voor de structuur van gezondheidsmetrieken in JSON-exporten

Laatst bijgewerkt: 31 oktober 2026

Op deze pagina
Indeling metrieknaam
Structuur Structuur Gemeenschappelijke velden
Speciale metriekindelingen Speciale metriekindelingen BloeddrukHartslagHartslagvariabiliteitSlaapanalyseBloedglucoseVoedingSeksuele activiteitHanden wassenTanden poetsenInsulinetoediening
Gerelateerde documentatie

JSON-exporten slaan gezondheidsmetrieken op in de array metrics.

Indeling metrieknaam

Alle metrieknamen in JSON-exporten gebruiken de indeling snake_case (kleine letters met underscores). Bijvoorbeeld:

  • "Step Count" wordt "step_count"
  • "Blood Pressure" wordt "blood_pressure"
  • "Heart Rate" wordt "heart_rate"
  • "Walking + Running Distance" wordt "walking_running_distance"

Structuur

De array metrics bevat objecten, elk voor een specifiek type gezondheidsmetriek. De meeste gezondheidsmetrieken volgen een gemeenschappelijke structuur:

{
  "name": "step_count",
  "units": "count",
  "data": [
    {
      "qty": 8500,
      "date": "2024-02-06 14:30:00 -0800",
      "source": "Apple Watch"
    }
  ]
}

Gemeenschappelijke velden

  • name (String): De naam van de gezondheidsmetriek in snake_case (bijv. "step_count", "heart_rate", "active_energy")
  • units (String): De meeteenheid (bijv. "count", "count/min", "kcal")
  • data (Array): Een array van datapunten, elk met:
    • qty (Number): De hoeveelheidswaarde
    • date (Date): Tijdstempel in de indeling yyyy-MM-dd HH:mm:ss Z
    • source (String, wanneer beschikbaar): De app of het apparaat dat het monster heeft vastgelegd

Speciale metriekindelingen

Sommige gezondheidsmetrieken hebben unieke structuren die afwijken van het gemeenschappelijke formaat:

Bloeddruk

Bloeddrukmetingen omvatten zowel systolische als diastolische waarden:

{
  "name": "blood_pressure",
  "units": "mmHg",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "start": "2024-02-06 14:30:00 -0800",
      "end": "2024-02-06 14:30:00 -0800",
      "systolic": 120,
      "diastolic": 80,
      "source": "Health"
    }
  ]
}

Velden:

  • systolic (Number): De systolische (bovenste) bloeddrukmeting. Samengevatte exporten gebruiken het gemiddelde van de metingen in de tijdgroep.
  • diastolic (Number): De diastolische (onderste) bloeddrukmeting. Samengevatte exporten gebruiken het gemiddelde van de metingen in de tijdgroep.

Hartslag

Hartslaggegevens omvatten minimum-, gemiddelde en maximumwaarden:

{
  "name": "heart_rate",
  "units": "count/min",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "Min": 65,
      "Avg": 72,
      "Max": 85,
      "source": "Apple Watch"
    }
  ]
}

Velden:

  • Min (Number): Minimale hartslag tijdens de meetperiode
  • Avg (Number): Gemiddelde hartslag tijdens de meetperiode
  • Max (Number): Maximale hartslag tijdens de meetperiode

Hartslagvariabiliteit

Met Gegevens samenvatten uit kunnen JSON-exporten van hartslagvariabiliteit (SDNN) beschikbare beat-to-beat-metingen bevatten. Deze vereisen leestoegang tot Hartslagreeks in Apple Health.

Samengevatte exporten, CSV-exporten en Herstel-HRV bevatten geen beat-to-beat-metingen.

Slaapanalyse

De structuur van slaapgegevens hangt af van of Gegevens samenvatten aan of uit staat.

Gegevens samenvatten aan

Met Gegevens samenvatten aan worden slaapgegevens per dag samengevat. Duraties in dezelfde fase worden opgeteld. Totale slaap is asleep, core, deep en REM bij elkaar. JSON bewaart elke dag. In CSV toont een grovere tijdgroep de laatste dag in die groep:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "totalSleep": 7.5,
      "asleep": 0.5,
      "core": 3.5,
      "deep": 1.5,
      "rem": 2.0,
      "sleepStart": "2024-02-05 23:00:00 -0800",
      "sleepEnd": "2024-02-06 06:30:00 -0800",
      "inBed": 8.0,
      "inBedStart": "2024-02-05 22:45:00 -0800",
      "inBedEnd": "2024-02-06 06:45:00 -0800",
      "awake": 0.0,
      "source": "Apple Watch"
    }
  ]
}

Velden:

  • totalSleep (Number): Totale slaaptijd in uren
  • asleep (Number): Tijd slapend zonder geregistreerde slaapfase, in uren
  • core (Number): Core-slaapduur in uren
  • deep (Number): Diepe slaapduur in uren
  • rem (Number): REM-slaapduur in uren
  • awake (Number): Tijd wakker in uren
  • sleepStart (Date): Wanneer de slaap werkelijk begon
  • sleepEnd (Date): Wanneer de slaap werkelijk eindigde
  • inBed (Number): Totale tijd in bed in uren
  • inBedStart (Date): Wanneer je naar bed ging
  • inBedEnd (Date): Wanneer je uit bed ging

Gegevens samenvatten uit

Met Gegevens samenvatten uit worden individuele slaapsegmenten opgenomen:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-05 23:00:00 -0800",
      "start": "2024-02-05 23:00:00 -0800",
      "end": "2024-02-05 23:30:00 -0800",
      "startDate": "2024-02-05 23:00:00 -0800",
      "endDate": "2024-02-05 23:30:00 -0800",
      "qty": 0.5,
      "value": "Core",
      "source": "Apple Watch"
    }
  ]
}

Velden:

  • date, start, startDate (Date): Starttijd van het slaapsegment
  • end, endDate (Date): Eindtijd van het slaapsegment
  • source (String): De app of het apparaat dat het segment heeft vastgelegd
  • qty (Number): Duur van het segment in uren
  • value (String): Slaapstatus - een van:
    • "Awake"
    • "Asleep" (niet-gecategoriseerde slaapfase)
    • "In Bed"
    • "Core"
    • "REM"
    • "Deep"
    • "Unspecified"

Opmerking: "Asleep" verwijst naar een niet-gecategoriseerde slaapfase (niet naar de totale slaaptijd). Dit kan voorkomen als de gegevensbron geen tracking van slaapfasen ondersteunt.

Bloedglucose

Bloedglucosemetingen bevatten informatie over maaltijdtiming:

{
  "name": "blood_glucose",
  "units": "mg/dL",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 95,
      "mealTime": "Before Meal",
      "source": "Health"
    }
  ]
}

Velden:

  • qty (Number): Bloedglucoseniveau
  • mealTime (String): Een van:
    • "Before Meal"
    • "After Meal"
    • "Unspecified"

Voeding

Wanneer Gegevens samenvatten uit staat, kunnen individuele voedingshoeveelheidsmonsters (bijvoorbeeld Voedingsenergie of Koolhydraten) voedseldetails bevatten die in Apple Health zijn vastgelegd. Bijvoorbeeld:

{
  "name": "dietary_energy",
  "units": "kcal",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 240,
      "source": "Lose It!",
      "foodType": "Boneless, Skinless Grilled Chicken Breast"
    }
  ]
}

Velden:

  • qty (Number): Voedingshoeveelheid van het monster
  • foodType (String, optioneel): Voedselnaam vastgelegd door de bron-app, wanneer beschikbaar

Met Gegevens samenvatten aan bevatten voedingstotalen geen foodType.

Seksuele activiteit

Vermeldingen van seksuele activiteit registreren beschermingsgebruik:

{
  "name": "sexual_activity",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "Unspecified": 0,
      "Protection Used": 1,
      "Protection Not Used": 0,
      "source": "Health"
    }
  ]
}

Velden:

  • Unspecified (Number): Aantal gebeurtenissen die dag wanneer de beschermingsstatus onbekend is
  • Protection Used (Number): Aantal gebeurtenissen die dag wanneer bescherming is gebruikt
  • Protection Not Used (Number): Aantal gebeurtenissen die dag wanneer geen bescherming is gebruikt

Samengevatte exporten tellen elke kalenderdag. JSON bewaart elke dag. In CSV toont een grovere tijdgroep de laatste dag in die groep.

Handen wassen

Gebeurtenissen van handen wassen registreren de voltooiingsstatus:

{
  "name": "handwashing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 12:00:00 -0800",
      "start": "2024-02-06 12:00:00 -0800",
      "end": "2024-02-06 12:00:25 -0800",
      "qty": 25,
      "value": "Completed",
      "source": "Apple Watch"
    }
  ]
}

Velden:

  • qty (Number): Duur in seconden. Samengevatte exporten gebruiken de gemiddelde duur in de tijdgroep.
  • value (String): "Completed" wanneer de sessie langer dan 20 seconden duurt; anders "Incomplete"

Tanden poetsen

Gebeurtenissen van tanden poetsen registreren de voltooiingsstatus:

{
  "name": "toothbrushing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:02:10 -0800",
      "qty": 130,
      "value": "Completed",
      "source": "Health"
    }
  ]
}

Velden:

  • qty (Number): Duur in seconden. Samengevatte exporten gebruiken de gemiddelde duur in de tijdgroep.
  • value (String): "Completed" wanneer de sessie minstens 2 minuten duurt; anders "Incomplete"

Insulinetoediening

Vermeldingen van insulinetoediening bevatten de reden van toediening:

{
  "name": "insulin_delivery",
  "units": "IU",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 5,
      "reason": "Bolus",
      "source": "Health"
    }
  ]
}

Velden:

  • qty (Number): Hoeveelheid toegediende insuline. Samengevatte exporten tellen de hoeveelheden in de tijdgroep op.
  • reason (String): Een van:
    • "Bolus" (maaltijdinsuline)
    • "Basal" (basisinsuline)

Gerelateerde documentatie