Sağlık Metrikleri

Sağlık metrikleri, Apple Health uygulamanız ve bağlı cihazlar tarafından toplanan çeşitli ölçümleri ve veri noktalarını temsil eder. JSON dışa aktarmalarda sağlık metrikleri metrics dizisinde saklanır.

Metrik Adı Formatı

JSON dışa aktarmalardaki tüm metrik adları snake_case formatını kullanır (alt çizgili küçük harfler). Örneğin:

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

Yapı

metrics dizisi, her biri belirli bir sağlık metrik türünü temsil eden nesneler içerir. Çoğu sağlık metrikleri ortak bir yapıyı takip eder:

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

Ortak Alanlar

• name (String): Sağlık metriğinin snake_case formatındaki adı (örn. "step_count", "heart_rate", "active_energy")
• units (String): Ölçü birimi (örn. "count", "bpm", "kcal")
• data (Array): Her biri şunları içeren veri noktaları dizisi:
  • qty (Number): Miktar değeri
  • date (Date): yyyy-MM-dd HH:mm:ss Z formatında zaman damgası

Özel Metrik Formatları

Bazı sağlık metrikleri ortak formattan farklı benzersiz yapılara sahiptir:

Kan Basıncı

Kan basıncı okumaları hem sistolik hem de diyastolik değerleri içerir:

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

Alanlar:

• systolic (Number): Sistolik (üst) kan basıncı okuması
• diastolic (Number): Diyastolik (alt) kan basıncı okuması

Kalp Atış Hızı

Kalp atış hızı verileri minimum, ortalama ve maksimum değerleri içerir:

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

Alanlar:

• Min (Number): Ölçüm dönemi boyunca minimum kalp atış hızı
• Avg (Number): Ölçüm dönemi boyunca ortalama kalp atış hızı
• Max (Number): Ölçüm dönemi boyunca maksimum kalp atış hızı

Uyku Analizi

Uyku veri yapısı, dışa aktarma ayarlarınızda veri toplama etkinleştirilip etkinleştirilmediğine bağlı olarak değişir.

Toplanmış Uyku Verileri

Toplama etkinleştirildiğinde, uyku verileri güne göre özetlenir:

{
  "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"
    }
  ]
}

Alanlar:

• totalSleep (Number): Toplam uyku süresi (saat cinsinden)
• asleep (Number): Herhangi bir uyku durumundaki toplam süre
• core (Number): Hafif uyku süresi (saat cinsinden)
• deep (Number): Derin uyku süresi (saat cinsinden)
• rem (Number): REM uyku süresi (saat cinsinden)
• sleepStart (Date): Uykunun gerçekten başladığı zaman
• sleepEnd (Date): Uykunun gerçekten bittiği zaman
• inBed (Number): Yatakta geçirilen toplam süre (saat cinsinden)
• inBedStart (Date): Yatağa girdiğiniz zaman
• inBedEnd (Date): Yataktan kalktığınız zaman

Toplanmamış Uyku Verileri

Toplama devre dışı bırakıldığında, bireysel uyku segmentleri dahil edilir:

{
  "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"
    }
  ]
}

Alanlar:

• startDate (Date): Uyku segmentinin başlangıç zamanı
• endDate (Date): Uyku segmentinin bitiş zamanı
• qty (Number): Segmentin süresi (saat cinsinden)
• value (String): Uyku durumu - şunlardan biri:
  • "Awake"
  • "Asleep" (kategorize edilmemiş uyku fazı)
  • "In Bed"
  • "Core"
  • "REM"
  • "Deep"
  • "Unspecified"

Not: "Asleep" kategorize edilmemiş bir uyku fazını ifade eder (toplam uyku süresi yerine). Bu, veri kaynağı uyku fazı takibini desteklemiyorsa ortaya çıkabilir.

Kan Şekeri

Kan şekeri okumaları öğün zamanlaması bilgilerini içerir:

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

Alanlar:

• qty (Number): Kan şekeri seviyesi
• mealTime (String): Şunlardan biri:
  • "Before Meal"
  • "After Meal"
  • "Unspecified"

Cinsel Aktivite

Cinsel aktivite girişleri korunma kullanımını takip eder:

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

Alanlar:

• Unspecified (Number): Korunma durumu bilinmediğinde sayım
• Protection Used (Number): Korunma kullanıldığında sayım
• Protection Not Used (Number): Korunma kullanılmadığında sayım

El Yıkama

El yıkama olayları tamamlanma durumunu takip eder:

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

Alanlar:

• qty (Number): El yıkama olaylarının sayısı
• value (String): Şunlardan biri:
  • "Complete"
  • "Incomplete"

Diş Fırçalama

Diş fırçalama olayları tamamlanma durumunu takip eder:

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

Alanlar:

• qty (Number): Diş fırçalama olaylarının sayısı
• value (String): Şunlardan biri:
  • "Complete"
  • "Incomplete"

İnsülin Uygulaması

İnsülin uygulama girişleri uygulama nedenini içerir:

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

Alanlar:

• qty (Number): Uygulanan insülin miktarı
• reason (String): Şunlardan biri:
  • "Bolus" (öğün insülini)
  • "Basal" (arka plan insülini)

Yaygın Sağlık Metrikleri

Bazı yaygın olarak dışa aktarılan sağlık metrikleri şunları içerir (tüm metrik adları snake_case formatındadır):

• step_count - Günlük adım sayıları
• walking_running_distance - Kat edilen mesafe
• active_energy - Aktivite yoluyla yakılan kaloriler
• resting_heart_rate - Dinlenme kalp atış hızı
• heart_rate - Kalp atış hızı ölçümleri
• respiratory_rate - Solunum hızı
• body_temperature - Vücut sıcaklığı okumaları
• blood_oxygen_saturation - SpO2 seviyeleri
• weight_&_body_mass - Vücut ağırlığı ölçümleri
• body_mass_index - Hesaplanan BMI değerleri
• height - Boy ölçümleri
• dietary_water - Sıvı tüketimi
• mindful_minutes - Meditasyon veya farkındalık zamanı

İpuçları

• Zaman Gruplandırma: Verilerin nasıl toplandığını kontrol etmek için dışa aktarma yapılandırmanızdaki zaman gruplandırma ayarlarını kullanın (saniye, dakika, saat, gün vb. ile)
• Veri Toplama: Daha kolay analiz için uyku ve diğer metrikleri güne göre özetlemek üzere veri toplamayı etkinleştirin
• Seçici Dışa Aktarma: Dosya boyutunu ve işleme süresini azaltmak için dışa aktarmanıza hangi belirli sağlık metriklerini dahil edeceğinizi seçebilirsiniz

İlgili Dokümantasyon

• JSON Dışa Aktarma Formatına Genel Bakış
• Manuel Dışa Aktarma Kılavuzu
• Otomasyonlara Genel Bakış