Gezondheidsmetrieken

Gezondheidsmetrieken vertegenwoordigen de verschillende metingen en gegevenspunten die worden verzameld door uw Apple Health-app en aangesloten apparaten. In JSON-exporten worden gezondheidsmetrieken opgeslagen in de array metrics.

Formaat van Metrieknaam

Alle metrieknamen in JSON-exporten gebruiken het snake_case-formaat (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 vertegenwoordigt 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"
    }
  ]
}

Gemeenschappelijke Velden

• name (String): De naam van de gezondheidsmetriek in snake_case-formaat (bijv. "step_count", "heart_rate", "active_energy")
• units (String): De meeteenheid (bijv. "count", "bpm", "kcal")
• data (Array): Een array van gegevenspunten, elk bevat:
  • qty (Number): De hoeveelheidswaarde
  • date (Date): Tijdstempel in formaat yyyy-MM-dd HH:mm:ss Z

Speciale Metriekformaten

Sommige gezondheidsmetrieken hebben unieke structuren die verschillen 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",
      "systolic": 120,
      "diastolic": 80
    }
  ]
}

Velden:

• systolic (Number): De systolische (bovenste) bloeddrukmeting
• diastolic (Number): De diastolische (onderste) bloeddrukmeting

Hartslag

Hartslaggegevens omvatten minimale, gemiddelde en maximale waarden:

{
  "name": "heart_rate",
  "units": "bpm",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "Min": 65,
      "Avg": 72,
      "Max": 85
    }
  ]
}

Velden:

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

Slaapanalyse

De structuur van slaapgegevens varieert afhankelijk van of gegevensaggregatie is ingeschakeld in uw exportinstellingen.

Geaggregeerde Slaapgegevens

Wanneer aggregatie is ingeschakeld, worden slaapgegevens per dag samengevat:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-06",
      "totalSleep": 7.5,
      "asleep": 7.0,
      "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"
    }
  ]
}

Velden:

• totalSleep (Number): Totale slaaptijd in uren
• asleep (Number): Totale tijd in een slaapfase
• core (Number): Duur van lichte slaap in uren
• deep (Number): Duur van diepe slaap in uren
• rem (Number): Duur van REM-slaap in uren
• sleepStart (Date): Wanneer de slaap daadwerkelijk begon
• sleepEnd (Date): Wanneer de slaap daadwerkelijk eindigde
• inBed (Number): Totale tijd in bed in uren
• inBedStart (Date): Wanneer u naar bed ging
• inBedEnd (Date): Wanneer u opstond

Niet-geaggregeerde Slaapgegevens

Wanneer aggregatie is uitgeschakeld, worden individuele slaapsegmenten opgenomen:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "startDate": "2024-02-05 23:00:00 -0800",
      "endDate": "2024-02-05 23:30:00 -0800",
      "qty": 0.5,
      "value": "Core",
      "deep": 0.0,
      "rem": 0.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"
    }
  ]
}

Velden:

• startDate (Date): Starttijd van het slaapsegment
• endDate (Date): Eindtijd van het slaapsegment
• qty (Number): Duur van het segment in uren
• value (String): Slaapfase - een van:
  • "Awake"
  • "Asleep" (niet-gecategoriseerde slaapfase)
  • "In Bed"
  • "Core"
  • "REM"
  • "Deep"
  • "Unspecified"

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

Bloedglucose

Bloedglucosemetingen omvatten informatie over het tijdstip van de maaltijd:

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

Velden:

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

Seksuele Activiteit

Seksuele activiteitsvermeldingen volgen het gebruik van bescherming:

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

Velden:

• Unspecified (Number): Telling wanneer de beschermingsstatus onbekend is
• Protection Used (Number): Telling wanneer bescherming werd gebruikt
• Protection Not Used (Number): Telling wanneer bescherming niet werd gebruikt

Handen Wassen

Handenwasgebeurtenissen volgen de voltooiingsstatus:

{
  "name": "handwashing",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 12:00:00 -0800",
      "qty": 1,
      "value": "Complete"
    }
  ]
}

Velden:

• qty (Number): Aantal handenwasgebeurtenissen
• value (String): Een van:
  • "Complete"
  • "Incomplete"

Tandenpoetsen

Tandenpoetsgebeurtenissen volgen de voltooiingsstatus:

{
  "name": "toothbrushing",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "qty": 1,
      "value": "Complete"
    }
  ]
}

Velden:

• qty (Number): Aantal tandenpoetsgebeurtenissen
• value (String): Een van:
  • "Complete"
  • "Incomplete"

Insuline Toediening

Insulinetoedieningsvermeldingen omvatten de reden voor toediening:

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

Velden:

• qty (Number): Hoeveelheid toegediende insuline
• reason (String): Een van:
  • "Bolus" (maaltijdinsuline)
  • "Basal" (achtergrondinsuline)

Veelvoorkomende Gezondheidsmetrieken

Enkele veelvoorkomende geëxporteerde gezondheidsmetrieken zijn (alle metrieknamen zijn in snake_case-formaat):

• step_count - Dagelijkse stappentellingen
• walking_running_distance - Afgelegde afstand
• active_energy - Calorieën verbrand door activiteit
• resting_heart_rate - Hartslag in rust
• heart_rate - Hartslagmetingen
• respiratory_rate - Ademhalingsfrequentie
• body_temperature - Lichaamstemperatuurmetingen
• blood_oxygen_saturation - SpO2-niveaus
• weight_&_body_mass - Lichaamsgewichtmetingen
• body_mass_index - Berekende BMI-waarden
• height - Lengtemetingen
• dietary_water - Vloeistofinname
• mindful_minutes - Meditatie- of mindfulness-tijd

Tips

• Tijdsgroepering: Gebruik de tijdsgroeperingsinstellingen in uw exportconfiguratie om te bepalen hoe gegevens worden geaggregeerd (per seconde, minuut, uur, dag, enz.)
• Gegevensaggregatie: Schakel gegevensaggregatie in om slaap en andere metrieken per dag samen te vatten voor eenvoudigere analyse
• Selectieve Export: U kunt kiezen welke specifieke gezondheidsmetrieken u in uw export wilt opnemen om de bestandsgrootte en verwerkingstijd te verminderen

Gerelateerde Documentatie

• Overzicht van JSON Exportformaat
• Handleiding voor Handmatige Export
• Overzicht van Automatiseringen