Відстеження циклу

Дані Cycle Tracking містять усю інформацію, пов’язану з менструальним циклом, записану в Apple Health: менструальні виділення, якість цервікального слизу, базальну температуру тіла, результати тестів на овуляцію та інші дані про цикл. У JSON-експортах дані відстеження циклу зберігаються в масиві cycleTracking.

Структура

Кожен запис відстеження циклу має узгоджену структуру:

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

Поля

Обов’язкові поля

• start (String): дата й час початку запису у форматі yyyy-MM-dd HH:mm:ss Z
• end (String): дата й час завершення запису у форматі yyyy-MM-dd HH:mm:ss Z
• name (String): тип даних відстеження циклу (див. типи нижче)
• value (String): значення або результат для цього запису (залежить від типу)

Необов’язкові поля

• isCycleStart (Boolean): чи позначає цей запис початок нового менструального циклу. Присутній лише для записів Menstrual Flow, коли значення true.

Типи відстеження циклу

Menstrual Flow

Відстежує менструальну кровотечу з рівнем інтенсивності та інформацією про початок циклу.

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

Можливі значення:

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

Примітка: поле isCycleStart додається лише коли воно true і позначає початок нового менструального циклу.

Cervical Mucus Quality

Відстежує якість цервікального слизу, яка може вказувати на фертильність.

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

Можливі значення:

• "Egg White" — прозорий, розтягний слиз (найвища фертильність)
• "Watery" — тонкий, водянистий слиз
• "Creamy" — густий кремоподібний слиз
• "Sticky" — липкий, в’язкий слиз
• "Dry" — мало слизу або немає

Basal Body Temperature

Вимірювання базальної температури тіла (BBT) експортуються як показники здоров’я, а не як записи відстеження циклу. Шукайте «Basal Body Temperature» у масиві metrics.

Ovulation Test Result

Фіксує результати тестів на передбачення овуляції.

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

Можливі значення:

• "Positive/Peak" — виявлено пік фертильності
• "High" — високий рівень фертильності
• "Negative/Low" — низький рівень фертильності
• "Indeterminate" — неоднозначний результат тесту

Progesterone Test Result

Фіксує результати тестів на прогестерон.

{
  "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

Фіксує результати тестів на вагітність.

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

Sexual Activity

Відстежує статеві контакти в контексті відстеження циклу.

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

Примітка: дані про статеві контакти можуть також з’являтися серед показників здоров’я з інформацією про використання захисту.

Pregnancy

Відстежує періоди вагітності.

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

Lactation

Відстежує періоди лактації.

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

Contraceptive

Відстежує періоди використання контрацепції.

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

Порушення циклу

Нижче наведені типи, що відстежують різні порушення циклу:

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

Кровотеча між менструаціями.

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

Persistent Menstrual 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

Менструації, що тривають довше за звичайне.

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

Приклад: повний запис циклу

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

Сценарії використання

Дані відстеження циклу можуть бути корисні для:

• Відстеження фертильності: моніторинг овуляції та визначення фертильних вікон
• Аналізу циклу: відстеження тривалості, регулярності та закономірностей циклу
• Моніторингу здоров’я: виявлення порушень або змін у патернах циклу
• Планування вагітності: використання даних для планування зачаття
• Надання лікарю: обмін даними про цикл із гінекологами чи фахівцями з репродукції
• Кореляції з симптомами: зіставлення даних циклу з іншими показниками здоров’я

Пов’язані дані

Частина даних, пов’язаних із циклом, може з’являтися в інших розділах:

• Basal Body Temperature: у масиві metrics як показник здоров’я
• Sexual Activity: також у показниках здоров’я з інформацією про використання захисту

Поради

• Послідовне ведення журналу: регулярні записи дають точніші прогнози циклу
• Поєднання типів даних: використання кількох методів (виділення, слиз, температура, тести) дає найповнішу картину
• Позначки початку циклу: використовуйте isCycleStart, щоб визначати початок кожного циклу для аналізу

Пов’язана документація

• Огляд формату експорту JSON
• Показники здоров’я — для даних базальної температури тіла
• Посібник з ручного експорту
• Огляд автоматизацій