Syketiedotteet – JSON-viennin muoto

Dokumentaatio syketiedotteiden rakenteesta JSON-vienneissä

Last updated: April 1, 2026

Tällä sivulla

Syketiedotteet

Syketiedotteisiin kuuluvat Apple Watchin korkea- ja matalasykehälytykset, epäsäännöllisen rytmin ilmoitukset sekä yksityiskohtainen sykedata näiden tapahtumien aikana. JSON-vienneissä syketiedotteet tallennetaan taulukkoon heartRateNotifications.

Rakenne

Syketiedote-datalla on erityinen rakenne, joka poikkeaa muista terveysmittareista. Jokainen tiedote sisältää tapahtuman ajoituksen, kynnysarvot (korkea/matala -tiedotteissa) ja yksityiskohtaiset sykemittaukset tapahtuman aikana:

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "heartRate": [
    {
      "hr": 105,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": [
    {
      "hrv": 45,
      "units": "ms",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ]
}

Kentät

Pakolliset kentät

  • start (Date): Syketiedotetapahtuman alkuaika muodossa yyyy-MM-dd HH:mm:ss Z
  • end (Date): Syketiedotetapahtuman loppuaika muodossa yyyy-MM-dd HH:mm:ss Z
  • heartRate (Array): Sykemittaukset tapahtuman aikana (katso Sykedata alta)
  • heartRateVariation (Array): Sydämen sykevaihtelun (HRV) mittaukset tapahtuman aikana (katso HRV-data alta)

Valinnaiset kentät

  • threshold (Number): Syke, jonka kynnys laukaisi tiedotteen. Mukana vain korkea- ja matalasyke-tiedotteissa.

Tiedotetyypit

High Heart Rate Notification

Laukeaa, kun syke ylittää asetetun kynnysarvon (tyypillisesti 100–150 bpm) levossa.

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "heartRate": [
    {
      "hr": 105,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": []
}

Low Heart Rate Notification

Laukeaa, kun syke jää asetetun kynnysarvon alle (tyypillisesti 40–50 bpm) levossa.

{
  "start": "2024-02-06 03:00:00 -0800",
  "end": "2024-02-06 03:05:00 -0800",
  "threshold": 40,
  "heartRate": [
    {
      "hr": 38,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 03:00:00 -0800",
        "end": "2024-02-06 03:00:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": []
}

Irregular Rhythm Notification

Laukeaa, kun Apple Watch havaitsee epäsäännöllisen sydämen rytmin, joka voi viitata eteisvärinään.

{
  "start": "2024-02-06 16:00:00 -0800",
  "end": "2024-02-06 16:05:00 -0800",
  "heartRate": [
    {
      "hr": 85,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 16:00:00 -0800",
        "end": "2024-02-06 16:00:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": [
    {
      "hrv": 35,
      "units": "ms",
      "timestamp": {
        "start": "2024-02-06 16:00:00 -0800",
        "end": "2024-02-06 16:00:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ]
}

Huom: Epäsäännöllisen rytmin tiedotteissa ei ole threshold-kenttää.

Sykedata

heartRate-taulukko sisältää yksityiskohtaiset sykemittaukset tiedotetapahtuman aikana:

{
  "hr": 105,
  "units": "bpm",
  "timestamp": {
    "start": "2024-02-06 14:30:00 -0800",
    "end": "2024-02-06 14:30:05 -0800",
    "interval": {
      "duration": 5,
      "units": "s"
    }
  }
}

Kentät:

  • hr (Number): Syke lyönteinä minuutissa
  • units (String): Mittayksikkö (aina "bpm")
  • timestamp (Object): Tämän mittauksen aikajänne
    • start (Date): Mittausjakson alku
    • end (Date): Mittausjakson loppu
    • interval (Object): Mittauksen kesto
      • duration (Number): Kestoarvo
      • units (String): Yksikkö (aina "s" sekunteina)

Sydämen sykevaihtelu (HRV) -data

heartRateVariation-taulukko sisältää sydämen sykevaihtelun mittauksia:

{
  "hrv": 45,
  "units": "ms",
  "timestamp": {
    "start": "2024-02-06 14:30:00 -0800",
    "end": "2024-02-06 14:30:05 -0800",
    "interval": {
      "duration": 5,
      "units": "s"
    }
  }
}

Kentät:

  • hrv (Number): Sykevaihteluarvo millisekunteina
  • units (String): Mittayksikkö (aina "ms")
  • timestamp (Object): Sama rakenne kuin sykedatan aikaleimassa

HRV:n ymmärtäminen:

  • HRV mittaa sykkeiden välisten aikojen vaihtelua
  • Korkeampi HRV viittaa yleensä parempaan kardiovaskulaariseen kuntoon ja stressin palautumiseen
  • Matalampi HRV voi viitata stressiin, väsymykseen tai terveysongelmiin
  • HRV vaihtelee paljon vuorokaudenajan, aktiivisuuden ja yksilöllisten tekijöiden mukaan

Esimerkki: täydellinen tiedotemerkintä

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "heartRate": [
    {
      "hr": 105,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    },
    {
      "hr": 108,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:05 -0800",
        "end": "2024-02-06 14:30:10 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": [
    {
      "hrv": 45,
      "units": "ms",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ]
}

Tiedotteiden kynnysarvot

Kynnysarvot ovat käyttäjän säädettävissä Apple Health -asetuksissa:

  • High Heart Rate: Tyypillisesti 100–150 bpm (oletus vaihtelee iän mukaan)
  • Low Heart Rate: Tyypillisesti 40–50 bpm (oletus vaihtelee iän mukaan)

Kenttä threshold näyttää tarkan kynnysarvon, joka laukaisi tiedotteen.

Laitevaatimukset

Syketiedotteet edellyttävät:

  • Apple Watch Series 1 tai uudempi (perussykkeen seurantaan)
  • Apple Watch Series 4 tai uudempi (epäsäännöllisen rytmin tiedotteisiin)
  • watchOS 5.1.2 tai uudempi (epäsäännöllisen rytmin tiedotteisiin)
  • Ilmoitukset käytössä Apple Health -asetuksissa

Käyttötapaukset

Syketiedotedata voi olla hyödyllistä:

  • Terveyden seuranta: Seuraa, milloin syke poikkeaa tavanomaisista rajoista
  • Eteisvärinän havaitseminen: Seuraa epäsäännöllisen rytmin tiedotteita mahdollisen eteisvärinän varalta
  • Potilaskertomukset: Jaa tiedotetapahtumia hoitajille
  • Kuvioiden analyysi: Tunnista laukaisimia tai toistuvia sykekuvioita
  • Kuntoanalyysi: Ymmärrä palautumista ja stressireaktioita HRV-datan avulla
  • Oireiden yhdistäminen: Ristiinnaulaa tiedotteita oireisiin, aktiviteetteihin tai lääkitykseen

Tärkeitä huomioita

  • Ei lääkinnällinen laite: Apple Watch -tiedotteet eivät korvaa ammattilaisten diagnostiikkaa
  • Käänny hoitajan puoleen: Keskustele aina syketiedotteista terveydenhuollon ammattilaisten kanssa, erityisesti epäsäännöllisen rytmin hälytyksistä
  • Konteksti merkitsee: Syke voi nousta liikunnan, stressin, kofeiinin, lääkkeiden tai muiden tekijöiden vuoksi
  • Eteisvärinä-tiedotteet: Epäsäännöllisen rytmin tiedotteet voivat viitata eteisvärinään; ne tulisi käsitellä hoitajan kanssa

Vinkit

  • Tarkista tiedotteet: Käy tiedotteet läpi säännöllisesti kuvioiden tunnistamiseksi
  • Huomioi tilanne: Mitä teit, kun tiedote tuli (liikunta, stressi, uni jne.)
  • Seuraa trendejä: Seuraa tiedotteiden tiheyttä ja kuvioita ajan myötä
  • Yhdistä EKG:hen: Ristiinnaulaa epäsäännöllisen rytmin tiedotteet EKG-lukemiin kattavampaan sydänterveyden seurantaan

Liittyvä dokumentaatio