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

Yardım konularını ara

Antrenmanlar - JSON Dışa Aktarma Biçimi

JSON dışa aktarmalarında antrenmanlar yapısı için belgeler

Son güncelleme: 31 Ekim 2026

Bu sayfada
Dışa Aktarma Sürümleri
Antrenmanlar Sürüm 2 Antrenmanlar Sürüm 2 Temel yapıZorunlu alanlarİsteğe bağlı alanlarAntrenman Metrikleri Zaman Gruplaması
Antrenmanlar Sürüm 1 (Eski) Antrenmanlar Sürüm 1 (Eski) Sürüm 1 yapısı
İlgili belgeler

JSON dışa aktarmaları antrenmanları workouts dizisinde saklar.

Dışa Aktarma Sürümleri

Health Auto Export iki antrenman dışa aktarma sürümünü destekler:

  • Sürüm 2 (Önerilen): Daha ayrıntılı meta veri ve yapılandırılmış veri içeren gelişmiş biçim
  • Sürüm 1 (Eski): Mevcut iş akışlarıyla uyumluluk için korunan eski biçim

Antrenmanlar Sürüm 2

Sürüm 2 aşağıdaki zorunlu alanları ve isteğe bağlı veriyi içerir. Örnekler Birimleri Yerelleştir kapalıyken; açmak metrik serilerindeki birim etiketlerini değiştirebilir.

Temel yapı

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Running",
  "start": "2024-02-06 07:00:00 -0800",
  "end": "2024-02-06 07:30:00 -0800",
  "duration": 1800
}

Zorunlu alanlar

  • id (String): Antrenman için benzersiz tanımlayıcı
  • name (String): Antrenman türü adı (örn. "Running", "Cycling", "Swimming")
  • start (Date): yyyy-MM-dd HH:mm:ss Z biçiminde antrenman başlangıç zamanı
  • end (Date): yyyy-MM-dd HH:mm:ss Z biçiminde antrenman bitiş zamanı
  • duration (Number): Saniye cinsinden antrenman süresi

İsteğe bağlı alanlar

İsteğe bağlı alanlar kullanılabilir veriye ve dışa aktarma seçimlerinize bağlıdır:

Kayıt kaynağı

{
  "source": {
    "name": "Workout App",
    "identifier": "com.example.workouts"
  }
}
  • source (Object): Antrenmanı kaydeden uygulama veya cihaz; adı ve uygulama tanımlayıcısıyla. Bireysel metrik okumalarının ayrı kaynak dizeleri vardır ve başka bir uygulama veya cihazdan gelebilir.

Konum bilgisi

{
  "location": "Outdoor",
  "isIndoor": false
}
  • location (String): "Indoor", "Outdoor", "Pool", "Open Water" değerlerinden biri
  • isIndoor (Boolean): Antrenmanın kapalı alanda yapılıp yapılmadığı

Enerji ve yoğunluk

{
  "activeEnergyBurned": {
    "qty": 350,
    "units": "kcal"
  },
  "totalEnergy": {
    "qty": 450,
    "units": "kcal"
  },
  "intensity": {
    "qty": 8.5,
    "units": "kcal/hr\u00b7kg"
  }
}
  • activeEnergyBurned (Object): Antrenman sırasında yakılan aktif kaloriler
  • totalEnergy (Object): Yakılan toplam kalori (aktif + dinlenme)
  • intensity (Object): Metabolik eşdeğer görev (MET) değeri

Mesafe ve hız

{
  "distance": {
    "qty": 3.5,
    "units": "mi"
  }
}
  • distance (Object): Kat edilen toplam mesafe
  • speed (Object): Mesafe ve süreden hesaplanan ortalama hız
  • avgSpeed (Object): Antrenman boyunca ortalama hız
  • maxSpeed (Object): Ulaşılan maksimum hız

Her nesne qty ve units içerir.

Yükseklik

{
  "elevationUp": {
    "qty": 500,
    "units": "ft"
  },
  "elevationDown": {
    "qty": 450,
    "units": "ft"
  }
}
  • elevationUp (Object): Kazanılan toplam yükseklik
  • elevationDown (Object): Kaybedilen toplam yükseklik

Birimler: "ft" (feet) veya "m" (metre)

Çevresel veri

{
  "temperature": {
    "qty": 72,
    "units": "degF"
  },
  "humidity": {
    "qty": 65,
    "units": "%"
  }
}
  • temperature (Object): Antrenman sırasındaki ortam sıcaklığı
  • humidity (Object): Bağıl nem yüzdesi

Sıcaklık birimleri: "degF" (Fahrenheit) veya "degC" (Celsius)

Yüzmeye özgü alanlar

