Centro assistenza HealthyApps
Italiano
Centro assistenza
Sito principale ↗

Cerca argomenti di assistenza

Metriche di salute - Formato di esportazione JSON

Documentazione della struttura delle metriche di salute nelle esportazioni JSON

Ultimo aggiornamento: 31 ottobre 2026

In questa pagina
Formato del nome della metrica
Struttura Struttura Campi comuni
Formati speciali delle metriche Formati speciali delle metriche Pressione arteriosaFrequenza cardiacaVariabilità della frequenza cardiacaAnalisi del sonnoGlucosio nel sangueNutrizioneAttività sessualeLavaggio delle maniSpazzolamento dei dentiSomministrazione di insulina
Documentazione correlata

Le esportazioni JSON memorizzano le metriche di salute nell’array metrics.

Formato del nome della metrica

Tutti i nomi delle metriche nelle esportazioni JSON usano il formato snake_case (minuscolo con underscore). Ad esempio:

  • "Step Count" diventa "step_count"
  • "Blood Pressure" diventa "blood_pressure"
  • "Heart Rate" diventa "heart_rate"
  • "Walking + Running Distance" diventa "walking_running_distance"

Struttura

L’array metrics contiene oggetti, ciascuno rappresentante un tipo specifico di metrica di salute. La maggior parte delle metriche di salute segue una struttura comune:

{
  "name": "step_count",
  "units": "count",
  "data": [
    {
      "qty": 8500,
      "date": "2024-02-06 14:30:00 -0800",
      "source": "Apple Watch"
    }
  ]
}

Campi comuni

  • name (String): Il nome della metrica di salute in formato snake_case (ad es. "step_count", "heart_rate", "active_energy")
  • units (String): L’unità di misura (ad es. "count", "count/min", "kcal")
  • data (Array): Un array di punti dati, ciascuno con:
    • qty (Number): Il valore di quantità
    • date (Date): Timestamp nel formato yyyy-MM-dd HH:mm:ss Z
    • source (String, quando disponibile): L’app o il dispositivo che ha registrato il campione

Formati speciali delle metriche

Alcune metriche di salute hanno strutture uniche che differiscono dal formato comune:

Pressione arteriosa

Le letture della pressione arteriosa includono valori sistolici e diastolici:

{
  "name": "blood_pressure",
  "units": "mmHg",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "start": "2024-02-06 14:30:00 -0800",
      "end": "2024-02-06 14:30:00 -0800",
      "systolic": 120,
      "diastolic": 80,
      "source": "Health"
    }
  ]
}

Campi:

  • systolic (Number): La lettura della pressione arteriosa sistolica (superiore). Le esportazioni riepilogate usano la media delle letture del gruppo temporale.
  • diastolic (Number): La lettura della pressione arteriosa diastolica (inferiore). Le esportazioni riepilogate usano la media delle letture del gruppo temporale.

Frequenza cardiaca

I dati della frequenza cardiaca includono valori minimo, medio e massimo:

{
  "name": "heart_rate",
  "units": "count/min",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "Min": 65,
      "Avg": 72,
      "Max": 85,
      "source": "Apple Watch"
    }
  ]
}

Campi:

  • Min (Number): Frequenza cardiaca minima durante il periodo di misurazione
  • Avg (Number): Frequenza cardiaca media durante il periodo di misurazione
  • Max (Number): Frequenza cardiaca massima durante il periodo di misurazione

Variabilità della frequenza cardiaca

Con Riepiloga dati disattivato, le esportazioni JSON di Variabilità della frequenza cardiaca (SDNN) possono includere letture battito a battito disponibili. Richiedono accesso in lettura a Serie di battiti in Apple Health.

Le esportazioni riepilogate, le esportazioni CSV e l’HRV di recupero non includono letture battito a battito.

Analisi del sonno

La struttura dei dati del sonno dipende da se Riepiloga dati è attivato o disattivato.

Riepiloga dati attivato

Con Riepiloga dati attivato, i dati del sonno sono riepilogati per giorno. Le durate della stessa fase vengono sommate. Il sonno totale è la somma di asleep, core, deep e REM. JSON conserva ciascun giorno. In CSV, un gruppo temporale più grossolano mostra l’ultimo giorno di quel gruppo:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "totalSleep": 7.5,
      "asleep": 0.5,
      "core": 3.5,
      "deep": 1.5,
      "rem": 2.0,
      "sleepStart": "2024-02-05 23:00:00 -0800",
      "sleepEnd": "2024-02-06 06:30:00 -0800",
      "inBed": 8.0,
      "inBedStart": "2024-02-05 22:45:00 -0800",
      "inBedEnd": "2024-02-06 06:45:00 -0800",
      "awake": 0.0,
      "source": "Apple Watch"
    }
  ]
}

