Μετρήσεις υγείας

Οι μετρήσεις υγείας αντιπροσωπεύουν τις διάφορες μετρήσεις και τα σημεία δεδομένων που συλλέγει η εφαρμογή Apple Health και οι συνδεδεμένες συσκευές σας. Σε εξαγωγές JSON, οι μετρήσεις υγείας αποθηκεύονται στον πίνακα metrics.

Μορφή ονόματος μετρικής

Όλα τα ονόματα μετρικών σε εξαγωγές JSON χρησιμοποιούν μορφή snake_case (πεζά με υπογράμμιση). Για παράδειγμα:

• το «Step Count» γίνεται "step_count"
• το «Blood Pressure» γίνεται "blood_pressure"
• το «Heart Rate» γίνεται "heart_rate"
• το «Walking + Running Distance» γίνεται "walking_running_distance"

Δομή

Ο πίνακας metrics περιέχει αντικείμενα, καθένα από τα οποία αντιπροσωπεύει έναν συγκεκριμένο τύπο μέτρησης υγείας. Οι περισσότερες μετρήσεις υγείας ακολουθούν κοινή δομή:

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

Κοινά πεδία

• name (Συμβολοσειρά): Το όνομα της μέτρησης υγείας σε μορφή snake_case (π.χ. "step_count", "heart_rate", "active_energy")
• units (Συμβολοσειρά): Η μονάδα μέτρησης (π.χ. "count", "bpm", "kcal")
• data (Πίνακας): Πίνακας σημείων δεδομένων, καθένα με:
  • qty (Αριθμός): Η τιμή ποσότητας
  • date (Ημερομηνία): Χρονική σήμανση σε μορφή yyyy-MM-dd HH:mm:ss Z

Ειδικές μορφές μετρικών

Ορισμένες μετρήσεις υγείας έχουν μοναδικές δομές που διαφέρουν από την κοινή μορφή:

Αρτηριακή πίεση

Οι μετρήσεις αρτηριακής πίεσης περιλαμβάνουν συστολική και διαστολική τιμή:

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

Πεδία:

• systolic (Αριθμός): Η συστολική (ανώτερη) μέτρηση αρτηριακής πίεσης
• diastolic (Αριθμός): Η διαστολική (κατώτερη) μέτρηση αρτηριακής πίεσης

Καρδιακός ρυθμός

Τα δεδομένα καρδιακού ρυθμού περιλαμβάνουν ελάχιστη, μέση και μέγιστη τιμή:

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

Πεδία:

• Min (Αριθμός): Ελάχιστος καρδιακός ρυθμός κατά την περίοδο μέτρησης
• Avg (Αριθμός): Μέσος καρδιακός ρυθμός κατά την περίοδο μέτρησης
• Max (Αριθμός): Μέγιστος καρδιακός ρυθμός κατά την περίοδο μέτρησης

Ανάλυση ύπνου

Η δομή δεδομένων ύπνου διαφέρει ανάλογα με το αν είναι ενεργοποιημένη η συσσώρευση δεδομένων στις ρυθμίσεις εξαγωγής σας.

Συσσωρευμένα δεδομένα ύπνου

Όταν η συσσώρευση είναι ενεργή, τα δεδομένα ύπνου συνοψίζονται ανά ημέρα:

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

Πεδία:

• totalSleep (Αριθμός): Συνολικός χρόνος ύπνου σε ώρες
• asleep (Αριθμός): Συνολικός χρόνος σε οποιαδήποτε κατάσταση ύπνου
• core (Αριθμός): Διάρκεια βασικού ύπνου σε ώρες
• deep (Αριθμός): Διάρκεια βαθύ ύπνου σε ώρες
• rem (Αριθμός): Διάρκεια ύπνου REM σε ώρες
• sleepStart (Ημερομηνία): Πότε ξεκίνησε πραγματικά ο ύπνος
• sleepEnd (Ημερομηνία): Πότε τελείωσε πραγματικά ο ύπνος
• inBed (Αριθμός): Συνολικός χρόνος στο κρεβάτι σε ώρες
• inBedStart (Ημερομηνία): Πότε μπήκατε στο κρεβάτι
• inBedEnd (Ημερομηνία): Πότε βγήκατε από το κρεβάτι

Μη συσσωρευμένα δεδομένα ύπνου

Όταν η συσσώρευση είναι απενεργοποιημένη, περιλαμβάνονται μεμονωμένα τμήματα ύπνου:

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

Πεδία:

• startDate (Ημερομηνία): Ώρα έναρξης του τμήματος ύπνου
• endDate (Ημερομηνία): Ώρα λήξης του τμήματος ύπνου
• qty (Αριθμός): Διάρκεια του τμήματος σε ώρες
• value (Συμβολοσειρά): Κατάσταση ύπνου — μία από τις:
  • "Awake"
  • "Asleep" (μη κατηγοριοποιημένη φάση ύπνου)
  • "In Bed"
  • "Core"
  • "REM"
  • "Deep"
  • "Unspecified"

