Sledovanie cyklu – formát exportu JSON
Dokumentácia štruktúry sledovania cyklu v JSON exportoch
Last updated: April 5, 2026
Na tejto stránke
- Štruktúra
- Polia
- Povinné polia
- Voliteľné polia
- Typy sledovania cyklu
- Menštruačný tok
- Kvalita hlienu krčka maternice
- Bazálna telesná teplota
- Výsledok ovulačného testu
- Výsledok progesterónového testu
- Tehotenský test
- Sexuálna aktivita
- Tehotenstvo
- Lactation
- Antikoncepcia
- Nepravidelnosti cyklu
- Example: Complete Cycle Entry
- Prípady použitia
- Súvisiace údaje
- Tipy
- Súvisiaca dokumentácia
Sledovanie cyklu
Údaje zahŕňajú informácie o menštruačnom cykle z Apple Health: menštruačný tok, kvalitu hlienu krčka maternice, bazálnu telesnú teplotu, výsledky ovulačných testov a ďalšie súvisiace záznamy. V JSON exportoch sú v poli cycleTracking.
Štruktúra
Každý záznam sledovania cyklu má konzistentnú štruktúru:
{
"start": "2024-02-01 00:00:00 -0800",
"end": "2024-02-05 23:59:59 -0800",
"name": "Menstrual Flow",
"value": "Medium",
"isCycleStart": true
}
Polia
Povinné polia
start(String): Začiatok záznamu (yyyy-MM-dd HH:mm:ss Z)end(String): Koniec záznamu (yyyy-MM-dd HH:mm:ss Z)name(String): Typ údaju o cykle (pozri typy nižšie)value(String): Hodnota alebo výsledok (závisí od typu)
Voliteľné polia
isCycleStart(Boolean): Či záznam označuje začiatok nového cyklu. Len pri menštruačnom toku, keď jetrue.
Typy sledovania cyklu
Menštruačný tok
Sleduje krvácanie a úroveň toku; isCycleStart označuje začiatok cyklu.
{
"start": "2024-02-01 00:00:00 -0800",
"end": "2024-02-05 23:59:59 -0800",
"name": "Menstrual Flow",
"value": "Medium",
"isCycleStart": true
}
Possible Values:
"None""Light""Medium""Heavy""Unspecified"
Poznámka: isCycleStart je uvedené len pri hodnote true.
Kvalita hlienu krčka maternice
Sleduje kvalitu hlienu ako indikátor fertility.
{
"start": "2024-02-10 00:00:00 -0800",
"end": "2024-02-10 23:59:59 -0800",
"name": "Cervical Mucus Quality",
"value": "Egg White"
}
Possible Values:
"Egg White"- Clear, stretchy mucus (most fertile)"Watery"- Thin, watery mucus"Creamy"- Thick, creamy mucus"Sticky"- Sticky, tacky mucus"Dry"- Little to no mucus
Bazálna telesná teplota
Merania BBT sú v exporte ako zdravotné metriky v poli metrics, nie ako záznamy cyklu. Hľadajte „Basal Body Temperature“.
Výsledok ovulačného testu
Záznamy z ovulačných testov.
{
"start": "2024-02-12 08:00:00 -0800",
"end": "2024-02-12 08:00:00 -0800",
"name": "Ovulation Test Result",
"value": "Positive/Peak"
}
Possible Values:
"Positive/Peak"- Peak fertility detected"High"- High fertility level"Negative/Low"- Low fertility level"Indeterminate"- Test result unclear
Výsledok progesterónového testu
Záznamy z progesterónových testov.
{
"start": "2024-02-15 08:00:00 -0800",
"end": "2024-02-15 08:00:00 -0800",
"name": "Progesterone Test Result",
"value": "Positive"
}
Tehotenský test
Records results from pregnancy tests.
{
"start": "2024-02-20 08:00:00 -0800",
"end": "2024-02-20 08:00:00 -0800",
"name": "Pregnancy Test Result",
"value": "Positive"
}
Sexuálna aktivita
Tracks sexual activity within the cycle tracking context.
{
"start": "2024-02-14 20:00:00 -0800",
"end": "2024-02-14 20:00:00 -0800",
"name": "Sexual Activity",
"value": ""
}
Note: Sexual activity may also appear in health metrics with protection usage details.
Tehotenstvo
Tracks pregnancy periods.
{
"start": "2024-03-01 00:00:00 -0800",
"end": "2024-11-15 23:59:59 -0800",
"name": "Pregnancy",
"value": ""
}
Lactation
Tracks lactation periods.
{
"start": "2024-11-20 00:00:00 -0800",
"end": "2025-02-20 23:59:59 -0800",
"name": "Lactation",
"value": ""
}
Antikoncepcia
Tracks contraceptive use periods.
{
"start": "2024-01-01 00:00:00 -0800",
"end": null,
"name": "Contraceptive",
"value": ""
}
Nepravidelnosti cyklu
Nasledujúce typy sledujú rôzne nepravidelnosti cyklu:
Infrequent Menstrual Cycle
{
"start": "2024-02-01 00:00:00 -0800",
"end": "2024-02-01 23:59:59 -0800",
"name": "Infrequent Menstrual Cycle",
"value": ""
}
Irregular Menstrual Cycle
{
"start": "2024-02-01 00:00:00 -0800",
"end": "2024-02-01 23:59:59 -0800",
"name": "Irregular Menstrual Cycle",
"value": ""
}
Intermenstrual Bleeding
Bleeding that occurs between periods.
{
"start": "2024-02-15 00:00:00 -0800",
"end": "2024-02-15 23:59:59 -0800",
"name": "Intermenstrual Bleeding",
"value": ""
}
Persistent Menstrual Bleeding
Extended or persistent bleeding.
{
"start": "2024-02-01 00:00:00 -0800",
"end": "2024-02-10 23:59:59 -0800",
"name": "Persistent Menstrual Bleeding",
"value": ""
}
Prolonged Menstrual Period
Periods that last longer than usual.
{
"start": "2024-02-01 00:00:00 -0800",
"end": "2024-02-08 23:59:59 -0800",
"name": "Prolonged Menstrual Period",
"value": ""
}
Example: Complete Cycle Entry
[
{
"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": ""
}
]
Prípady použitia
Cycle tracking data can be useful for:
- Fertility tracking: Monitor ovulation and identify fertile windows
- Cycle analysis: Track cycle length, regularity, and patterns
- Health monitoring: Identify irregularities or changes in cycle patterns
- Pregnancy planning: Use data for conception planning
- Healthcare provider sharing: Share cycle data with gynecologists or fertility specialists
- Symptom correlation: Cross-reference cycle data with other health metrics
Súvisiace údaje
Some cycle-related data may appear in other sections:
- Basal Body Temperature: Found in the
metricsarray as a health metric - Sexual Activity: May also appear in health metrics with protection usage details
Tipy
- Consistent logging: Regular logging provides more accurate cycle predictions
- Combine data types: Using multiple tracking methods (flow, mucus, temperature, tests) provides the most comprehensive picture
- Cycle start markers: Use
isCycleStartto identify the beginning of each cycle for analysis
Súvisiaca dokumentácia
- Prehľad formátu exportu JSON
- Zdravotné metriky — bazálna telesná teplota a súvisiace údaje
- Príručka manuálneho exportu
- Prehľad automatizácií