Campi:

  • totalSleep (Number): Tempo totale di sonno in ore
  • asleep (Number): Tempo di sonno senza una fase di sonno registrata, in ore
  • core (Number): Durata del sonno core in ore
  • deep (Number): Durata del sonno profondo in ore
  • rem (Number): Durata del sonno REM in ore
  • awake (Number): Tempo sveglio in ore
  • sleepStart (Date): Quando è iniziato davvero il sonno
  • sleepEnd (Date): Quando è terminato davvero il sonno
  • inBed (Number): Tempo totale a letto in ore
  • inBedStart (Date): Quando sei andato a letto
  • inBedEnd (Date): Quando ti sei alzato dal letto

Riepiloga dati disattivato

Con Riepiloga dati disattivato, sono inclusi i segmenti di sonno individuali:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-05 23:00:00 -0800",
      "start": "2024-02-05 23:00:00 -0800",
      "end": "2024-02-05 23:30:00 -0800",
      "startDate": "2024-02-05 23:00:00 -0800",
      "endDate": "2024-02-05 23:30:00 -0800",
      "qty": 0.5,
      "value": "Core",
      "source": "Apple Watch"
    }
  ]
}

Campi:

  • date, start, startDate (Date): Ora di inizio del segmento di sonno
  • end, endDate (Date): Ora di fine del segmento di sonno
  • source (String): L’app o il dispositivo che ha registrato il segmento
  • qty (Number): Durata del segmento in ore
  • value (String): Stato del sonno - uno di:
    • "Awake"
    • "Asleep" (fase di sonno non categorizzata)
    • "In Bed"
    • "Core"
    • "REM"
    • "Deep"
    • "Unspecified"

Nota: "Asleep" si riferisce a una fase di sonno non categorizzata (non al tempo totale di sonno). Può verificarsi se l’origine dei dati non supporta il monitoraggio delle fasi del sonno.

Glucosio nel sangue

Le letture del glucosio nel sangue includono informazioni sul momento del pasto:

{
  "name": "blood_glucose",
  "units": "mg/dL",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 95,
      "mealTime": "Before Meal",
      "source": "Health"
    }
  ]
}

Campi:

  • qty (Number): Livello di glucosio nel sangue
  • mealTime (String): Uno di:
    • "Before Meal"
    • "After Meal"
    • "Unspecified"

Nutrizione

Quando Riepiloga dati è disattivato, i singoli campioni di quantità di nutrizione (ad esempio Energia alimentare o Carboidrati) possono includere dettagli degli alimenti registrati in Apple Health. Ad esempio:

{
  "name": "dietary_energy",
  "units": "kcal",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 240,
      "source": "Lose It!",
      "foodType": "Boneless, Skinless Grilled Chicken Breast"
    }
  ]
}

Campi:

  • qty (Number): Quantità del nutriente del campione
  • foodType (String, facoltativo): Nome dell’alimento registrato dall’app di origine, quando disponibile

Con Riepiloga dati attivato, i totali di nutrizione non includono foodType.

Attività sessuale

Le voci di attività sessuale registrano l’uso della protezione:

{
  "name": "sexual_activity",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "Unspecified": 0,
      "Protection Used": 1,
      "Protection Not Used": 0,
      "source": "Health"
    }
  ]
}

Campi:

  • Unspecified (Number): Conteggio degli eventi quel giorno quando lo stato di protezione è sconosciuto
  • Protection Used (Number): Conteggio degli eventi quel giorno quando è stata usata protezione
  • Protection Not Used (Number): Conteggio degli eventi quel giorno quando non è stata usata protezione

Le esportazioni riepilogate contano ciascun giorno del calendario. JSON conserva ciascun giorno. In CSV, un gruppo temporale più grossolano mostra l’ultimo giorno di quel gruppo.

Lavaggio delle mani

Gli eventi di lavaggio delle mani registrano lo stato di completamento:

{
  "name": "handwashing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 12:00:00 -0800",
      "start": "2024-02-06 12:00:00 -0800",
      "end": "2024-02-06 12:00:25 -0800",
      "qty": 25,
      "value": "Completed",
      "source": "Apple Watch"
    }
  ]
}

Campi:

  • qty (Number): Durata in secondi. Le esportazioni riepilogate usano la durata media del gruppo temporale.
  • value (String): "Completed" quando la sessione dura più di 20 secondi; altrimenti "Incomplete"

Spazzolamento dei denti

Gli eventi di spazzolamento dei denti registrano lo stato di completamento:

{
  "name": "toothbrushing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:02:10 -0800",
      "qty": 130,
      "value": "Completed",
      "source": "Health"
    }
  ]
}

Campi:

  • qty (Number): Durata in secondi. Le esportazioni riepilogate usano la durata media del gruppo temporale.
  • value (String): "Completed" quando la sessione dura almeno 2 minuti; altrimenti "Incomplete"

Somministrazione di insulina

Le voci di somministrazione di insulina includono il motivo della somministrazione:

{
  "name": "insulin_delivery",
  "units": "IU",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 5,
      "reason": "Bolus",
      "source": "Health"
    }
  ]
}

Campi:

  • qty (Number): Quantità di insulina somministrata. Le esportazioni riepilogate sommano le quantità del gruppo temporale.
  • reason (String): Uno di:
    • "Bolus" (insulina ai pasti)
    • "Basal" (insulina di base)

Documentazione correlata