Metriche di Salute

Le metriche di salute rappresentano le varie misurazioni e punti dati raccolti dalla tua app Apple Health e dai dispositivi connessi. Nelle esportazioni JSON, le metriche di salute sono memorizzate nell'array metrics.

Formato del Nome della Metrica

Tutti i nomi delle metriche nelle esportazioni JSON utilizzano il formato snake_case (minuscole 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, ognuno dei quali rappresenta 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"
    }
  ]
}

Campi Comuni

• name (String): Il nome della metrica di salute in formato snake_case (es: "step_count", "heart_rate", "active_energy")
• units (String): L'unità di misura (es: "count", "bpm", "kcal")
• data (Array): Un array di punti dati, ognuno contenente:
  • qty (Number): Il valore della quantità
  • date (Date): Timestamp nel formato yyyy-MM-dd HH:mm:ss Z

Formati Speciali delle Metriche

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

Pressione Sanguigna

Le letture della pressione sanguigna includono valori sia sistolici che diastolici:

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

Campi:

• systolic (Number): La lettura della pressione sanguigna sistolica (superiore)
• diastolic (Number): La lettura della pressione sanguigna diastolica (inferiore)

Frequenza Cardiaca

I dati della frequenza cardiaca includono valori minimi, medi e massimi:

{
  "name": "heart_rate",
  "units": "bpm",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "Min": 65,
      "Avg": 72,
      "Max": 85
    }
  ]
}

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

Analisi del Sonno

La struttura dei dati del sonno varia a seconda che l'aggregazione dei dati sia abilitata nelle impostazioni di esportazione.

Dati del Sonno Aggregati

Quando l'aggregazione è abilitata, i dati del sonno sono riepilogati per giorno:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-06",
      "totalSleep": 7.5,
      "asleep": 7.0,
      "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"
    }
  ]
}

Campi:

• totalSleep (Number): Tempo totale di sonno in ore
• asleep (Number): Tempo totale in qualsiasi stato di sonno
• core (Number): Durata del sonno leggero in ore
• deep (Number): Durata del sonno profondo in ore
• rem (Number): Durata del sonno REM in ore
• sleepStart (Date): Quando il sonno è effettivamente iniziato
• sleepEnd (Date): Quando il sonno è effettivamente terminato
• inBed (Number): Tempo totale a letto in ore
• inBedStart (Date): Quando sei andato a letto
• inBedEnd (Date): Quando ti sei alzato

Dati del Sonno Non Aggregati

Quando l'aggregazione è disabilitata, vengono inclusi segmenti individuali di sonno:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "startDate": "2024-02-05 23:00:00 -0800",
      "endDate": "2024-02-05 23:30:00 -0800",
      "qty": 0.5,
      "value": "Core",
      "deep": 0.0,
      "rem": 0.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"
    }
  ]
}

Campi:

• startDate (Date): Ora di inizio del segmento di sonno
• endDate (Date): Ora di fine del segmento di sonno
• 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 (piuttosto che al tempo totale di sonno). Questo può verificarsi se la fonte dati non supporta il tracciamento delle fasi del sonno.

Glicemia

Le letture della glicemia includono informazioni sul momento del pasto:

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

Campi:

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

Attività Sessuale

Le voci di attività sessuale tracciano l'uso della protezione:

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

Campi:

• Unspecified (Number): Conteggio quando lo stato della protezione è sconosciuto
• Protection Used (Number): Conteggio quando la protezione è stata utilizzata
• Protection Not Used (Number): Conteggio quando la protezione non è stata utilizzata

Lavaggio delle Mani

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

{
  "name": "handwashing",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 12:00:00 -0800",
      "qty": 1,
      "value": "Complete"
    }
  ]
}

Campi:

• qty (Number): Numero di eventi di lavaggio delle mani
• value (String): Uno di:
  • "Complete"
  • "Incomplete"

Spazzolamento dei Denti

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

{
  "name": "toothbrushing",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "qty": 1,
      "value": "Complete"
    }
  ]
}

Campi:

• qty (Number): Numero di eventi di spazzolamento dei denti
• value (String): Uno di:
  • "Complete"
  • "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",
      "qty": 5,
      "reason": "Bolus"
    }
  ]
}

Campi:

• qty (Number): Quantità di insulina somministrata
• reason (String): Uno di:
  • "Bolus" (insulina ai pasti)
  • "Basal" (insulina di base)

Metriche di Salute Comuni

Alcune metriche di salute comunemente esportate includono (tutti i nomi delle metriche sono in formato snake_case):

• step_count - Conteggi giornalieri dei passi
• walking_running_distance - Distanza percorsa
• active_energy - Calorie bruciate attraverso l'attività
• resting_heart_rate - Frequenza cardiaca a riposo
• heart_rate - Misurazioni della frequenza cardiaca
• respiratory_rate - Frequenza respiratoria
• body_temperature - Letture della temperatura corporea
• blood_oxygen_saturation - Livelli di SpO2
• weight_&_body_mass - Misurazioni del peso corporeo
• body_mass_index - Valori di BMI calcolati
• height - Misurazioni dell'altezza
• dietary_water - Consumo di liquidi
• mindful_minutes - Tempo di meditazione o consapevolezza

Suggerimenti

• Raggruppamento Temporale: Usa le impostazioni di raggruppamento temporale nella tua configurazione di esportazione per controllare come i dati sono aggregati (per secondo, minuto, ora, giorno, ecc.)
• Aggregazione dei Dati: Abilita l'aggregazione dei dati per riepilogare il sonno e altre metriche per giorno per facilitare l'analisi
• Esportazione Selettiva: Puoi scegliere quali metriche di salute specifiche includere nella tua esportazione per ridurre la dimensione del file e il tempo di elaborazione

Documentazione Correlata

• Panoramica del Formato di Esportazione JSON
• Guida all'Esportazione Manuale
• Panoramica delle Automazioni