Sağlık Metrikleri - JSON Dışa Aktarma Biçimi
JSON dışa aktarmalarında sağlık metrikleri yapısı için belgeler
Son güncelleme: 31 Ekim 2026
Bu sayfada
JSON dışa aktarmaları sağlık metriklerini metrics dizisinde saklar.
Metrik Adı Biçimi
JSON dışa aktarmalarındaki tüm metrik adları snake_case biçimini kullanır (alt çizgili küçük harf). Örneğin:
- "Step Count" →
"step_count" - "Blood Pressure" →
"blood_pressure" - "Heart Rate" →
"heart_rate" - "Walking + Running Distance" →
"walking_running_distance"
Yapı
metrics dizisi her biri belirli bir sağlık metriği türünü temsil eden nesneler içerir. Çoğu sağlık metriği ortak bir yapıyı izler:
{
"name": "step_count",
"units": "count",
"data": [
{
"qty": 8500,
"date": "2024-02-06 14:30:00 -0800",
"source": "Apple Watch"
}
]
}
Ortak alanlar
name(String): snake_case biçiminde sağlık metriği adı (örn. "step_count", "heart_rate", "active_energy")units(String): Ölçüm birimi (örn. "count", "count/min", "kcal")data(Array): Her biri şunları içeren veri noktası dizisi:qty(Number): Miktar değeridate(Date):yyyy-MM-dd HH:mm:ss Zbiçiminde zaman damgasısource(String, kullanılabilir olduğunda): Örneği kaydeden uygulama veya cihaz
Özel Metrik Biçimleri
Bazı sağlık metriklerinin ortak biçimden farklı benzersiz yapıları vardır:
Kan Basıncı
Kan basıncı okumaları hem sistolik hem diyastolik değerleri içerir:
{
"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"
}
]
}
Alanlar:
systolic(Number): Sistolik (üst) kan basıncı okuması. Özetlenmiş dışa aktarmalar zaman grubundaki okumaların ortalamasını kullanır.diastolic(Number): Diyastolik (alt) kan basıncı okuması. Özetlenmiş dışa aktarmalar zaman grubundaki okumaların ortalamasını kullanır.
Kalp Atış Hızı
Kalp atış hızı verisi minimum, ortalama ve maksimum değerleri içerir:
{
"name": "heart_rate",
"units": "count/min",
"data": [
{
"date": "2024-02-06 14:30:00 -0800",
"Min": 65,
"Avg": 72,
"Max": 85,
"source": "Apple Watch"
}
]
}
Alanlar:
Min(Number): Ölçüm dönemi sırasındaki minimum kalp atış hızıAvg(Number): Ölçüm dönemi sırasındaki ortalama kalp atış hızıMax(Number): Ölçüm dönemi sırasındaki maksimum kalp atış hızı
Kalp Atış Hızı Değişkenliği
Verileri Özetle kapalıyken Kalp Atış Hızı Değişkenliği (SDNN) JSON dışa aktarmaları kullanılabilir atımdan atıma okumaları içerebilir. Bunlar Apple Health’te Kalp Atışı Serisi okuma erişimi gerektirir.
Özetlenmiş dışa aktarmalar, CSV dışa aktarmaları ve Recovery HRV atımdan atıma okumaları içermez.
Uyku Analizi
Uyku verisi yapısı Verileri Özetle’nin açık veya kapalı olmasına bağlıdır.
Verileri Özetle Açık
Verileri Özetle açıkken uyku verisi güne göre özetlenir. Aynı evredeki süreler toplanır. Toplam uyku asleep, core, deep ve REM’in toplamıdır. JSON her günü tutar. CSV’de daha kaba bir zaman grubu o gruptaki en son günü gösterir:
{
"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"
}
]
}
Alanlar:
totalSleep(Number): Saat cinsinden toplam uyku süresiasleep(Number): Kaydedilmiş uyku evresi olmadan uyunan süre, saat cinsindencore(Number): Saat cinsinden core uyku süresideep(Number): Saat cinsinden derin uyku süresirem(Number): Saat cinsinden REM uyku süresiawake(Number): Saat cinsinden uyanık süresleepStart(Date): Uykunun gerçekten başladığı zamansleepEnd(Date): Uykunun gerçekten bittiği zamaninBed(Number): Saat cinsinden yatakta toplam süreinBedStart(Date): Yatağa girdiğiniz zamaninBedEnd(Date): Yataktan çıktığınız zaman
Verileri Özetle Kapalı
Verileri Özetle kapalıyken bireysel uyku segmentleri dahil edilir:
{
"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"
}
]
}
Alanlar:
date,start,startDate(Date): Uyku segmentinin başlangıç zamanıend,endDate(Date): Uyku segmentinin bitiş zamanısource(String): Segmenti kaydeden uygulama veya cihazqty(Number): Saat cinsinden segment süresivalue(String): Uyku durumu - şunlardan biri:"Awake""Asleep"(kategorize edilmemiş uyku evresi)"In Bed""Core""REM""Deep""Unspecified"
Not: "Asleep" kategorize edilmemiş bir uyku evresini ifade eder (toplam uyku süresi değil). Veri kaynağı uyku evresi takibini desteklemiyorsa bu olabilir.
Kan Şekeri
Kan şekeri okumaları öğün zamanlaması bilgisi içerir:
{
"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"
}
]
}
Alanlar:
qty(Number): Kan şekeri düzeyimealTime(String): Şunlardan biri:"Before Meal""After Meal""Unspecified"
Beslenme
Verileri Özetle kapalıyken bireysel beslenme miktarı örnekleri (örneğin Dietary Energy veya Carbohydrates) Apple Health’te kaydedilen yiyecek ayrıntılarını içerebilir. Örneğin:
{
"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"
}
]
}
Alanlar:
qty(Number): Örnek için besin miktarıfoodType(String, isteğe bağlı): Kullanılabilir olduğunda kaynak uygulamanın kaydettiği yiyecek adı
Verileri Özetle açıkken beslenme toplamları foodType içermez.
Cinsel Aktivite
Cinsel aktivite girişleri koruma kullanımını izler:
{
"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"
}
]
}
Alanlar:
Unspecified(Number): Koruma durumu bilinmediğinde o günkü olay sayısıProtection Used(Number): Koruma kullanıldığında o günkü olay sayısıProtection Not Used(Number): Koruma kullanılmadığında o günkü olay sayısı
Özetlenmiş dışa aktarmalar her takvim gününü sayar. JSON her günü tutar. CSV’de daha kaba bir zaman grubu o gruptaki en son günü gösterir.
El Yıkama
El yıkama olayları tamamlanma durumunu izler:
{
"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"
}
]
}
Alanlar:
qty(Number): Saniye cinsinden süre. Özetlenmiş dışa aktarmalar zaman grubundaki ortalama süreyi kullanır.value(String): Oturum 20 saniyeden uzun sürdüğünde"Completed", aksi halde"Incomplete"
Diş Fırçalama
Diş fırçalama olayları tamamlanma durumunu izler:
{
"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"
}
]
}
Alanlar:
qty(Number): Saniye cinsinden süre. Özetlenmiş dışa aktarmalar zaman grubundaki ortalama süreyi kullanır.value(String): Oturum en az 2 dakika sürdüğünde"Completed", aksi halde"Incomplete"
İnsülin Uygulama
İnsülin uygulama girişleri uygulama nedenini içerir:
{
"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"
}
]
}
Alanlar:
qty(Number): Uygulanan insülin miktarı. Özetlenmiş dışa aktarmalar zaman grubundaki miktarları toplar.reason(String): Şunlardan biri:"Bolus"(öğün insülini)"Basal"(bazal insülin)