Cykelspårning - JSON Exportformat

Dokumentation om cykelspårningsstrukturen i JSON-exporter

Last updated: February 6, 2026

On this page

Cykelspårning

Cykelspårningsdata inkluderar all menstruationscykelrelaterad information som registreras i Apple Health, såsom menstruationsflöde, livmoderhalsens slemkvalitet, basalt kroppstemperatur, ägglossningstestresultat och annan cykelrelaterad data. I JSON-exporter lagras cykelspårningsdata i arrayen cycleTracking.

Struktur

Varje cykelspårningspost följer en konsekvent struktur:

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

Fält

Obligatoriska Fält

  • start (String): Startdatum och -tid för posten i formatet yyyy-MM-dd HH:mm:ss Z
  • end (String): Slutdatum och -tid för posten i formatet yyyy-MM-dd HH:mm:ss Z
  • name (String): Typ av cykelspårningsdata (se typer nedan)
  • value (String): Värdet eller resultatet för denna post (varierar efter typ)

Valfria Fält

  • isCycleStart (Boolean): Anger om denna post markerar början av en ny menstruationscykel. Endast närvarande för Menstrual Flow-poster när värdet är true.

Cykelspårningstyper

Menstruationsflöde

Spårar menstruationsblödning med blödningsnivå och cykelstartinformation.

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

Möjliga Värden:

  • "None" - Ingen
  • "Light" - Lätt
  • "Medium" - Måttlig
  • "Heavy" - Kraftig
  • "Unspecified" - Ospecificerad

Notera: isCycleStart inkluderas endast när värdet är true, vilket anger början av en ny menstruationscykel.

Livmoderhalsens Slemkvalitet

Spårar kvaliteten på livmoderhalsens slem, vilket kan indikera fertilitetsstatus.

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

Möjliga Värden:

  • "Egg White" - Tyglig, elastisk slem (mest fertil)
  • "Watery" - Tunn, vattnig slem
  • "Creamy" - Tjock, krämig slem
  • "Sticky" - Klibbig slem
  • "Dry" - Lite eller ingen slem

Basalt Kroppstemperatur

Mätningar av basalt kroppstemperatur (BBT) exporteras som hälsomått, inte som cykelspårningsposter. Sök efter "Basal Body Temperature" i arrayen metrics.

Ägglossningstestresultat

Registrerar resultat från ägglossningsförutsägelsetester.

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

Möjliga Värden:

  • "Positive/Peak" - Maximal fertilitet upptäckt
  • "High" - Högt fertilitetsnivå
  • "Negative/Low" - Lågt fertilitetsnivå
  • "Indeterminate" - Testresultat oklart

Progesterontestresultat

Registrerar resultat från progesterontester.

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

Graviditetstestresultat

Registrerar resultat från graviditetstester.

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

Sexuell Aktivitet

Spårar sexuell aktivitet inom cykelspårningskontexten.

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

Notera: Sexuell aktivitet kan också förekomma i hälsomått med detaljer om skyddsanvändning.

Graviditet

Spårar graviditetsperioder.

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

Amning

Spårar amningsperioder.

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

Preventivmedel

Spårar preventivmedelsanvändningsperioder.

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

Cykeloregelbundenheter

Följande typer spårar olika cykeloregelbundenheter:

Sällsynt Menstruationscykel

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

Oregelbunden Menstruationscykel

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

Mellanblödning

Blödning som uppstår mellan menstruationer.

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

Persistent Menstruationsblödning

Förlängd eller ihållande blödning.

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

Förlängd Menstruationsperiod

Perioder som varar längre än vanligt.

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

Exempel: Komplett Cykelpost

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

Användningsfall

Cykelspårningsdata kan vara användbart för:

  • Fertilitetsspårning: Övervaka ägglossning och identifiera fertila fönster
  • Cykelanalys: Spåra cykellängd, regelbundenhet och mönster
  • Hälsövervakning: Identifiera oregelbundenheter eller förändringar i cykelmönster
  • Graviditetsplanering: Använd data för befruktningsplanering
  • Delning med vårdgivare: Dela cykeldata med gynekologer eller fertilitetsspecialister
  • Symptomkorrelation: Korsreferera cykeldata med andra hälsomått

Relaterade Data

Vissa cykelrelaterade data kan förekomma i andra sektioner:

  • Basalt Kroppstemperatur: Finns i arrayen metrics som ett hälsomått
  • Sexuell Aktivitet: Kan också förekomma i hälsomått med detaljer om skyddsanvändning

Tips

  • Konsekvent loggning: Regelbunden loggning ger mer exakta cykelförutsägelser
  • Kombinera datatyper: Användning av flera spårningsmetoder (flöde, slem, temperatur, tester) ger den mest omfattande bilden
  • Cykelstartmarkörer: Använd isCycleStart för att identifiera början av varje cykel för analys

Relaterad Dokumentation