Penjejakan kitaran — format eksport JSON
Dokumentasi untuk struktur penjejakan kitaran dalam eksport JSON
Last updated: April 5, 2026
Pada halaman ini
- Struktur
- Medan
- Medan wajib
- Medan pilihan
- Jenis penjejakan kitaran
- Aliran haid
- Kualiti mukus serviks
- Suhu badan basal
- Keputusan ujian ovulasi
- Keputusan ujian progesteron
- Keputusan ujian kehamilan
- Aktiviti seksual
- Kehamilan
- Menyusu
- Kontraseptif
- Ketidakteraturan kitaran
- Contoh: entri kitaran lengkap
- Kes penggunaan
- Data berkaitan
- Petua
- Dokumentasi berkaitan
Penjejakan kitaran
Data Penjejakan kitaran merangkumi semua maklumat berkaitan kitaran haid yang direkodkan dalam Apple Health, seperti aliran haid, kualiti mukus serviks, suhu badan basal, keputusan ujian ovulasi dan data berkaitan kitaran lain. Dalam eksport JSON, data penjejakan kitaran disimpan dalam tatasusunan cycleTracking.
Struktur
Setiap entri penjejakan kitaran mengikut struktur konsisten:
{
"start": "2024-02-01 00:00:00 -0800",
"end": "2024-02-05 23:59:59 -0800",
"name": "Menstrual Flow",
"value": "Medium",
"isCycleStart": true
}
Medan
Medan wajib
start(Rentetan): Tarikh dan masa mula entri dalam formatyyyy-MM-dd HH:mm:ss Zend(Rentetan): Tarikh dan masa tamat entri dalam formatyyyy-MM-dd HH:mm:ss Zname(Rentetan): Jenis data penjejakan kitaran (lihat jenis di bawah)value(Rentetan): Nilai atau keputusan untuk entri ini (berbeza mengikut jenis)
Medan pilihan
isCycleStart(Boolean): Menunjukkan jika entri ini menandakan permulaan kitaran haid baharu. Hanya hadir untuk entri Aliran haid apabilatrue.
Jenis penjejakan kitaran
Aliran haid
Menjejak pendarahan haid dengan tahap aliran dan maklumat permulaan kitaran.
{
"start": "2024-02-01 00:00:00 -0800",
"end": "2024-02-05 23:59:59 -0800",
"name": "Menstrual Flow",
"value": "Medium",
"isCycleStart": true
}
Nilai mungkin:
"None""Light""Medium""Heavy""Unspecified"
Nota: isCycleStart hanya disertakan apabila true, menunjukkan permulaan kitaran haid baharu.
Kualiti mukus serviks
Menjejak kualiti mukus serviks, yang boleh menunjukkan status kesuburan.
{
"start": "2024-02-10 00:00:00 -0800",
"end": "2024-02-10 23:59:59 -0800",
"name": "Cervical Mucus Quality",
"value": "Egg White"
}
Nilai mungkin:
"Egg White"— Mukus jernih, regang (paling subur)"Watery"— Mukus nipis, berair"Creamy"— Mukus pekat, berkrim"Sticky"— Mukus melekit"Dry"— Sedikit atau tiada mukus
Suhu badan basal
Ukuran suhu badan basal (BBT) dieksport sebagai metrik kesihatan, bukan entri penjejakan kitaran. Cari "Basal Body Temperature" dalam tatasusunan metrics.
Keputusan ujian ovulasi
Merekod keputusan daripada ujian ramalan ovulasi.
{
"start": "2024-02-12 08:00:00 -0800",
"end": "2024-02-12 08:00:00 -0800",
"name": "Ovulation Test Result",
"value": "Positive/Peak"
}
Nilai mungkin:
"Positive/Peak"— Kesuburan puncak dikesan"High"— Tahap kesuburan tinggi"Negative/Low"— Tahap kesuburan rendah"Indeterminate"— Keputusan ujian tidak jelas
Keputusan ujian progesteron
Merekod keputusan daripada ujian progesteron.
{
"start": "2024-02-15 08:00:00 -0800",
"end": "2024-02-15 08:00:00 -0800",
"name": "Progesterone Test Result",
"value": "Positive"
}
Keputusan ujian kehamilan
Merekod keputusan daripada ujian kehamilan.
{
"start": "2024-02-20 08:00:00 -0800",
"end": "2024-02-20 08:00:00 -0800",
"name": "Pregnancy Test Result",
"value": "Positive"
}
Aktiviti seksual
Menjejak aktiviti seksual dalam konteks penjejakan kitaran.
{
"start": "2024-02-14 20:00:00 -0800",
"end": "2024-02-14 20:00:00 -0800",
"name": "Sexual Activity",
"value": ""
}
Nota: Aktiviti seksual juga mungkin muncul dalam metrik kesihatan dengan butiran penggunaan perlindungan.
Kehamilan
Menjejak tempoh kehamilan.
{
"start": "2024-03-01 00:00:00 -0800",
"end": "2024-11-15 23:59:59 -0800",
"name": "Pregnancy",
"value": ""
}
Menyusu
Menjejak tempoh menyusu.
{
"start": "2024-11-20 00:00:00 -0800",
"end": "2025-02-20 23:59:59 -0800",
"name": "Lactation",
"value": ""
}
Kontraseptif
Menjejak tempoh penggunaan kontraseptif.
{
"start": "2024-01-01 00:00:00 -0800",
"end": null,
"name": "Contraceptive",
"value": ""
}
Ketidakteraturan kitaran
Jenis berikut menjejak pelbagai ketidakteraturan kitaran:
Kitaran haid tidak kerap
{
"start": "2024-02-01 00:00:00 -0800",
"end": "2024-02-01 23:59:59 -0800",
"name": "Infrequent Menstrual Cycle",
"value": ""
}
Kitaran haid tidak teratur
{
"start": "2024-02-01 00:00:00 -0800",
"end": "2024-02-01 23:59:59 -0800",
"name": "Irregular Menstrual Cycle",
"value": ""
}
Pendarahan antara haid
Pendarahan yang berlaku antara tempoh.
{
"start": "2024-02-15 00:00:00 -0800",
"end": "2024-02-15 23:59:59 -0800",
"name": "Intermenstrual Bleeding",
"value": ""
}
Pendarahan haid berterusan
Pendarahan lanjutan atau berterusan.
{
"start": "2024-02-01 00:00:00 -0800",
"end": "2024-02-10 23:59:59 -0800",
"name": "Persistent Menstrual Bleeding",
"value": ""
}
Tempoh haid berpanjangan
Tempoh yang berlangsung lebih lama daripada biasa.
{
"start": "2024-02-01 00:00:00 -0800",
"end": "2024-02-08 23:59:59 -0800",
"name": "Prolonged Menstrual Period",
"value": ""
}
Contoh: entri kitaran lengkap
[
{
"start": "2024-02-01 00:00:00 -0800",
"end": "2024-02-05 23:59:59 -0800",
"name": "Menstrual Flow",
"value": "Medium",
"isCycleStart": true
},
{
"start": "2024-02-10 00:00:00 -0800",
"end": "2024-02-10 23:59:59 -0800",
"name": "Cervical Mucus Quality",
"value": "Egg White"
},
{
"start": "2024-02-12 08:00:00 -0800",
"end": "2024-02-12 08:00:00 -0800",
"name": "Ovulation Test Result",
"value": "Positive/Peak"
},
{
"start": "2024-02-14 20:00:00 -0800",
"end": "2024-02-14 20:00:00 -0800",
"name": "Sexual Activity",
"value": ""
}
]
Kes penggunaan
Data penjejakan kitaran berguna untuk:
- Penjejakan kesuburan: Pantau ovulasi dan kenal pasti tingkap subur
- Analisis kitaran: Jejak panjang kitaran, keteraturan dan corak
- Pemantauan kesihatan: Kenal pasti ketidakteraturan atau perubahan dalam corak kitaran
- Perancangan kehamilan: Gunakan data untuk perancangan konsepsi
- Perkongsian penyedia penjagaan: Kongsi data kitaran dengan doktor ginekologi atau pakar kesuburan
- Korelasi gejala: Rujuk silang data kitaran dengan metrik kesihatan lain
Data berkaitan
Sesetengah data berkaitan kitaran mungkin muncul dalam bahagian lain:
- Suhu badan basal: Terdapat dalam tatasusunan
metricssebagai metrik kesihatan - Aktiviti seksual: Juga mungkin muncul dalam metrik kesihatan dengan butiran penggunaan perlindungan
Petua
- Log konsisten: Log berkala menyediakan ramalan kitaran lebih tepat
- Gabungkan jenis data: Menggunakan berbilang kaedah penjejakan (aliran, mukus, suhu, ujian) memberikan gambaran paling menyeluruh
- Penanda permulaan kitaran: Gunakan
isCycleStartuntuk mengenal pasti permulaan setiap kitaran untuk analisis
Dokumentasi berkaitan
- Gambaran keseluruhan format eksport JSON
- Metrik kesihatan — Untuk data suhu badan basal
- Panduan Eksport manual
- Gambaran keseluruhan Automasi