{
  "lapLength": {
    "qty": 0.025,
    "units": "mi"
  },
  "strokeStyle": "Freestyle",
  "swolfScore": 45,
  "salinity": "Fresh Water",
  "totalSwimmingStrokeCount": {
    "qty": 1200,
    "units": "count"
  },
  "swimCadence": {
    "qty": 30,
    "units": "count/min"
  }
}
  • lapLength (Object): Her turun uzunluğu
  • strokeStyle (String): Şunlardan biri:
    • "Backstroke"
    • "Breaststroke"
    • "Butterfly"
    • "Freestyle"
    • "Mixed"
    • "Kickboard"
    • "Unknown"
  • swolfScore (Number): Yüzme verimliliği puanı
  • salinity (String): "Fresh Water" veya "Salt Water"
  • totalSwimmingStrokeCount (Object): Toplam kulaç sayısı
  • swimCadence (Object): Dakikadaki kulaç

Adım ve kadans verisi

{
  "stepCount": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 5000,
      "units": "count",
      "source": "Apple Watch"
    }
  ],
  "stepCadence": {
    "qty": 180,
    "units": "count/min"
  },
  "flightsClimbed": {
    "qty": 10,
    "units": "count"
  }
}
  • stepCount (Array): Zaman içindeki adım sayısı ölçümleri dizisi
  • stepCadence (Object): Dakikadaki adım
  • flightsClimbed (Object): Çıkılan merdiven katı sayısı

Kalp atış hızı verisi

{
  "heartRate": {
    "min": {
      "qty": 120,
      "units": "count/min"
    },
    "avg": {
      "qty": 150,
      "units": "count/min"
    },
    "max": {
      "qty": 175,
      "units": "count/min"
    }
  },
  "maxHeartRate": {
    "qty": 175,
    "units": "count/min"
  },
  "avgHeartRate": {
    "qty": 150,
    "units": "count/min"
  },
  "heartRateData": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "Min": 120,
      "Avg": 150,
      "Max": 175,
      "units": "count/min",
      "source": "Apple Watch"
    }
  ],
  "heartRateRecovery": [
    {
      "date": "2024-02-06 07:30:00 -0800",
      "Min": 140,
      "Avg": 145,
      "Max": 150,
      "units": "count/min",
      "source": "Apple Watch"
    }
  ]
}
  • heartRate (Object): Antrenman sırasında min, ort. ve maks kalp atış hızı özeti
  • maxHeartRate (Object): Antrenman sırasındaki maksimum kalp atış hızı
  • avgHeartRate (Object): Antrenman sırasındaki ortalama kalp atış hızı
  • heartRateData (Array): Antrenmandan ayrıntılı ölçümler; antrenman bittiğinde biter
  • heartRateRecovery (Array): Antrenman bittikten hemen sonraki iki dakikadan ayrı ölçümler

Özet kalp atış hızları kullanılabilir olduğunda kaydedilmiş antrenman değerlerini kullanır; aksi halde antrenmanın kalp atış hızı okumalarına düşer. Dışa aktarılan okumalar duraklamalar sırasında alınan ölçümleri içerir; bu nedenle tepe ve ortalamaları özetten farklı olabilir.

Zaman serisi veri dizileri

"Antrenman Metriklerini Dahil Et" etkinleştirildiğinde birçok metrik zaman serisi dizileri olarak dahil edilebilir:

{
  "activeEnergy": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 50,
      "units": "kcal",
      "source": "Apple Watch"
    }
  ],
  "basalEnergy": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 20,
      "units": "kcal",
      "source": "Apple Watch"
    }
  ],
  "cyclingCadence": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 90,
      "units": "count/min",
      "source": "Apple Watch"
    }
  ],
  "cyclingDistance": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 0.5,
      "units": "mi",
      "source": "Apple Watch"
    }
  ],
  "cyclingPower": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 200,
      "units": "W",
      "source": "Power Meter"
    }
  ],
  "cyclingSpeed": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 18,
      "units": "mi/hr",
      "source": "Apple Watch"
    }
  ],
  "swimDistance": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 25,
      "units": "yd",
      "source": "Apple Watch"
    }
  ],
  "swimStroke": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 20,
      "units": "count",
      "source": "Apple Watch"
    }
  ],
  "walkingAndRunningDistance": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 0.25,
      "units": "mi",
      "source": "Apple Watch"
    }
  ]
}

QuantityData yapısı:

  • date (Date): Ölçümün zaman damgası
  • qty (Number): Miktar değeri
  • units (String): Ölçüm birimi
  • source (String, isteğe bağlı): Veri kaynağı cihaz veya uygulama

HeartRateData yapısı:

  • date (Date): Ölçümün zaman damgası
  • Min (Number): Minimum kalp atış hızı
  • Avg (Number): Ortalama kalp atış hızı
  • Max (Number): Maksimum kalp atış hızı
  • units (String): Birim (Birimleri Yerelleştir kapalıyken count/min)
  • source (String, isteğe bağlı): Veri kaynağı cihaz veya uygulama

Rota verisi

"Rota Verisini Dahil Et" etkinleştirildiğinde ve antrenmanın GPS verisi olduğunda:

{
  "route": [
    {
      "latitude": 37.7749,
      "longitude": -122.4194,
      "altitude": 50.5,
      "course": 45.0,
      "courseAccuracy": 5.0,
      "horizontalAccuracy": 10.0,
      "verticalAccuracy": 15.0,
      "timestamp": "2024-02-06 07:00:00 -0800",
      "speed": 7.0,
      "speedAccuracy": 0.5
    }
  ]
}

