Syketiedotteet – JSON-viennin muoto
Dokumentaatio syketiedotteiden rakenteesta JSON-vienneissä
Last updated: April 1, 2026
Tällä sivulla
- Rakenne
- Kentät
- Pakolliset kentät
- Valinnaiset kentät
- Tiedotetyypit
- High Heart Rate Notification
- Low Heart Rate Notification
- Irregular Rhythm Notification
- Sykedata
- Sydämen sykevaihtelu (HRV) -data
- Esimerkki: täydellinen tiedotemerkintä
- Tiedotteiden kynnysarvot
- Laitevaatimukset
- Käyttötapaukset
- Tärkeitä huomioita
- Vinkit
- Liittyvä dokumentaatio
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 muodossayyyy-MM-dd HH:mm:ss Zend(Date): Syketiedotetapahtuman loppuaika muodossayyyy-MM-dd HH:mm:ss ZheartRate(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ä minuutissaunits(String): Mittayksikkö (aina"bpm")timestamp(Object): Tämän mittauksen aikajännestart(Date): Mittausjakson alkuend(Date): Mittausjakson loppuinterval(Object): Mittauksen kestoduration(Number): Kestoarvounits(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 millisekunteinaunits(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
- JSON-viennin muoto – yleiskatsaus
- EKG – Yksityiskohtaiset EKG-lukemat
- Terveysmittarit – Yleinen sykedata
- Manuaalinen vienti
- Automaatiot – yleiskatsaus