Hälsomått - JSON-exportformat
Dokumentation för strukturen för hälsomått i JSON-exporter
Senast uppdaterad: 31 oktober 2026
På denna sida
JSON-exporter lagrar hälsomått i arrayet metrics.
Format för måttnamn
Alla måttnamn i JSON-exporter använder formatet snake_case (gemener med understreck). Till exempel:
- "Step Count" blir
"step_count" - "Blood Pressure" blir
"blood_pressure" - "Heart Rate" blir
"heart_rate" - "Walking + Running Distance" blir
"walking_running_distance"
Struktur
Arrayet metrics innehåller objekt, där varje objekt representerar en specifik typ av hälsomått. De flesta hälsomått följer en gemensam struktur:
{
"name": "step_count",
"units": "count",
"data": [
{
"qty": 8500,
"date": "2024-02-06 14:30:00 -0800",
"source": "Apple Watch"
}
]
}
Gemensamma fält
name(String): Namnet på hälsomåttet i snake_case-format (t.ex. "step_count", "heart_rate", "active_energy")units(String): Måttenheten (t.ex. "count", "count/min", "kcal")data(Array): En array med datapunkter, som var och en innehåller:qty(Number): Mängdvärdetdate(Date): Tidsstämpel i formatetyyyy-MM-dd HH:mm:ss Zsource(String, när tillgängligt): Appen eller enheten som registrerade provet
Särskilda måttformat
Vissa hälsomått har unika strukturer som skiljer sig från det gemensamma formatet:
Blodtryck
Blodtrycksmätningar inkluderar både systoliska och diastoliska värden:
{
"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"
}
]
}
Fält:
systolic(Number): Den systoliska (övre) blodtrycksmätningen. Summerade exporter använder genomsnittet av mätningarna i tidsgruppen.diastolic(Number): Den diastoliska (nedre) blodtrycksmätningen. Summerade exporter använder genomsnittet av mätningarna i tidsgruppen.
Hjärtfrekvens
Hjärtfrekvensdata inkluderar minimum-, genomsnitts- och maximumvärden:
{
"name": "heart_rate",
"units": "count/min",
"data": [
{
"date": "2024-02-06 14:30:00 -0800",
"Min": 65,
"Avg": 72,
"Max": 85,
"source": "Apple Watch"
}
]
}
Fält:
Min(Number): Minimihjärtfrekvens under mätperiodenAvg(Number): Genomsnittlig hjärtfrekvens under mätperiodenMax(Number): Maximihjärtfrekvens under mätperioden
Hjärtfrekvensvariabilitet
Med Summer data avstängt kan JSON-exporter av hjärtfrekvensvariabilitet (SDNN) inkludera tillgängliga beat-to-beat-mätningar. Dessa kräver läsbehörighet för Hjärtrytmserie i Apple Health.
Summerade exporter, CSV-exporter och Recovery HRV inkluderar inte beat-to-beat-mätningar.
Sömnanalys
Strukturen för sömndata beror på om Summer data är på eller av.
Summer data på
Med Summer data på summeras sömndata per dag. Varaktigheter i samma fas läggs ihop. Total sömn är asleep, core, deep och REM lagda ihop. JSON behåller varje dag. I CSV visar en grovare tidsgrupp den senaste dagen i den gruppen:
{
"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"
}
]
}
Fält:
totalSleep(Number): Total tid i sömn i timmarasleep(Number): Tid i sömn utan registrerad sömnfas, i timmarcore(Number): Core-sömnens längd i timmardeep(Number): Djupsömnens längd i timmarrem(Number): REM-sömnens längd i timmarawake(Number): Tid vaken i timmarsleepStart(Date): När sömnen faktiskt börjadesleepEnd(Date): När sömnen faktiskt slutadeinBed(Number): Total tid i sängen i timmarinBedStart(Date): När du gick till sängsinBedEnd(Date): När du steg upp
Summer data av
Med Summer data av inkluderas individuella sömnsegment:
{
"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"
}
]
}
Fält:
date,start,startDate(Date): Starttid för sömnsegmentetend,endDate(Date): Sluttid för sömnsegmentetsource(String): Appen eller enheten som registrerade segmentetqty(Number): Segmentets längd i timmarvalue(String): Sömntillstånd - ett av:"Awake""Asleep"(okategoriserad sömnfas)"In Bed""Core""REM""Deep""Unspecified"
Obs: "Asleep" avser en okategoriserad sömnfas (inte total tid i sömn). Detta kan förekomma om datakällan inte stöder spårning av sömnfaser.
Blodsocker
Blodsockermätningar inkluderar information om måltidstiming:
{
"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"
}
]
}
Fält:
qty(Number): BlodsockernivåmealTime(String): Ett av:"Before Meal""After Meal""Unspecified"
Näring
När Summer data är avstängt kan individuella näringsmängdprover (till exempel Dietary Energy eller Carbohydrates) inkludera matdetaljer som registrerats i Apple Health. Till exempel:
{
"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"
}
]
}
Fält:
qty(Number): Näringsmängd för provetfoodType(String, valfritt): Matnamn registrerat av källappen, när det finns
Med Summer data på inkluderar näringstotaler inte foodType.
Sexuell aktivitet
Poster för sexuell aktivitet spårar användning av skydd:
{
"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"
}
]
}
Fält:
Unspecified(Number): Antal händelser den dagen när skyddsstatus är okändProtection Used(Number): Antal händelser den dagen när skydd användesProtection Not Used(Number): Antal händelser den dagen när skydd inte användes
Summerade exporter räknar varje kalenderdag. JSON behåller varje dag. I CSV visar en grovare tidsgrupp den senaste dagen i den gruppen.
Handtvätt
Handtvättshändelser spårar slutförandestatus:
{
"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"
}
]
}
Fält:
qty(Number): Längd i sekunder. Summerade exporter använder genomsnittlig längd i tidsgruppen.value(String):"Completed"när sessionen varar mer än 20 sekunder, annars"Incomplete"
Tandborstning
Tandborstningshändelser spårar slutförandestatus:
{
"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"
}
]
}
Fält:
qty(Number): Längd i sekunder. Summerade exporter använder genomsnittlig längd i tidsgruppen.value(String):"Completed"när sessionen varar minst 2 minuter, annars"Incomplete"
Insulinleverans
Poster för insulinleverans inkluderar orsaken till leveransen:
{
"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"
}
]
}
Fält:
qty(Number): Mängd levererat insulin. Summerade exporter summerar mängderna i tidsgruppen.reason(String): Ett av:"Bolus"(måltidsinsulin)"Basal"(basinsulin)