Śledzenie Cyklu - Format Eksportu JSON

Dokumentacja dotycząca struktury śledzenia cyklu w eksportach JSON

Last updated: February 6, 2026

On this page

Śledzenie Cyklu

Dane śledzenia cyklu obejmują wszystkie informacje związane z cyklem miesiączkowym zarejestrowane w Apple Health, takie jak przepływ miesiączkowy, jakość śluzu szyjkowego, podstawowa temperatura ciała, wyniki testów owulacji i inne dane związane z cyklem. W eksportach JSON dane śledzenia cyklu są przechowywane w tablicy cycleTracking.

Struktura

Każdy wpis śledzenia cyklu następuje zgodnie ze spójną strukturą:

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

Pola

Pola Wymagane

  • start (String): Data i godzina rozpoczęcia wpisu w formacie yyyy-MM-dd HH:mm:ss Z
  • end (String): Data i godzina zakończenia wpisu w formacie yyyy-MM-dd HH:mm:ss Z
  • name (String): Typ danych śledzenia cyklu (zobacz typy poniżej)
  • value (String): Wartość lub wynik dla tego wpisu (różni się w zależności od typu)

Pola Opcjonalne

  • isCycleStart (Boolean): Wskazuje, czy ten wpis oznacza początek nowego cyklu miesiączkowego. Obecne tylko dla wpisów Przepływu Miesiączkowego, gdy wartość jest true.

Typy Śledzenia Cyklu

Przepływ Miesiączkowy

Śledzi krwawienie miesiączkowe z poziomem przepływu i informacjami o począ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żliwe Wartości:

  • "None" - Brak
  • "Light" - Lekki
  • "Medium" - Średni
  • "Heavy" - Obfity
  • "Unspecified" - Nieokreślony

Uwaga: isCycleStart jest uwzględniane tylko wtedy, gdy wartość jest true, wskazując początek nowego cyklu miesiączkowego.

Jakość Śluzu Szyjkowego

Śledzi jakość śluzu szyjkowego, który może wskazywać status płodności.

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

Możliwe Wartości:

  • "Egg White" - Przejrzysty, rozciągliwy śluz (najbardziej płodny)
  • "Watery" - Cienki, wodnisty śluz
  • "Creamy" - Gęsty, kremowy śluz
  • "Sticky" - Lepki śluz
  • "Dry" - Mało lub brak śluzu

Podstawowa Temperatura Ciała

Pomiary podstawowej temperatury ciała (BBT) są eksportowane jako metryki zdrowia, a nie jako wpisy śledzenia cyklu. Szukaj "Basal Body Temperature" w tablicy metrics.

Wynik Testu Owulacji

Rejestruje wyniki testów przewidywania owulacji.

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

Możliwe Wartości:

  • "Positive/Peak" - Maksymalna płodność wykryta
  • "High" - Wysoki poziom płodności
  • "Negative/Low" - Niski poziom płodności
  • "Indeterminate" - Wynik testu niejasny

Wynik Testu Progesteronu

Rejestruje wyniki testów progesteronu.

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

Wynik Testu Ciąży

Rejestruje wyniki testów ciążowych.

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

Aktywność Seksualna

Śledzi aktywność seksualną w kontekście śledzenia cyklu.

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

Uwaga: Aktywność seksualna może również pojawić się w metrykach zdrowia ze szczegółami dotyczącymi użycia ochrony.

Ciąża

Śledzi okresy ciąży.

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

Laktacja

Śledzi okresy laktacji.

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

Antykoncepcja

Śledzi okresy używania antykoncepcji.

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

Nieprawidłowości Cyklu

Następujące typy śledzą różne nieprawidłowości cyklu:

Rzadki Cykl Miesiączkowy

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

Nieregularny Cykl Miesiączkowy

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

Krwawienie Między Miesiączkami

Krwawienie występujące między miesiączkami.

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

Uporczywe Krwawienie Miesiączkowe

Przedłużone lub uporczywe krwawienie.

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

Przedłużony Okres Miesiączkowy

Okresy trwające dłużej niż zwykle.

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

Przykład: Pełny Wpis 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": ""
  }
]

Zastosowania

Dane śledzenia cyklu mogą być przydatne do:

  • Śledzenia płodności: Monitorowanie owulacji i identyfikacja płodnych okien
  • Analizy cyklu: Śledzenie długości, regularności i wzorców cyklu
  • Monitorowania zdrowia: Identyfikacja nieprawidłowości lub zmian w wzorcach cyklu
  • Planowania ciąży: Używanie danych do planowania poczęcia
  • Udostępniania dostawcom opieki zdrowotnej: Udostępnianie danych cyklu ginekologom lub specjalistom od płodności
  • Korelacji objawów: Krzyżowe odniesienia danych cyklu z innymi metrykami zdrowia

Powiązane Dane

Niektóre dane związane z cyklem mogą pojawić się w innych sekcjach:

  • Podstawowa Temperatura Ciała: Znajduje się w tablicy metrics jako metryka zdrowia
  • Aktywność Seksualna: Może również pojawić się w metrykach zdrowia ze szczegółami dotyczącymi użycia ochrony

Wskazówki

  • Spójne rejestrowanie: Regularne rejestrowanie zapewnia dokładniejsze przewidywania cyklu
  • Łączenie typów danych: Używanie wielu metod śledzenia (przepływ, śluz, temperatura, testy) zapewnia najbardziej kompleksowy obraz
  • Znaczniki początku cyklu: Użyj isCycleStart, aby zidentyfikować początek każdego cyklu do analizy

Powiązana Dokumentacja