Σημείωση: Το "Asleep" αναφέρεται σε μη κατηγοριοποιημένη φάση ύπνου (όχι στο συνολικό χρόνο ύπνου). Αυτό μπορεί να συμβαίνει αν η πηγή δεδομένων δεν υποστηρίζει παρακολούθηση φάσεων ύπνου.

Σάκχαρο αίματος

Οι μετρήσεις σακχάρου αίματος περιλαμβάνουν πληροφορίες χρονισμού γευμάτων:

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

Πεδία:

• qty (Αριθμός): Επίπεδο σακχάρου αίματος
• mealTime (Συμβολοσειρά): Μία από τις:
  • "Before Meal"
  • "After Meal"
  • "Unspecified"

Σεξουαλική δραστηριότητα

Οι εγγραφές σεξουαλικής δραστηριότητας καταγράφουν χρήση προφύλαξης:

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

Πεδία:

• Unspecified (Αριθμός): Πλήθος όταν η κατάσταση προφύλαξης είναι άγνωστη
• Protection Used (Αριθμός): Πλήθος όταν χρησιμοποιήθηκε προφύλαξη
• Protection Not Used (Αριθμός): Πλήθος όταν δεν χρησιμοποιήθηκε προφύλαξη

Πλύσιμο χεριών

Τα συμβάντα πλυσίματος χεριών καταγράφουν κατάσταση ολοκλήρωσης:

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

Πεδία:

• qty (Αριθμός): Αριθμός συμβάντων πλυσίματος χεριών
• value (Συμβολοσειρά): Μία από τις:
  • "Complete"
  • "Incomplete"

Βούρτσισμα δοντιών

Τα συμβάντα βουρτσίσματος δοντιών καταγράφουν κατάσταση ολοκλήρωσης:

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

Πεδία:

• qty (Αριθμός): Αριθμός συμβάντων βουρτσίσματος δοντιών
• value (Συμβολοσειρά): Μία από τις:
  • "Complete"
  • "Incomplete"

Χορήγηση ινσουλίνης

Οι εγγραφές χορήγησης ινσουλίνης περιλαμβάνουν τον λόγο χορήγησης:

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

Πεδία:

• qty (Αριθμός): Ποσότητα χορηγηθείσας ινσουλίνης
• reason (Συμβολοσειρά): Μία από τις:
  • "Bolus" (ινσουλίνη γεύματος)
  • "Basal" (βασική ινσουλίνη)

Συνήθεις μετρήσεις υγείας

Ορισμένες συχνά εξαγόμενες μετρήσεις υγείας περιλαμβάνουν (όλα τα ονόματα μετρικών είναι σε μορφή snake_case):

• step_count — Ημερήσια βήματα
• walking_running_distance — Καλυφθείσα απόσταση
• active_energy — Θερμίδες που καίγονται μέσω δραστηριότητας
• resting_heart_rate — Καρδιακός ρυθμός σε ηρεμία
• heart_rate — Μετρήσεις καρδιακού ρυθμού
• respiratory_rate — Συχνότητα αναπνοής
• body_temperature — Μετρήσεις θερμοκρασίας σώματος
• blood_oxygen_saturation — Επίπεδα SpO₂
• weight_&_body_mass — Μετρήσεις σωματικού βάρους
• body_mass_index — Υπολογισμένες τιμές ΔΜΣ
• height — Μετρήσεις ύψους
• dietary_water — Κατανάλωση υγρών
• mindful_minutes — Χρόνος διαλογισμού ή επίγνωσης

Συμβουλές

• Ομαδοποίηση χρόνου: Χρησιμοποιήστε τις ρυθμίσεις ομαδοποίησης χρόνου στη διαμόρφωση εξαγωγής για να ελέγχετε πώς συσσωρεύονται τα δεδομένα (ανά δευτερόλεπτο, λεπτό, ώρα, ημέρα κ.λπ.)
• Συσσώρευση δεδομένων: Ενεργοποιήστε τη συσσώρευση για να συνοψίζετε τον ύπνο και άλλες μετρήσεις ανά ημέρα για ευκολότερη ανάλυση
• Επιλεκτική εξαγωγή: Μπορείτε να επιλέξετε ποιες συγκεκριμένες μετρήσεις υγείας θα συμπεριληφθούν στην εξαγωγή, ώστε να μειώσετε το μέγεθος αρχείου και τον χρόνο επεξεργασίας

Σχετική τεκμηρίωση

• Επισκόπηση μορφής εξαγωγής JSON
• Οδηγός χειροκίνητης εξαγωγής
• Επισκόπηση αυτοματισμών