Sledování cyklu - formát exportu JSON

Dokumentace ke struktuře sledování cyklu v exportech JSON.

Last updated: February 6, 2026

Na této stránce

Sledování cyklu

Data sledování cyklu zahrnují všechny informace související s menstruačním cyklem zaznamenané v Apple Health, například menstruační tok, kvalitu hlenů děložního čípku, bazální tělesnou teplotu, výsledky ovulačních testů a další údaje o cyklu. V JSON exportech jsou uložena v poli cycleTracking.

Struktura

Každý záznam sledování cyklu má konzistentní strukturu:

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-05 23:59:59 -0800",
  "name": "Menstrual Flow",
  "value": "Medium",
  "isCycleStart": true
}

Pole

Povinná pole

  • start (String): Datum a čas začátku záznamu ve formátu yyyy-MM-dd HH:mm:ss Z
  • end (String): Datum a čas konce záznamu ve formátu yyyy-MM-dd HH:mm:ss Z
  • name (String): Typ dat sledování cyklu (viz typy níže)
  • value (String): Hodnota nebo výsledek tohoto záznamu (liší se podle typu)

Volitelná pole

  • isCycleStart (Boolean): Zda tento záznam označuje začátek nového menstruačního cyklu. U záznamů Menstrual Flow je přítomno pouze při hodnotě true.

Typy sledování cyklu

Menstrual Flow (menstruační krvácení)

Sleduje menstruační krvácení s úrovní toku a informací o začátku cyklu.

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-05 23:59:59 -0800",
  "name": "Menstrual Flow",
  "value": "Medium",
  "isCycleStart": true
}

Možné hodnoty:

  • "None"
  • "Light"
  • "Medium"
  • "Heavy"
  • "Unspecified"

Poznámka: isCycleStart je zahrnuto pouze při hodnotě true a označuje začátek nového menstruačního cyklu.

Cervical Mucus Quality (kvalita hlenu děložního čípku)

Sleduje kvalitu hlenu děložního čípku, která může naznačovat plodnost.

{
  "start": "2024-02-10 00:00:00 -0800",
  "end": "2024-02-10 23:59:59 -0800",
  "name": "Cervical Mucus Quality",
  "value": "Egg White"
}

Možné hodnoty:

  • "Egg White" – čirý, pružný hlen (nejvyšší plodnost)
  • "Watery" – řídký vodnatý hlen
  • "Creamy" – hustý krémový hlen
  • "Sticky" – lepkavý hlen
  • "Dry" – málo nebo žádný hlen

Bazální tělesná teplota

Měření bazální tělesné teploty (BBT) se exportují jako zdravotní metriky, nikoli jako záznamy sledování cyklu. Hledejte „Basal Body Temperature“ v poli metrics.

Ovulation Test Result (výsledek ovulačního testu)

Zaznamenává výsledky testů predikce ovulace.

{
  "start": "2024-02-12 08:00:00 -0800",
  "end": "2024-02-12 08:00:00 -0800",
  "name": "Ovulation Test Result",
  "value": "Positive/Peak"
}

Možné hodnoty:

  • "Positive/Peak" – zjištěna špičková plodnost
  • "High" – vysoká úroveň plodnosti
  • "Negative/Low" – nízká úroveň plodnosti
  • "Indeterminate" – nejasný výsledek testu

Progesterone Test Result (výsledek progesteronového testu)

Zaznamenává výsledky progesteronových testů.

{
  "start": "2024-02-15 08:00:00 -0800",
  "end": "2024-02-15 08:00:00 -0800",
  "name": "Progesterone Test Result",
  "value": "Positive"
}

Pregnancy Test Result (výsledek těhotenského testu)

Zaznamenává výsledky těhotenských testů.

{
  "start": "2024-02-20 08:00:00 -0800",
  "end": "2024-02-20 08:00:00 -0800",
  "name": "Pregnancy Test Result",
  "value": "Positive"
}

Sexual Activity (sexuální aktivita)

Sleduje sexuální aktivitu v kontextu sledování cyklu.

{
  "start": "2024-02-14 20:00:00 -0800",
  "end": "2024-02-14 20:00:00 -0800",
  "name": "Sexual Activity",
  "value": ""
}

Poznámka: Sexuální aktivita se může objevit také ve zdravotních metrikách s podrobnostmi o použití ochrany.

Pregnancy (těhotenství)

Sleduje období těhotenství.

{
  "start": "2024-03-01 00:00:00 -0800",
  "end": "2024-11-15 23:59:59 -0800",
  "name": "Pregnancy",
  "value": ""
}

Lactation (laktace)

Sleduje období laktace.

{
  "start": "2024-11-20 00:00:00 -0800",
  "end": "2025-02-20 23:59:59 -0800",
  "name": "Lactation",
  "value": ""
}

Contraceptive (antikoncepce)

Sleduje období používání antikoncepce.

{
  "start": "2024-01-01 00:00:00 -0800",
  "end": null,
  "name": "Contraceptive",
  "value": ""
}

Nepravidelnosti cyklu

Následující typy sledují různé nepravidelnosti cyklu:

Infrequent Menstrual Cycle (vzácný menstruační cyklus)

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-01 23:59:59 -0800",
  "name": "Infrequent Menstrual Cycle",
  "value": ""
}

Irregular Menstrual Cycle (nepravidelný menstruační cyklus)

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-01 23:59:59 -0800",
  "name": "Irregular Menstrual Cycle",
  "value": ""
}

Intermenstrual Bleeding (meziomenstruační krvácení)

Krvácení mezi menstruacemi.

{
  "start": "2024-02-15 00:00:00 -0800",
  "end": "2024-02-15 23:59:59 -0800",
  "name": "Intermenstrual Bleeding",
  "value": ""
}

Persistent Menstrual Bleeding (přetrvávající menstruační krvácení)

Prodloužené nebo přetrvávající krvácení.

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-10 23:59:59 -0800",
  "name": "Persistent Menstrual Bleeding",
  "value": ""
}

Prolonged Menstrual Period (prodloužená menstruace)

Menstruace trvající déle než obvykle.

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-08 23:59:59 -0800",
  "name": "Prolonged Menstrual Period",
  "value": ""
}

Příklad: kompletní záznam cyklu

[
  {
    "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": ""
  }
]

Případy použití

Data sledování cyklu mohou být užitečná pro:

  • Sledování plodnosti: monitorování ovulace a plodných oken
  • Analýzu cyklu: délka, pravidelnost a vzorce cyklu
  • Sledování zdraví: odhalení nepravidelností nebo změn ve vzorcích cyklu
  • Plánování těhotenství: data pro plánování početí
  • Sdílení s poskytovateli: sdílení dat s gynekology nebo specialisty na plodnost
  • Korelaci s příznaky: porovnání dat cyklu s dalšími metrikami

Související data

Některá data související s cyklem se mohou objevit v jiných částech:

  • Bazální tělesná teplota: v poli metrics jako zdravotní metrika
  • Sexuální aktivita: může být také ve zdravotních metrikách s podrobnostmi o ochraně

Tipy

  • Pravidelné zaznamenávání: častější záznamy poskytují přesnější predikce cyklu
  • Kombinujte typy dat: více metod (tok, hlen, teplota, testy) dává nejúplnější obraz
  • Značky začátku cyklu: používejte isCycleStart k identifikaci začátku každého cyklu pro analýzu

Související dokumentace