HealthyApps Help Center

Kierronseuranta – JSON-viennin muoto

Dokumentaatio kierronseurannan rakenteesta JSON-vienneissä

Last updated: April 1, 2026

Tällä sivulla

Kierronseuranta

Kierronseurantadata sisältää kaiken Apple Healthiin tallennetun kuukautiskierron tiedon, kuten kuukautisvuodon, kohdunkaulan liman laadun, lepolämmön, ovulaatiotestien tulokset ja muun kiertoon liittyvän datan. JSON-vienneissä kierronseuranta tallennetaan taulukkoon cycleTracking.

Rakenne

Jokainen kierronseurantamerkintä noudattaa yhtenäistä rakennetta:

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

Kentät

Pakolliset kentät

  • start (String): Merkinnän alkupäivä ja -aika muodossa yyyy-MM-dd HH:mm:ss Z
  • end (String): Merkinnän loppupäivä ja -aika muodossa yyyy-MM-dd HH:mm:ss Z
  • name (String): Kierronseurannan tyyppi (katso tyypit alta)
  • value (String): Tämän merkinnän arvo tai tulos (vaihtelee tyypin mukaan)

Valinnaiset kentät

  • isCycleStart (Boolean): Ilmaisee, merkitseekö merkintä uuden kuukautiskierron alun. Näkyy vain Menstrual Flow -merkinnöissä, kun arvo on true.

Kierronseurannan tyypit

Menstrual Flow

Seuraa kuukautisvuotoa vuodon määrän ja kierron alun tiedoilla.

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

Mahdolliset arvot:

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

Huom: isCycleStart sisällytetään vain, kun arvo on true, mikä merkitsee uuden kuukautiskierron alkua.

Cervical Mucus Quality

Seuraa kohdunkaulan liman laatua, joka voi kertoa hedelmällisyydestä.

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

Mahdolliset arvot:

  • "Egg White" – Kirkas, venyvä lima (hedelmällisin)
  • "Watery" – Ohut, vetinen lima
  • "Creamy" – Paksu, kermainen lima
  • "Sticky" – Tahmea lima
  • "Dry" – Vähän tai ei lainkaan limaa

Basal Body Temperature

Lepolämpö (BBT) -mittaukset viedään terveysmittareina, ei kierronseurantamerkintöinä. Etsi "Basal Body Temperature" taulukosta metrics.

Ovulation Test Result

Tallentaa ovulaatioennustetestien tuloksia.

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

Mahdolliset arvot:

  • "Positive/Peak" – Huippuhedelmällisyys havaittu
  • "High" – Korkea hedelmällisyys
  • "Negative/Low" – Matala hedelmällisyys
  • "Indeterminate" – Epäselvä testitulos

Progesterone Test Result

Tallentaa progesteronitestien tuloksia.

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

Tallentaa raskaustestien tuloksia.

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

Sexual Activity

Seuraa seksuaalista aktiivisuutta kierronseurannan kontekstissa.

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

Huom: Seksuaalinen aktiivisuus voi näkyä myös terveysmittareissa suojauksen käytön tiedoilla.

Pregnancy

Seuraa raskausjaksoja.

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

Lactation

Seuraa imetyksen aikoja.

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

Contraceptive

Seuraa ehkäisyn käyttöjaksoja.

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

Kierron epäsäännöllisyydet

Seuraavat tyypit seuraavat erilaisia kierron häiriöitä:

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

Vuoto kuukautisten välillä.

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

Persistent Menstrual Bleeding

Pitkään jatkuva tai yhtämittainen vuoto.

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

Prolonged Menstrual Period

Kuukautiset, jotka kestävät tavallista pidempään.

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

Esimerkki: täydellinen kiertomerkinä

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

Käyttötapaukset

Kierronseurantadata voi olla hyödyllistä:

  • Hedelmällisyyden seuranta: Ovulaation seuranta ja hedelmällisten ikkunoiden tunnistaminen
  • Kiertoanalyysi: Kierron pituuden, säännöllisyyden ja kuvioiden seuranta
  • Terveyden seuranta: Epäsäännöllisyyksien tai muutosten tunnistaminen kiertokuvioissa
  • Raskauden suunnittelu: Datan käyttö hedelmöitymisen suunnitteluun
  • Jakaminen hoitajalle: Kiertodatan jakaminen gynekologille tai hedelmällisyysasiantuntijalle
  • Oireiden yhdistäminen: Kiertodatan ristiinviittaus muihin terveysmittareihin

Liittyvä data

Osa kiertoon liittyvästä datasta voi näkyä muissa osissa:

  • Basal Body Temperature: metrics-taulukossa terveysmittarina
  • Sexual Activity: Voi näkyä myös terveysmittareissa suojauksen käytön tiedoilla

Vinkit

  • Johdonmukainen kirjaaminen: Säännöllinen kirjaaminen parantaa kiertoennusteiden tarkkuutta
  • Yhdistä datatyyppejä: Useiden seurantamenetelmien (vuoto, lima, lämpö, testit) käyttö antaa kokonaiskuvan
  • Kierron alun merkinnät: Käytä isCycleStart-kenttää tunnistamaan kunkin kierron alku analyysiä varten

Liittyvä dokumentaatio