Sledovanie cyklu – formát exportu JSON

Dokumentácia štruktúry sledovania cyklu v JSON exportoch

Last updated: April 5, 2026

Na tejto stránke

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ď je true.

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 metrics array 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 isCycleStart to identify the beginning of each cycle for analysis

Súvisiaca dokumentácia