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
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 Zbiçiminde antrenman başlangıç zamanıend(Date):yyyy-MM-dd HH:mm:ss Zbiç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 biriisIndoor(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 kalorilertotalEnergy(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 mesafespeed(Object): Mesafe ve süreden hesaplanan ortalama hızavgSpeed(Object): Antrenman boyunca ortalama hızmaxSpeed(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ükseklikelevationDown(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ğustrokeStyle(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 dizisistepCadence(Object): Dakikadaki adımflightsClimbed(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ı özetimaxHeartRate(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 biterheartRateRecovery(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ğeriunits(String): Ölçüm birimisource(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ıykencount/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ükseklikcourse(Number): Derece cinsinden hareket yönü (0-360)courseAccuracy(Number): Derece cinsinden yön ölçümü doğruluğuhorizontalAccuracy(Number): Metre cinsinden yatay konum doğruluğuverticalAccuracy(Number): Metre cinsinden dikey konum doğruluğutimestamp(Date): Konumun kaydedildiği zamanspeed(Number): Metre/saniye cinsinden hızspeedAccuracy(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"
}
]
}