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
Formati speciali delle metriche
Formati speciali delle metriche Pressione arteriosaFrequenza cardiacaVariabilità della frequenza cardiacaAnalisi del sonnoGlucosio nel sangueNutrizioneAttività sessualeLavaggio delle maniSpazzolamento dei dentiSomministrazione di insulinaLe 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 formatoyyyy-MM-dd HH:mm:ss Zsource(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 misurazioneAvg(Number): Frequenza cardiaca media durante il periodo di misurazioneMax(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 oreasleep(Number): Tempo di sonno senza una fase di sonno registrata, in orecore(Number): Durata del sonno core in oredeep(Number): Durata del sonno profondo in orerem(Number): Durata del sonno REM in oreawake(Number): Tempo sveglio in oresleepStart(Date): Quando è iniziato davvero il sonnosleepEnd(Date): Quando è terminato davvero il sonnoinBed(Number): Tempo totale a letto in oreinBedStart(Date): Quando sei andato a lettoinBedEnd(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 sonnoend,endDate(Date): Ora di fine del segmento di sonnosource(String): L’app o il dispositivo che ha registrato il segmentoqty(Number): Durata del segmento in orevalue(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 sanguemealTime(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 campionefoodType(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 è sconosciutoProtection Used(Number): Conteggio degli eventi quel giorno quando è stata usata protezioneProtection 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)