Yardım Merkezi HealthyApps
Türkçe
Yardım Merkezi
Ana web sitesi ↗

Yardım konularını ara

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
Metrik Adı Biçimi
Yapı Yapı Ortak alanlar
Özel Metrik Biçimleri Özel Metrik Biçimleri Kan BasıncıKalp Atış HızıKalp Atış Hızı DeğişkenliğiUyku AnaliziKan ŞekeriBeslenmeCinsel AktiviteEl YıkamaDiş Fırçalamaİnsülin Uygulama
İlgili belgeler

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ğeri
    • date (Date): yyyy-MM-dd HH:mm:ss Z biç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üresi
  • asleep (Number): Kaydedilmiş uyku evresi olmadan uyunan süre, saat cinsinden
  • core (Number): Saat cinsinden core uyku süresi
  • deep (Number): Saat cinsinden derin uyku süresi
  • rem (Number): Saat cinsinden REM uyku süresi
  • awake (Number): Saat cinsinden uyanık süre
  • sleepStart (Date): Uykunun gerçekten başladığı zaman
  • sleepEnd (Date): Uykunun gerçekten bittiği zaman
  • inBed (Number): Saat cinsinden yatakta toplam süre
  • inBedStart (Date): Yatağa girdiğiniz zaman
  • inBedEnd (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 cihaz
  • qty (Number): Saat cinsinden segment süresi
  • value (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üzeyi
  • mealTime (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)

İlgili belgeler