Цикл

Данные цикла включают записи из «Здоровья» Apple: менструация, качество цервикальной слизи, базальная температура, тесты на овуляцию и др. В 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
}

Возможные значения value:

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

Базальная температура экспортируется как показатель здоровья в массиве metrics, не как запись cycle tracking. Ищите «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
• Показатели здоровья — базальная температура
• Руководство по ручному экспорту
• Обзор автоматизаций