Konum alanları:

  • latitude (Number): GPS enlem koordinatı
  • longitude (Number): GPS boylam koordinatı
  • altitude (Number): Metre cinsinden yükseklik
  • course (Number): Derece cinsinden hareket yönü (0-360)
  • courseAccuracy (Number): Derece cinsinden yön ölçümü doğruluğu
  • horizontalAccuracy (Number): Metre cinsinden yatay konum doğruluğu
  • verticalAccuracy (Number): Metre cinsinden dikey konum doğruluğu
  • timestamp (Date): Konumun kaydedildiği zaman
  • speed (Number): Metre/saniye cinsinden hız
  • speedAccuracy (Number): m/s cinsinden hız ölçümü doğruluğu

Meta veri

{
  "metadata": {
    "customField": {
      "label": "value",
      "quantity": 123
    },
    "anotherField": [
      1,
      2,
      3
    ]
  }
}
  • metadata (Object): Antrenmanla ilişkili ek özel meta veri

Olaylar, etkinlikler ve parçalar

Sürüm 2 JSON ve Markdown dışa aktarmaları antrenman uygulamasının kaydettiği events, segments, laps ve activities öğelerini içerebilir. Bunlar Antrenman Metriklerini Dahil Et kapalıyken de kullanılabilir. CSV ve GPX bu kayıtları içermez.

Antrenman Metriklerini Dahil Et açıkken ve ilgili metrikler seçildiğinde aralıklar mesafe, aktif enerji, kalp atış hızı özetleri ve aktif süre temposu veya hızını da içerebilir. Değerler kaydedilmiş ölçümleri tahminlerden ayırır; kullanılamayan değerler atlanır.

Mesafe seçildiğinde splits tahmini kilometre ve mil parçalarını içerebilir. Kayıt uygulamasının parçalarından farklı olabilirler ve son parça hedef mesafeden kısaysa kısmi olarak işaretlenir. Eksik mesafe okumaları veya desteklenmeyen antrenman türleri parça hesaplamasını engelleyebilir.

Antrenman efor puanları

Sürüm 2 JSON ve Markdown dışa aktarmaları seçili Antrenman Efor Puanı (effortScore) ve Tahmini Antrenman Efor Puanı (estimatedEffortScore) değerlerini içerebilir. Her biri qty ve units: "appleEffortScore" içeren bir nesnedir.

Puanlar iOS 18 veya sonrası ve Apple Health’te ilgili veriye erişim gerektirir. Tüm-antrenman ve etkinlik puanları ayrıdır. Zaman Gruplaması ve Antrenman Metriklerini Dahil Et’ten bağımsızdır; CSV bunları içermez.

Göz At → Antrenmanlar’da listenin dışa aktarma sayfasını veya bir antrenmanın Sürüm 2 dışa aktarma ayarlarını açın, ardından dışa aktarmadan önce efor puanlarını seçmek için Dışa Aktarma Alanlarını Seç’i kullanın.

Antrenman Metrikleri Zaman Gruplaması

Dışa Aktarma Sürümü 2 kullanılırken ve "Antrenman Metriklerini Dahil Et" etkinleştirildiğinde zaman serisi verisinin ayrıntı düzeyini kontrol edebilirsiniz:

  • Dakikalar: Antrenman metriklerini saat dakikalarına göre gruplar. İlk ve son dakika, antrenman başlamadan hemen önce veya bittikten hemen sonra birkaç saniye içerebilir.
  • Saniyeler: Antrenman metriklerini saat saniyelerine göre gruplar; her zaman damgası saniyesinin başlangıcını işaretler. İlk ve son saniye, antrenmanın hemen dışındaki saniye kesrini içerebilir. Dosyalar dakika gruplamasından daha büyüktür.

Aktif ve dinlenme enerjisi her zaman grubunda diğer antrenman metrikleriyle aynı birleşik toplamları kullanır. Birden fazla cihaz veya uygulamadan okumalar birlikte dahil edilir.

Antrenmanlar Sürüm 1 (Eski)

Sürüm 1 daha basit bir yapı kullanır. Yeni dışa aktarmalar için Sürüm 2 önerilir.

Sürüm 1 yapısı

{
  "name": "Running",
  "start": "2024-02-06 07:00:00 -0800",
  "end": "2024-02-06 07:30:00 -0800",
  "totalEnergy": {
    "qty": 450,
    "units": "kcal"
  },
  "activeEnergy": {
    "qty": 350,
    "units": "kcal"
  },
  "distance": {
    "qty": 3.5,
    "units": "mi"
  },
  "heartRateData": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 150,
      "units": "bpm"
    }
  ],
  "route": [
    {
      "lat": 37.7749,
      "lon": -122.4194,
      "altitude": 50.5,
      "timestamp": "2024-02-06 07:00:00 -0800"
    }
  ]
}

İlgili belgeler