HealthyApps Help Center

Notifiche della Frequenza Cardiaca - Formato di Esportazione JSON

Documentazione sulla struttura delle notifiche della frequenza cardiaca nelle esportazioni JSON

Last updated: February 6, 2026

On this page

Notifiche della Frequenza Cardiaca

Le notifiche della frequenza cardiaca includono avvisi di frequenza cardiaca alta e bassa da Apple Watch, notifiche di ritmo irregolare e dati dettagliati della frequenza cardiaca raccolti durante questi eventi. Nelle esportazioni JSON, le notifiche della frequenza cardiaca sono memorizzate nell'array heartRateNotifications.

Struttura

I dati delle notifiche della frequenza cardiaca hanno una struttura unica che differisce da altre metriche di salute. Ogni notifica include il momento dell'evento, le soglie (per notifiche alte/basse) e misurazioni dettagliate della frequenza cardiaca durante l'evento:

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

Campi

Campi Richiesti

  • start (Data): Ora di inizio dell'evento di notifica della frequenza cardiaca nel formato yyyy-MM-dd HH:mm:ss Z
  • end (Data): Ora di fine dell'evento di notifica della frequenza cardiaca nel formato yyyy-MM-dd HH:mm:ss Z
  • heartRate (Array): Array di misurazioni della frequenza cardiaca durante l'evento (vedi Dati della Frequenza Cardiaca sotto)
  • heartRateVariation (Array): Array di misurazioni della variabilità della frequenza cardiaca (HRV) durante l'evento (vedi Dati HRV sotto)

Campi Opzionali

  • threshold (Numero): Soglia della frequenza cardiaca che ha attivato la notifica. Inclusa solo per notifiche di frequenza cardiaca alta e bassa.

Tipi di Notifica

Notifica di Frequenza Cardiaca Alta

Attivata quando la frequenza cardiaca supera una soglia impostata (tipicamente 100-150 bpm) mentre si è a riposo.

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

Notifica di Frequenza Cardiaca Bassa

Attivata quando la frequenza cardiaca scende al di sotto di una soglia impostata (tipicamente 40-50 bpm) mentre si è a riposo.

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

Notifica di Ritmo Irregolare

Attivata quando Apple Watch rileva un ritmo cardiaco irregolare che può indicare fibrillazione atriale.

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

Nota: Le notifiche di ritmo irregolare non includono un campo threshold.

Dati della Frequenza Cardiaca

L'array heartRate contiene misurazioni dettagliate della frequenza cardiaca durante l'evento di notifica:

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

Campi:

  • hr (Numero): Valore della frequenza cardiaca in battiti al minuto
  • units (Stringa): Unità di misura (sempre "bpm" per battiti al minuto)
  • timestamp (Oggetto): Periodo di tempo per questa misurazione
    • start (Data): Inizio del periodo di misurazione
    • end (Data): Fine del periodo di misurazione
    • interval (Oggetto): Durata della misurazione
      • duration (Numero): Valore della durata
      • units (Stringa): Unità (sempre "s" per secondi)

Dati della Variabilità della Frequenza Cardiaca (HRV)

L'array heartRateVariation contiene misurazioni della variabilità della frequenza cardiaca:

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

Campi:

  • hrv (Numero): Valore della variabilità della frequenza cardiaca in millisecondi
  • units (Stringa): Unità di misura (sempre "ms" per millisecondi)
  • timestamp (Oggetto): Stessa struttura del timestamp della frequenza cardiaca

Comprendere l'HRV:

  • L'HRV misura la variazione del tempo tra i battiti cardiaci
  • Un HRV più alto generalmente indica una migliore forma cardiovascolare e recupero dallo stress
  • Un HRV più basso può indicare stress, affaticamento o problemi di salute
  • L'HRV può variare significativamente in base all'ora del giorno, al livello di attività e ai fattori individuali

Esempio: Voce di Notifica Completa

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

Soglie di Notifica

Le soglie sono configurabili dall'utente nelle impostazioni di Apple Health:

  • Frequenza Cardiaca Alta: Tipicamente 100-150 bpm (il valore predefinito varia in base all'età)
  • Frequenza Cardiaca Bassa: Tipicamente 40-50 bpm (il valore predefinito varia in base all'età)

Il campo threshold mostra la soglia esatta che ha attivato la notifica.

Requisiti del Dispositivo

Le notifiche della frequenza cardiaca richiedono:

  • Apple Watch Series 1 o successiva (per il monitoraggio base della frequenza cardiaca)
  • Apple Watch Series 4 o successiva (per le notifiche di ritmo irregolare)
  • WatchOS 5.1.2 o successivo (per le notifiche di ritmo irregolare)
  • Notifiche abilitate nelle impostazioni di Apple Health

Casi d'Uso

I dati delle notifiche della frequenza cardiaca possono essere utili per:

  • Monitoraggio della salute: Tracciare quando la frequenza cardiaca supera i range normali
  • Rilevamento FA: Monitorare le notifiche di ritmo irregolare per potenziale fibrillazione atriale
  • Cartelle cliniche: Condividere eventi di notifica con i fornitori di assistenza sanitaria
  • Analisi dei pattern: Identificare trigger o pattern negli eventi della frequenza cardiaca
  • Insight sul fitness: Comprendere il recupero e le risposte allo stress attraverso i dati HRV
  • Correlazione dei sintomi: Incrociare le notifiche con sintomi, attività o farmaci

Note Importanti

  • Non è un dispositivo medico: Le notifiche di Apple Watch non sono destinate a sostituire la diagnosi medica professionale
  • Consultare i fornitori di assistenza sanitaria: Consultare sempre i professionisti della salute riguardo alle notifiche della frequenza cardiaca, specialmente gli avvisi di ritmo irregolare
  • Il contesto conta: La frequenza cardiaca può essere elevata a causa di esercizio, stress, caffeina, farmaci o altri fattori
  • Notifiche FA: Le notifiche di ritmo irregolare possono indicare fibrillazione atriale e dovrebbero essere discusse con un fornitore di assistenza sanitaria

Suggerimenti

  • Rivedere le notifiche: Rivedere regolarmente le notifiche della frequenza cardiaca per identificare pattern
  • Annotare il contesto: Considerare cosa si stava facendo quando si sono verificate le notifiche (esercizio, stress, sonno, ecc.)
  • Tracciare le tendenze: Monitorare la frequenza e i pattern delle notifiche nel tempo
  • Combinare con ECG: Incrociare le notifiche di ritmo irregolare con le letture ECG per un monitoraggio completo della salute cardiaca

Documentazione Correlata